auto-docs: Update Cloud API spec

Author: vbotbuildovich

cloud-controlplane/cloud-controlplane.yaml

@@ -2520,8 +2520,9 @@ components:
     ServerlessCluster:
       description: Resource describing a ServerlessCluster.
       properties:
-        console:
-          $ref: '#/components/schemas/ServerlessCluster.Console'
+        console_private_url:
+          readOnly: true
+          type: string
         console_url:
           readOnly: true
           type: string
@@ -2540,6 +2541,8 @@ components:
           description: Unique name of the Serverless cluster.
           example: development-ServerlessCluster
           type: string
+        network:
+          $ref: '#/components/schemas/ServerlessCluster.NetworkingConfig'
         planned_deletion:
           $ref: '#/components/schemas/PlannedDeletion'
         private_link:
@@ -2562,25 +2565,47 @@ components:
           type: string
       title: ServerlessCluster
       type: object
-    ServerlessCluster.Console:
-      type: object
     ServerlessCluster.DataplaneAPI:
       description: Cluster's Data Plane API properties.
       properties:
+        private_url:
+          description: |-
+            private_url is the private url of the dataplane api if private networking
+            is enabled for this cluster.
+          readOnly: true
+          type: string
         url:
           readOnly: true
           type: string
       type: object
     ServerlessCluster.KafkaAPI:
       description: Cluster's Kafka API properties.
       properties:
+        private_seed_brokers:
+          items:
+            type: string
+          readOnly: true
+          title: Kafka API seed brokers (also known as bootstrap servers). Private addresses
+          type: array
         seed_brokers:
-          description: Kafka API seed brokers (also known as bootstrap servers).
           items:
             type: string
           readOnly: true
+          title: Kafka API seed brokers (also known as bootstrap servers). Implicitly public
           type: array
       type: object
+    ServerlessCluster.NetworkingConfig:
+      properties:
+        private:
+          $ref: '#/components/schemas/ServerlessCluster.NetworkingConfig.State'
+        public:
+          $ref: '#/components/schemas/ServerlessCluster.NetworkingConfig.State'
+      type: object
+    ServerlessCluster.NetworkingConfig.State:
+      enum:
+        - STATE_DISABLED
+        - STATE_ENABLED
+      type: string
     ServerlessCluster.PrivateLink:
       properties:
         id:
@@ -2591,6 +2616,10 @@ components:
     ServerlessCluster.SchemaRegistryStatus:
       description: Cluster's Schema Registry properties.
       properties:
+        private_url:
+          readOnly: true
+          title: Private url for the schema registry
+          type: string
         url:
           readOnly: true
           type: string

cloud-dataplane/cloud-dataplane.yaml

@@ -212,7 +212,7 @@ components:
         info:
           $ref: '#/components/schemas/ConnectCluster.Info'
         name:
-          description: Unique name of Connect cluster. For Redpanda Cloud, the value is `redpanda`.
+          description: Unique name of connect cluster. For Redpanda Cloud, the value is `redpanda`.
           type: string
         plugins:
           items:
@@ -683,7 +683,7 @@ components:
             { "reason": "API_DISABLED"
               "domain": "googleapis.com"
               "metadata": {
-                "resource": "projects/1234",
+                "resource": "projects/123",
                 "service": "pubsub.googleapis.com"
               }
             }
@@ -2081,8 +2081,6 @@ components:
           description: The secret data. Must be Base64-encoded.
           format: byte
           type: string
-      required:
-        - secret_data
       type: object
     UpdateSecretResponse:
       description: UpdateSecretResponse is the response of UpdateSecret.
@@ -3493,7 +3491,7 @@ paths:
       description: 'List Kafka Connect cluster secrets. Optional: filter based on secret name and labels.'
       operationId: SecretService_ListKafkaConnectSecrets
       parameters:
-        - description: Unique name of target Connect cluster. For Redpanda Cloud, use `redpanda`.
+        - description: Unique name of target connect cluster. For Redpanda Cloud, use `redpanda`.
           in: path
           name: cluster_name
           required: true
@@ -3612,7 +3610,7 @@ paths:
       description: Delete a Kafka Connect cluster secret.
       operationId: SecretService_DeleteKafkaConnectSecret
       parameters:
-        - description: Unique name of target Connect cluster. For Redpanda Cloud, use `redpanda`.
+        - description: Unique name of target connect cluster. For Redpanda Cloud, use `redpanda`.
           in: path
           name: cluster_name
           required: true
@@ -5616,7 +5614,7 @@ paths:
               schema:
                 $ref: '#/components/schemas/TransformMetadata'
           description: Created
-      summary: Deploy transform
+      summary: Deploy Transform
       tags:
         - Wasm Transforms
   /v1/transforms/{name}: