Adds versions to timeseries schema

Cargo.toml

@@ -152,6 +152,7 @@ ciborium = "0.2.1"
 cfg-if = "1.0"
 chrono = { version = "0.4", features = [ "serde" ] }
 clap = { version = "4.4", features = ["derive"] }
+console = { version = "0.15.7", default-feautres = false }
 cookie = "0.16"
 criterion = { version = "0.5.1", features = [ "async_tokio" ] }
 crossbeam = "0.8"
@@ -305,6 +306,7 @@ sha3 = "0.10.8"
 shell-words = "1.1.0"
 signal-hook = "0.3"
 signal-hook-tokio = { version = "0.3", features = [ "futures-v0_3" ] }
+similar = "2.2.1"
 sled = "0.34"
 sled-agent-client = { path = "sled-agent-client" }
 sled-hardware = { path = "sled-hardware" }

openapi/nexus-internal.json

@@ -1563,6 +1563,12 @@
           },
           "name": {
             "type": "string"
+          },
+          "version": {
+            "default": 1,
+            "type": "integer",
+            "format": "uint8",
+            "minimum": 1
           }
         },
         "required": [
@@ -2223,6 +2229,21 @@
               "content",
               "type"
             ]
+          },
+          {
+            "description": "A timeseries name is not valid.",
+            "type": "object",
+            "properties": {
+              "type": {
+                "type": "string",
+                "enum": [
+                  "invalid_timeseries_name"
+                ]
+              }
+            },
+            "required": [
+              "type"
+            ]
           }
         ]
       },
@@ -2776,7 +2797,11 @@
           },
           "timeseries_name": {
             "description": "The name of the timeseries this sample belongs to",
-            "type": "string"
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/TimeseriesName"
+              }
+            ]
           }
         },
         "required": [
@@ -3242,6 +3267,12 @@
       "SwitchPutResponse": {
         "type": "object"
       },
+      "TimeseriesName": {
+        "title": "The name of a timeseries",
+        "description": "Names are constructed by concatenating the target and metric names with ':'. Target and metric names must be lowercase alphanumeric characters with '_' separating words. Each may be followed by an optional @ and non-zero version number.",
+        "type": "string",
+        "pattern": "(([a-z]+[a-z0-9]*)(_([a-z0-9]+))*(@(([1-9])|([1-9][0-9])|(1[0-9][0-9])|(2[0-1][0-9])|(22[0-4])))?):(([a-z]+[a-z0-9]*)(_([a-z0-9]+))*(@(([1-9])|([1-9][0-9])|(1[0-9][0-9])|(2[0-1][0-9])|(22[0-4])))?)"
+      },
       "UplinkConfig": {
         "type": "object",
         "properties": {