auto-docs: Update Cloud API spec

Author: vbotbuildovich

cloud-controlplane/cloud-controlplane.yaml

@@ -100,20 +100,6 @@ components:
           $ref: '#/components/schemas/ACLResource'
       title: A filter to match ACLs for resources
       type: object
-    AIGateway:
-      description: Cluster's AI Gateway properties.
-      properties:
-        url:
-          description: AI Gateway URL.
-          example: https://ai-gateway.cjb69h1c4vs42pca89s0.clusters.rdpa.co
-          readOnly: true
-          type: string
-        v2_url:
-          description: AI Gateway v2 URL.
-          example: https://aigw.cjb69h1c4vs42pca89s0.clusters.rdpa.co
-          readOnly: true
-          type: string
-      type: object
     AWS.Role:
       description: Role identifies AWS role.
       properties:
@@ -268,6 +254,15 @@ components:
         - arn
       title: Security Group
       type: object
+    AdpApi:
+      description: Cluster's ADP API properties.
+      properties:
+        url:
+          description: ADP API URL.
+          example: https://adp-api.cjb69h1c4vs42pca89s0.clusters.rdpa.co
+          readOnly: true
+          type: string
+      type: object
     Anytime:
       type: object
     AuthenticationConfiguration:
@@ -465,8 +460,10 @@ components:
     Cluster:
       description: Resource describing a Cluster.
       properties:
+        adp_api:
+          $ref: '#/components/schemas/AdpApi'
         ai_gateway:
-          $ref: '#/components/schemas/AIGateway'
+          $ref: '#/components/schemas/Cluster.AIGateway'
         api_gateway_access:
           $ref: '#/components/schemas/NetworkAccessMode'
         aws_private_link:
@@ -587,6 +584,20 @@ components:
           type: array
       title: Cluster
       type: object
+    Cluster.AIGateway:
+      description: Cluster's AI Gateway properties.
+      properties:
+        url:
+          description: AI Gateway URL.
+          example: https://ai-gateway.cjb69h1c4vs42pca89s0.clusters.rdpa.co
+          readOnly: true
+          type: string
+        v2_url:
+          description: AI Gateway v2 URL.
+          example: https://aigw.cjb69h1c4vs42pca89s0.clusters.rdpa.co
+          readOnly: true
+          type: string
+      type: object
     Cluster.CloudStorage:
       properties:
         aws:
@@ -3457,6 +3468,8 @@ components:
     ServerlessCluster:
       description: Resource describing a ServerlessCluster.
       properties:
+        ai_gateway:
+          $ref: '#/components/schemas/ServerlessCluster.AIGateway'
         console_private_url:
           readOnly: true
           type: string
@@ -3511,6 +3524,16 @@ components:
           type: string
       title: ServerlessCluster
       type: object
+    ServerlessCluster.AIGateway:
+      description: Cluster's AI Gateway properties.
+      properties:
+        v2_url:
+          description: AI Gateway v2 URL.
+          example: https://d1d9risv0c3i7qbbeoc0.aigw.adp.us-east-1.mpx.prd.cloud.redpanda.com
+          readOnly: true
+          type: string
+      readOnly: true
+      type: object
     ServerlessCluster.DataplaneAPI:
       description: Cluster's Data Plane API properties.
       properties:
@@ -5243,7 +5266,8 @@ paths:
             application/json:
               example:
                 clusters:
-                  - ai_gateway: null
+                  - adp_api: null
+                    ai_gateway: null
                     api_gateway_access: NETWORK_ACCESS_MODE_UNSPECIFIED
                     cloud_provider: CLOUD_PROVIDER_GCP
                     cloud_provider_tags: {}
@@ -5585,6 +5609,7 @@ paths:
             application/json:
               example:
                 cluster:
+                  adp_api: null
                   ai_gateway: null
                   api_gateway_access: NETWORK_ACCESS_MODE_UNSPECIFIED
                   cloud_provider: CLOUD_PROVIDER_GCP
@@ -6114,6 +6139,7 @@ paths:
                     cluster_type: TYPE_DEDICATED
                     created_at: "2023-01-01T00:00:00Z"
                     customer_managed_resources: null
+                    egress_spec: null
                     id: cjd533pc4vs8pjdkrrv0
                     name: my-network
                     region: us-west1
@@ -6257,6 +6283,7 @@ paths:
                   cluster_type: TYPE_DEDICATED
                   created_at: "2023-01-01T00:00:00Z"
                   customer_managed_resources: null
+                  egress_spec: null
                   id: cjd533pc4vs8pjdkrrv0
                   name: my-network
                   region: us-west1
@@ -6391,6 +6418,7 @@ paths:
                       response:
                         '@type': type.googleapis.com/redpanda.api.controlplane.v1.CreateClusterResponse
                         cluster:
+                          adp_api: null
                           ai_gateway: null
                           api_gateway_access: NETWORK_ACCESS_MODE_UNSPECIFIED
                           cloud_provider: CLOUD_PROVIDER_GCP
@@ -6469,6 +6497,7 @@ paths:
                           cluster_type: TYPE_DEDICATED
                           created_at: "2023-01-01T00:00:00Z"
                           customer_managed_resources: null
+                          egress_spec: null
                           id: cjb6capc4vs0m91gh3kg
                           name: my-new-cluster
                           region: us-central1
@@ -6520,6 +6549,7 @@ paths:
                       response:
                         '@type': type.googleapis.com/redpanda.api.controlplane.v1.CreateClusterResponse
                         cluster:
+                          adp_api: null
                           ai_gateway: null
                           api_gateway_access: NETWORK_ACCESS_MODE_UNSPECIFIED
                           cloud_provider: CLOUD_PROVIDER_GCP
@@ -7468,7 +7498,8 @@ paths:
               example:
                 next_page_token: some-opaque-string
                 serverless_clusters:
-                  - console_private_url: ""
+                  - ai_gateway: null
+                    console_private_url: ""
                     console_url: https://console-d1d9risv0c3i7qbbeoc0.any.us-east-1.mpx.prd.cloud.redpanda.com
                     created_at: "2023-01-01T00:00:00Z"
                     dataplane_api:
@@ -7623,6 +7654,7 @@ paths:
             application/json:
               example:
                 serverless_cluster:
+                  ai_gateway: null
                   console_private_url: ""
                   console_url: https://console-d1d9risv0c3i7qbbeoc0.any.us-east-1.mpx.prd.cloud.redpanda.com
                   created_at: "2023-01-01T00:00:00Z"

cloud-dataplane/cloud-dataplane.yaml

@@ -65,12 +65,14 @@ components:
         - ACL_PATTERN_ANY: Wildcard to match any pattern
          - ACL_PATTERN_LITERAL: Match a literal string
          - ACL_PATTERN_PREFIXED: Match a prefix
+         - ACL_PATTERN_PREFIX: Match a prefix
          - ACL_PATTERN_MATCH: Match serves as a catch-all for all the names of a topic
         the principal is authorized to access
       enum:
         - ACL_PATTERN_ANY
         - ACL_PATTERN_LITERAL
         - ACL_PATTERN_PREFIXED
+        - ACL_PATTERN_PREFIX
         - ACL_PATTERN_MATCH
       title: The ACL pattern type
       type: string
@@ -1153,17 +1155,17 @@ components:
             In this example, in proto `field` could take one of the following values:
 
             * `full_name` for a violation in the `full_name` value
-            * `email_addresses[1].email` for a violation in the `email` field of the
+            * `email_addresses[0].email` for a violation in the `email` field of the
               first `email_addresses` message
-            * `email_addresses[3].type[2]` for a violation in the second `type`
+            * `email_addresses[2].type[1]` for a violation in the second `type`
               value in the third `email_addresses` message.
 
             In JSON, the same values are represented as:
 
             * `fullName` for a violation in the `fullName` value
-            * `emailAddresses[1].email` for a violation in the `email` field of the
+            * `emailAddresses[0].email` for a violation in the `email` field of the
               first `emailAddresses` message
-            * `emailAddresses[3].type[2]` for a violation in the second `type`
+            * `emailAddresses[2].type[1]` for a violation in the second `type`
               value in the third `emailAddresses` message.
           type: string
         localized_message:
@@ -2224,9 +2226,11 @@ components:
       description: |-
         - PATTERN_TYPE_LITERAL: Must match the filter exactly
          - PATTERN_TYPE_PREFIX: Will match anything that starts with filter
+         - PATTERN_TYPE_PREFIXED: Will match anything that starts with filter
       enum:
         - PATTERN_TYPE_LITERAL
         - PATTERN_TYPE_PREFIX
+        - PATTERN_TYPE_PREFIXED
       title: The matching pattern type
       type: string
     PermissionType:
@@ -3254,7 +3258,7 @@ components:
             - `redpanda.remote.allowgaps`
             - `redpanda.virtual.cluster.id`
             - `redpanda.leaders.preference`
-            - `redpanda.cloud_topic.enabled`
+            - `redpanda.storage.mode`
 
             This list is a list of properties in addition to the default properties
             that will be synced.  See `exclude_default`.
@@ -7852,7 +7856,7 @@ paths:
               schema:
                 $ref: '#/components/schemas/TransformMetadata'
           description: Created
-      summary: Deploy transform
+      summary: Deploy Transform
       tags:
         - Wasm Transforms
   /v1/transforms/{name}: