auto-docs: Update Cloud API spec

Author: vbotbuildovich

modules/ROOT/attachments/cloud-controlplane-api.yaml

@@ -10,15 +10,15 @@ components:
         - arn
       title: Role
       type: object
-    AWS.SecurityGroup:
-      description: Security Group identifies AWS security group.
+    AWSInstanceProfile:
+      description: AWS instance profile.
       properties:
         arn:
-          description: AWS security group ARN.
+          description: AWS instance profile ARN.
           type: string
       required:
         - arn
-      title: Security Group
+      title: Instance Profile
       type: object
     AWSPrivateLink:
       properties:
@@ -117,6 +117,16 @@ components:
         schema_registry_auth_mode:
           $ref: '#/components/schemas/PrivateLinkAuthMode'
       type: object
+    AWSSecurityGroup:
+      description: Security Group identifies AWS security group.
+      properties:
+        arn:
+          description: AWS security group ARN.
+          type: string
+      required:
+        - arn
+      title: Security Group
+      type: object
     Anytime:
       type: object
     AzurePrivateLink:
@@ -284,7 +294,7 @@ components:
           type: array
         allowed_subnet_ids:
           description: |-
-            A list of virtual network subnet IDs that are allowed to access the
+            A list of virtual network subnet ids that are allowed to access the
             storage account.
           items:
             type: string
@@ -868,10 +878,21 @@ components:
       type: object
     CustomerManagedResourcesUpdate:
       properties:
+        aws:
+          $ref: '#/components/schemas/CustomerManagedResourcesUpdate.AWS'
         gcp:
           $ref: '#/components/schemas/CustomerManagedResourcesUpdate.GCP'
       title: The cloud resources created by user that can be updated
       type: object
+    CustomerManagedResourcesUpdate.AWS:
+      description: AWS resources managed by user.
+      properties:
+        redpanda_connect_node_group_instance_profile:
+          $ref: '#/components/schemas/AWSInstanceProfile'
+        redpanda_connect_security_group:
+          $ref: '#/components/schemas/AWSSecurityGroup'
+      title: AWS Customer-Managed Resoures
+      type: object
     CustomerManagedResourcesUpdate.GCP:
       description: GCP resources managed by user.
       properties:
@@ -1317,16 +1338,6 @@ components:
           type: array
       title: Help
       type: object
-    InstanceProfile:
-      description: AWS instance profile.
-      properties:
-        arn:
-          description: AWS instance profile ARN.
-          type: string
-      required:
-        - arn
-      title: Instance Profile
-      type: object
     KafkaAPISpec:
       description: Cluster's Kafka API properties.
       properties:
@@ -2180,16 +2191,7 @@ components:
         name:
           type: string
       type: object
-    SecurityGroups:
-      description: Azure security groups for Redpanda Cluster. All security groups shall be in the network resource group.
-      properties:
-        redpanda_security_group:
-          $ref: '#/components/schemas/SecurityGroups.SecurityGroup'
-      required:
-        - redpanda_security_group
-      title: Azure Security Groups
-      type: object
-    SecurityGroups.SecurityGroup:
+    SecurityGroup:
       description: Azure security group.
       properties:
         name:
@@ -2200,6 +2202,15 @@ components:
       required:
         - name
       type: object
+    SecurityGroups:
+      description: Azure security groups for Redpanda Cluster. All security groups shall be in the network resource group.
+      properties:
+        redpanda_security_group:
+          $ref: '#/components/schemas/SecurityGroup'
+      required:
+        - redpanda_security_group
+      title: Azure Security Groups
+      type: object
     SeedBrokers:
       description: Seed brokers of a Redpanda API Endpoint.
       properties:
@@ -2760,31 +2771,35 @@ components:
       description: AWS resources created and managed by user, and required to deploy the Redpanda cluster.
       properties:
         agent_instance_profile:
-          $ref: '#/components/schemas/InstanceProfile'
+          $ref: '#/components/schemas/AWSInstanceProfile'
         cloud_storage_bucket:
           $ref: '#/components/schemas/CustomerManagedAWSCloudStorageBucket'
         cluster_security_group:
-          $ref: '#/components/schemas/AWS.SecurityGroup'
+          $ref: '#/components/schemas/AWSSecurityGroup'
         connectors_node_group_instance_profile:
-          $ref: '#/components/schemas/InstanceProfile'
+          $ref: '#/components/schemas/AWSInstanceProfile'
         connectors_security_group:
-          $ref: '#/components/schemas/AWS.SecurityGroup'
+          $ref: '#/components/schemas/AWSSecurityGroup'
         k8s_cluster_role:
           $ref: '#/components/schemas/AWS.Role'
         node_security_group:
-          $ref: '#/components/schemas/AWS.SecurityGroup'
+          $ref: '#/components/schemas/AWSSecurityGroup'
         permissions_boundary_policy:
           $ref: '#/components/schemas/Policy'
         redpanda_agent_security_group:
-          $ref: '#/components/schemas/AWS.SecurityGroup'
+          $ref: '#/components/schemas/AWSSecurityGroup'
+        redpanda_connect_node_group_instance_profile:
+          $ref: '#/components/schemas/AWSInstanceProfile'
+        redpanda_connect_security_group:
+          $ref: '#/components/schemas/AWSSecurityGroup'
         redpanda_node_group_instance_profile:
-          $ref: '#/components/schemas/InstanceProfile'
+          $ref: '#/components/schemas/AWSInstanceProfile'
         redpanda_node_group_security_group:
-          $ref: '#/components/schemas/AWS.SecurityGroup'
+          $ref: '#/components/schemas/AWSSecurityGroup'
         utility_node_group_instance_profile:
-          $ref: '#/components/schemas/InstanceProfile'
+          $ref: '#/components/schemas/AWSInstanceProfile'
         utility_security_group:
-          $ref: '#/components/schemas/AWS.SecurityGroup'
+          $ref: '#/components/schemas/AWSSecurityGroup'
       required:
         - agent_instance_profile
         - connectors_node_group_instance_profile
@@ -3182,7 +3197,7 @@ paths:
                     For example, if the name of a tag is "gcp.network-tag.network-tag-foo", the network tag named
                     "network-tag-foo" will be added to the Redpanda cluster GKE nodes.
                     Note: The value of a network tag will be ignored.
-                    See the official [GCP VPC](https://cloud.google.com/vpc/docs/add-remove-network-tags) for more details on network tags.
+                    See the details on network tags at https://cloud.google.com/vpc/docs/add-remove-network-tags.
                   type: object
                 cluster_configuration:
                   $ref: '#/components/schemas/ClusterUpdate.ClusterConfiguration'

modules/ROOT/attachments/cloud-dataplane-api.yaml

@@ -1178,7 +1178,7 @@ components:
           type: object
         url:
           description: |-
-            URL to connect to the pipeline, for example, using http_server.
+            URL to connect to the pipeline, e.g. via http_server.
             May be empty if no http_server is used.
           type: string
       required:
@@ -1227,7 +1227,7 @@ components:
         tags:
           additionalProperties:
             type: string
-          description: Optional list of tags to attach to a pipeline.
+          description: Optional lList of tags to attach to a pipeline.
           type: object
       required:
         - display_name