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/topics/__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 topics 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 Topics(base.Group):
+  """Administer Managed Service for Apache Kafka topics."""
+  category = base.DATA_ANALYTICS_CATEGORY

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

@@ -0,0 +1,32 @@
+release_tracks: [GA, ALPHA, BETA]
+
+help_text:
+  brief: |
+    Create a Managed Service for Apache Kafka topic.
+  description: |
+    Create a Managed Service for Apache Kafka topic.
+
+  examples: |
+    To create a topic in a cluster named mycluster located in us-central1,
+    run the following:
+
+      $ {command} mytopic \
+          --cluster=mycluster
+          --location=us-central1 \
+          --partitions=1 \
+          --replication-factor=3
+
+request:
+  collection: managedkafka.projects.locations.clusters.topics
+
+arguments:
+  resource:
+    help_text: Identifies the name of the topic that this command creates.
+    spec: !REF googlecloudsdk.command_lib.managed_kafka.resources:topic
+
+  params:
+  - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:partitions
+    required: true
+  - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:replication-factor
+    required: true
+  - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:configs

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

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

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

@@ -0,0 +1,23 @@
+release_tracks: [GA, ALPHA, BETA]
+
+help_text:
+  brief: |
+    Describe a Managed Service for Apache Kafka topic.
+  description: |
+    Describe a Managed Service for Apache Kafka topic.
+
+  examples: |
+    To describe a topic in a cluster named mycluster located in us-central1,
+    run the following:
+
+      $ {command} mytopic \
+          --cluster=mycluster \
+          --location=us-central1
+
+request:
+  collection: managedkafka.projects.locations.clusters.topics
+
+arguments:
+  resource:
+    help_text: The describe command displays properties of the topic specified by this parameter.
+    spec: !REF googlecloudsdk.command_lib.managed_kafka.resources:topic

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

@@ -0,0 +1,24 @@
+release_tracks: [GA, ALPHA, BETA]
+
+help_text:
+  brief: |
+    List all Managed Service for Apache Kafka topics in a given cluster.
+  description: |
+    List all Managed Service for Apache Kafka topics in a given cluster.
+    To specify the maximum number of topics to list, use the --limit flag.
+
+  examples: |
+    To list all topics in a cluster named mycluster located in us-central1,
+    run the following:
+
+      $ {command} mycluster
+          --location=us-central1
+
+request:
+  collection: managedkafka.projects.locations.clusters.topics
+
+arguments:
+  resource:
+    is_positional: true
+    help_text: Identifies the cluster which contains all the topics to be listed.
+    spec: !REF googlecloudsdk.command_lib.managed_kafka.resources:cluster

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

@@ -0,0 +1,36 @@
+release_tracks: [GA, ALPHA, BETA]
+
+help_text:
+  brief: |
+    Update a Managed Service for Apache Kafka topic.
+  description: |
+    Update a Managed Service for Apache Kafka topic.
+
+  examples: |
+    To update an attribute in a topic, such as the partitions, for a cluster named mycluster
+    located in us-central1, run the following:
+
+      $ {command} mytopic \
+          --cluster=mycluster \
+          --location=us-central1 \
+          --partitions=3
+
+request:
+  collection: managedkafka.projects.locations.clusters.topics
+  modify_request_hooks:
+  - googlecloudsdk.command_lib.managed_kafka.util:PatchConfigs
+
+arguments:
+  resource:
+    help_text: Identifies the topic to be updated.
+    spec: !REF googlecloudsdk.command_lib.managed_kafka.resources:topic
+  params:
+  - group:
+      required: true
+      params:
+      - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:partitions
+      - group:
+          mutex: true
+          params:
+          - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:configs
+          - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:clear-configs