feat: Add new gcloud commands, API clients, and third-party libraries across various services.

gcloud auth application-default login/google-cloud-sdk/lib/surface/managed_kafka/clusters/__init__.py

@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Managed Service for Apache Kafka clusters operations."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+from googlecloudsdk.calliope import base
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(
+    base.ReleaseTrack.GA, base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA
+)
+class Clusters(base.Group):
+  """Administer Managed Service for Apache Kafka clusters."""
+  category = base.DATA_ANALYTICS_CATEGORY

gcloud auth application-default login/google-cloud-sdk/lib/surface/managed_kafka/clusters/create.yaml

@@ -0,0 +1,45 @@
+release_tracks: [GA, ALPHA, BETA]
+
+help_text:
+  brief: |
+    Create a Managed Service for Apache Kafka cluster.
+  description: |
+    Create a Managed Service for Apache Kafka cluster.
+
+  examples: |
+    To create a cluster, run the following:
+
+      $ {command} mycluster \
+          --location=us-central1 \
+          --cpu=3 \
+          --memory=3GiB
+          --subnets=projects/PROJECT_ID/regions/us-central1/subnetworks/default
+
+request:
+  collection: managedkafka.projects.locations.clusters
+  modify_request_hooks:
+  - googlecloudsdk.command_lib.managed_kafka.util:MapSubnetsToNetworkConfig
+  - googlecloudsdk.command_lib.managed_kafka.util:MapCaPoolsToCASConfig
+
+async:
+  collection: managedkafka.projects.locations.operations
+
+arguments:
+  resource:
+    help_text: Identifies the cluster for which the command runs.
+    spec: !REF googlecloudsdk.command_lib.managed_kafka.resources:cluster
+  params:
+  - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:cpu
+    required: true
+  - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:memory
+    required: true
+  - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:subnets
+    required: true
+  - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:labels
+  - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:encryption-key
+  - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:auto-rebalance
+    default: true
+  - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:mtls-ca-pools
+  - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:ssl-principal-mapping-rules
+  - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:broker-disk-size-gib
+    release_tracks: [ALPHA]

gcloud auth application-default login/google-cloud-sdk/lib/surface/managed_kafka/clusters/delete.yaml

@@ -0,0 +1,25 @@
+release_tracks: [GA, ALPHA, BETA]
+
+help_text:
+  brief: |
+    Delete a Managed Service for Apache Kafka cluster.
+  description: |
+    Delete a Managed Service for Apache Kafka cluster.
+
+  examples: |
+    To delete a cluster named mycluster located in us-central1,
+    run the following:
+
+      $ {command} mycluster \
+          --location=us-central1
+
+request:
+  collection: managedkafka.projects.locations.clusters
+
+arguments:
+  resource:
+    help_text: Identifies the cluster for deletion.
+    spec: !REF googlecloudsdk.command_lib.managed_kafka.resources:cluster
+
+async:
+  collection: managedkafka.projects.locations.operations

gcloud auth application-default login/google-cloud-sdk/lib/surface/managed_kafka/clusters/describe.yaml

@@ -0,0 +1,28 @@
+release_tracks: [GA, ALPHA, BETA]
+
+help_text:
+  brief: |
+    Describe a Managed Service for Apache Kafka cluster.
+  description: |
+    Describe a Managed Service for Apache Kafka cluster.
+
+  examples: |
+    To describe a cluster named mycluster located in us-central1,
+    run the following:
+
+      $ {command} mycluster \
+          --location=us-central1
+
+request:
+  collection: managedkafka.projects.locations.clusters
+
+arguments:
+  resource:
+    help_text: Identifies the cluster for details to be displayed.
+    spec: !REF googlecloudsdk.command_lib.managed_kafka.resources:cluster
+  params:
+  - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:full
+
+response:
+  modify_response_hooks:
+  - googlecloudsdk.command_lib.managed_kafka.util:DescribeWithBootstrapAddr

gcloud auth application-default login/google-cloud-sdk/lib/surface/managed_kafka/clusters/list.yaml

@@ -0,0 +1,38 @@
+release_tracks: [GA, ALPHA, BETA]
+
+help_text:
+  brief: |
+    List all Managed Service for Apache Kafka clusters in a given location.
+  description: |
+    List all Apache Kafka for BigQuery clusters in a given location.
+    To specify the maximum number of clusters to list, use the --limit flag.
+
+  examples: |
+    To list all clusters in a given location, such as us-central1, run the following:
+
+      $ {command} --location=us-central1
+
+request:
+  collection: managedkafka.projects.locations.clusters
+
+arguments:
+  resource:
+    help_text: |
+      Identifies the region which contains all the clusters to be listed.
+    spec: !REF googlecloudsdk.command_lib.managed_kafka.resources:location
+
+response:
+  modify_response_hooks:
+  - googlecloudsdk.command_lib.managed_kafka.util:ListWithBootstrapAddr
+
+output:
+  format: |
+    table[box](
+      name.segment(5):label=NAME,
+      bootstrapAddress:label=BOOTSTRAP,
+      capacityConfig.vcpuCount:label=VCPU,
+      capacityConfig.memoryBytes:label=MEMORY_BYTES,
+      state:label=STATE,
+      gcpConfig.accessConfig.networkConfigs.subnet.list(separator="
+    "):label=NETWORK
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/managed_kafka/clusters/update.yaml

@@ -0,0 +1,49 @@
+release_tracks: [GA, ALPHA, BETA]
+
+help_text:
+  brief: |
+    Update a Managed Service for Apache Kafka cluster.
+
+  description: |
+    Update a Managed Service for Apache Kafka cluster.
+
+  examples: |
+    To update an attribute in a cluster named mycluster located in us-central1,
+    such as the CPU, run the following:
+
+      $ {command} mycluster \
+          --location=us-central1 \
+          --cpu=3
+
+request:
+  collection: managedkafka.projects.locations.clusters
+  modify_request_hooks:
+  - googlecloudsdk.command_lib.managed_kafka.util:PrepareUpdateWithSubnets
+  - googlecloudsdk.command_lib.managed_kafka.util:PrepareUpdateWithCaPools
+
+arguments:
+  resource:
+    help_text: Identifies the cluster to be updated.
+    spec: !REF googlecloudsdk.command_lib.managed_kafka.resources:cluster
+  params:
+  - group:
+      required: true
+      params:
+      - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:cpu
+      - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:memory
+      - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:subnets
+      - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:labels
+      - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:auto-rebalance
+        default: null
+      - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:ssl-principal-mapping-rules
+      - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:broker-disk-size-gib
+        release_tracks: [ALPHA]
+      - group:
+          mutex: true
+          params:
+          - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:mtls-ca-pools
+          - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:clear-mtls-ca-pools
+  - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:allow-broker-downscale-on-cluster-upscale
+
+async:
+  collection: managedkafka.projects.locations.operations