sync protos

GitOrigin-RevId: d7a3b98142b926b02070eb6f2278fc4b4e76b959

Author: shikhar

s2/v1/openapi.json

@@ -238,7 +238,7 @@
           {
             "name": "start_after",
             "in": "query",
-            "description": "Only return basins names that lexicographically start after this name.\nThis can be the last basin name seen in a previous listing, to continue from there.\nIt must be greater than or equal to the prefix if specified.",
+            "description": "Only return basins names that lexicographically start after this name.\nThis can be the last basin name seen in a previous listing, to continue from there.\nIt must be greater than or equal to the `prefix` if that is specified.",
             "required": false,
             "schema": {
               "type": "string",
@@ -825,7 +825,7 @@
           {
             "name": "stream",
             "in": "path",
-            "description": "Stream name, which must be unique within the basin.\nIt can be an arbitrary string upto 512 characters.\nBackslash (`/`) is recommended as a delimiter for hierarchical naming.",
+            "description": "Stream name, which must be unique within the basin.\nIt can be an arbitrary string up to 512 characters.",
             "required": true,
             "schema": {
               "type": "string"
@@ -897,7 +897,7 @@
           {
             "name": "stream",
             "in": "path",
-            "description": "Stream name, which must be unique within the basin.\nIt can be an arbitrary string upto 512 characters.\nBackslash (`/`) is recommended as a delimiter for hierarchical naming.",
+            "description": "Stream name, which must be unique within the basin.\nIt can be an arbitrary string up to 512 characters.",
             "required": true,
             "schema": {
               "type": "string"
@@ -997,7 +997,7 @@
           {
             "name": "stream",
             "in": "path",
-            "description": "Stream name, which must be unique within the basin.\nIt can be an arbitrary string upto 512 characters.\nBackslash (`/`) is recommended as a delimiter for hierarchical naming.",
+            "description": "Stream name, which must be unique within the basin.\nIt can be an arbitrary string up to 512 characters.",
             "required": true,
             "schema": {
               "type": "string"
@@ -1062,7 +1062,7 @@
           {
             "name": "stream",
             "in": "path",
-            "description": "Stream name, which must be unique within the basin.\nIt can be an arbitrary string upto 512 characters.\nBackslash (`/`) is recommended as a delimiter for hierarchical naming.",
+            "description": "Stream name, which must be unique within the basin.\nIt can be an arbitrary string up to 512 characters.",
             "required": true,
             "schema": {
               "type": "string"
@@ -1147,7 +1147,7 @@
           {
             "name": "stream",
             "in": "path",
-            "description": "Stream name, which must be unique within the basin.\nIt can be an arbitrary string upto 512 characters.\nBackslash (`/`) is recommended as a delimiter for hierarchical naming.",
+            "description": "Stream name, which must be unique within the basin.\nIt can be an arbitrary string up to 512 characters.",
             "required": true,
             "schema": {
               "type": "string"
@@ -1316,10 +1316,6 @@
       },
       "BasinConfig": {
         "type": "object",
-        "required": [
-          "create_stream_on_append",
-          "create_stream_on_read"
-        ],
         "properties": {
           "create_stream_on_append": {
             "type": "boolean",
@@ -1470,7 +1466,7 @@
             "oneOf": [
               {
                 "$ref": "#/components/schemas/BasinScope",
-                "description": "Basin scope."
+                "description": "Basin scope.\nThis cannot be reconfigured."
               }
             ],
             "default": "aws:us-east-1"
@@ -1546,7 +1542,7 @@
           },
           "has_more": {
             "type": "boolean",
-            "description": "If set, indicates there are more results that can be listed with `start_after`."
+            "description": "Indicates that there are more results that can be listed with `start_after`."
           }
         }
       },
@@ -1567,7 +1563,7 @@
           },
           "has_more": {
             "type": "boolean",
-            "description": "If set, indicates there are more results that can be listed with `start_after`."
+            "description": "Indicates that there are more results that can be listed with `start_after`."
           }
         }
       },
@@ -1580,7 +1576,7 @@
         "properties": {
           "has_more": {
             "type": "boolean",
-            "description": "If set, indicates there are more results that can be listed with `start_after`."
+            "description": "Indicates that there are more results that can be listed with `start_after`."
           },
           "streams": {
             "type": "array",

s2/v1/s2.proto

@@ -93,9 +93,8 @@ message ReadBatch {
   // Records that are at or after the requested start position.
   repeated SequencedRecord records = 1;
   // Sequence number that will be assigned to the next record on the stream,
-  // with timestamp of the last record.
-  // This is returned only when consuming recent records,
-  // so its presence should not be relied on.
+  // and timestamp of the last record.
+  // This will only be present when consuming recent records.
   optional StreamPosition tail = 2;
 }
 
@@ -106,6 +105,6 @@ message ReadBatch {
 // or at the tail if a limit was specified.
 message TailPosition {
   // Sequence number that will be assigned to the next record on the stream,
-  // with timestamp of the last record.
+  // and timestamp of the last record.
   StreamPosition tail = 1;
 }