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/connectors/__init__.py

@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2025 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 connectors 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.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class Connectors(base.Group):
+  """Administer Managed Service for Apache Kafka connectors."""
+
+  category = base.DATA_ANALYTICS_CATEGORY

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

@@ -0,0 +1,53 @@
+release_tracks: [ALPHA, BETA, GA]
+
+help_text:
+  brief: |
+    Create a Managed Service for Apache Kafka connector.
+  description: |
+    Create a Managed Service for Apache Kafka connector.
+
+  examples: |
+    To create a connector, run the following:
+
+      $ {command} myconnector \
+          --location=us-central1 \
+          --connect-cluster=mycluster \
+          --configs=connector.class="com.google.pubsub.kafka.source.CloudPubSubSourceConnector",cps.subscription="my-subscription",... \
+          [--task-restart-min-backoff=60s] \
+          [--task-restart-max-backoff=30m] \
+          [--task-retry-disabled=true]
+      OR
+      $ {command} myconnector \
+          --location=us-central1 \
+          --connect-cluster=mycluster \
+          --config-file=my-config-file.yaml \
+          [--task-restart-min-backoff=60s] \
+          [--task-restart-max-backoff=30m] \
+          [--task-retry-disabled=true]
+
+request:
+  collection: managedkafka.projects.locations.connectClusters.connectors
+  modify_request_hooks:
+  - googlecloudsdk.command_lib.managed_kafka.util:ConnectorCreateReadConfigAndTaskRestartPolicy
+
+arguments:
+  resource:
+    help_text: Identifies the connector for which the command runs.
+    spec: !REF googlecloudsdk.command_lib.managed_kafka.resources:connector
+    is_positional: true
+  params:
+  - group:
+      required: true
+      mutex: true
+      params:
+      - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:connector-configs
+      - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:connector-config-file
+  - group:
+      required: false
+      params:
+      - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:task-restart-min-backoff
+        required: true
+      - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:task-restart-max-backoff
+        required: true
+  - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:task-retry-disabled
+    required: false

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

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

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

@@ -0,0 +1,24 @@
+release_tracks: [ALPHA, BETA, GA]
+
+help_text:
+  brief: |
+    Describe a Managed Service for Apache Kafka connector.
+  description: |
+    Describe a Managed Service for Apache Kafka connector.
+
+  examples: |
+    To describe a connector named myconnector located in us-central1,
+    run the following:
+
+      $ {command} myconnector \
+          --location=us-central1 \
+          --connect-cluster=mycluster
+
+request:
+  collection: managedkafka.projects.locations.connectClusters.connectors
+
+arguments:
+  resource:
+    help_text: Identifies the connector for details to be displayed.
+    spec: !REF googlecloudsdk.command_lib.managed_kafka.resources:connector
+    is_positional: true

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

@@ -0,0 +1,30 @@
+release_tracks: [ALPHA, BETA, GA]
+
+help_text:
+  brief: |
+    List all Managed Service for Apache Kafka connectors for a given connect cluster.
+  description: |
+    List all Managed Service for Apache Kafka connectors for a given connect cluster.
+    To specify the maximum number of connectors to list, use the --limit flag.
+
+  examples: |
+    To list all Managed Service for Apache Kafka connectors belonging to the "mycluster" connect cluster in us-central1, run the following:
+
+      $ {command} mycluster --location=us-central1
+
+request:
+  collection: managedkafka.projects.locations.connectClusters.connectors
+
+arguments:
+  resource:
+    help_text: Identifies the cluster which contains all the connectors to be listed.
+    spec: !REF googlecloudsdk.command_lib.managed_kafka.resources:connect_cluster
+    is_positional: true
+
+output:
+  format: |
+    table[box](
+      name.segment(7):label=NAME,
+      configs."connector.class":label=CLASS,
+      state:label=STATE
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/managed_kafka/connectors/pause.yaml

@@ -0,0 +1,25 @@
+release_tracks: [ALPHA, BETA, GA]
+
+help_text:
+  brief: |
+    Pauses operation of a Managed Service for Apache Kafka connector.
+  description: |
+    Pauses operation of a Managed Service for Apache Kafka connector.
+
+  examples: |
+    To pause a connector named myconnector located in us-central1,
+    run the following:
+
+      $ {command} myconnector \
+          --location=us-central1 \
+          --connect-cluster=mycluster
+
+request:
+  collection: managedkafka.projects.locations.connectClusters.connectors
+  method: pause
+
+arguments:
+  resource:
+    help_text: Identifies the connector to pause.
+    spec: !REF googlecloudsdk.command_lib.managed_kafka.resources:connector
+    is_positional: true

gcloud auth application-default login/google-cloud-sdk/lib/surface/managed_kafka/connectors/restart.yaml

@@ -0,0 +1,25 @@
+release_tracks: [ALPHA, BETA, GA]
+
+help_text:
+  brief: |
+    Restarts a Managed Service for Apache Kafka connector.
+  description: |
+    Restarts a Managed Service for Apache Kafka connector.
+
+  examples: |
+    To restart a connector named myconnector located in us-central1,
+    run the following:
+
+      $ {command} myconnector \
+          --location=us-central1 \
+          --connect-cluster=mycluster
+
+request:
+  collection: managedkafka.projects.locations.connectClusters.connectors
+  method: restart
+
+arguments:
+  resource:
+    help_text: Identifies the connector to restart.
+    spec: !REF googlecloudsdk.command_lib.managed_kafka.resources:connector
+    is_positional: true

gcloud auth application-default login/google-cloud-sdk/lib/surface/managed_kafka/connectors/resume.yaml

@@ -0,0 +1,25 @@
+release_tracks: [ALPHA, BETA, GA]
+
+help_text:
+  brief: |
+    Resumes operation of a stopped Managed Service for Apache Kafka connector.
+  description: |
+    Resumes operation of a stopped Managed Service for Apache Kafka connector.
+
+  examples: |
+    To resume a connector named myconnector located in us-central1,
+    run the following:
+
+      $ {command} myconnector \
+          --location=us-central1 \
+          --connect-cluster=mycluster
+
+request:
+  collection: managedkafka.projects.locations.connectClusters.connectors
+  method: resume
+
+arguments:
+  resource:
+    help_text: Identifies the connector to resume.
+    spec: !REF googlecloudsdk.command_lib.managed_kafka.resources:connector
+    is_positional: true

gcloud auth application-default login/google-cloud-sdk/lib/surface/managed_kafka/connectors/stop.yaml

@@ -0,0 +1,25 @@
+release_tracks: [ALPHA, BETA, GA]
+
+help_text:
+  brief: |
+    Stops operation of a Managed Service for Apache Kafka connector.
+  description: |
+    Stops operation of a Managed Service for Apache Kafka connector.
+
+  examples: |
+    To stop a connector named myconnector located in us-central1,
+    run the following:
+
+      $ {command} myconnector \
+          --location=us-central1 \
+          --connect-cluster=mycluster
+
+request:
+  collection: managedkafka.projects.locations.connectClusters.connectors
+  method: stop
+
+arguments:
+  resource:
+    help_text: Identifies the connector to resume.
+    spec: !REF googlecloudsdk.command_lib.managed_kafka.resources:connector
+    is_positional: true

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

@@ -0,0 +1,53 @@
+release_tracks: [ALPHA, BETA, GA]
+
+help_text:
+  brief: |
+    Update a Managed Service for Apache Kafka connector.
+  description: |
+    Update a Managed Service for Apache Kafka connector.
+
+  examples: |
+    To update a connector name myconnector, run the following:
+
+      $ {command} myconnector \
+          --location=us-central1 \
+          --configs=KEY1=VALUE1,KEY2=VALUE2... \
+          --connect-cluster=mycluster \
+          [--task-restart-min-backoff=60s] \
+          [--task-restart-max-backoff=30m] \
+          [--task-retry-disabled=true]
+      OR
+      $ {command} myconnector \
+          --location=us-central1 \
+          --config-file=my-config-file.yaml \
+          --connect-cluster=mycluster \
+          [--task-restart-min-backoff=60s] \
+          [--task-restart-max-backoff=30m] \
+          [--task-retry-disabled=true]
+
+request:
+  collection: managedkafka.projects.locations.connectClusters.connectors
+  modify_request_hooks:
+  - googlecloudsdk.command_lib.managed_kafka.util:ConnectorUpdateReadConfigAndTaskRestartPolicy
+
+arguments:
+  resource:
+    help_text: Identifies the connector for which the command runs.
+    spec: !REF googlecloudsdk.command_lib.managed_kafka.resources:connector
+    is_positional: true
+  params:
+  - group:
+      mutex: true
+      params:
+      - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:connector-configs
+      - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:connector-config-file
+  # If one of the task restart flags is provided, both must be provided.
+  - group:
+      required: false
+      params:
+      - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:task-restart-min-backoff
+        required: true
+      - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:task-restart-max-backoff
+        required: true
+  - _REF_: googlecloudsdk.command_lib.managed_kafka.flags:task-retry-disabled
+    required: false