auto-docs: Update Cloud API spec (#27)

* auto-docs: Update Cloud API spec

* Apply suggestions from code review

---------

Co-authored-by: Kat Batuigas <[email protected]>

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: |-
+            The private URL of the data plane 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

@@ -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.