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

gcloud auth application-default login/google-cloud-sdk/lib/surface/metastore/operations/__init__.py

@@ -0,0 +1,27 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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.
+"""Command group for Dataproc Metastore operations."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class Operations(base.Group):
+  """Manage Dataproc Metastore operations."""

gcloud auth application-default login/google-cloud-sdk/lib/surface/metastore/operations/cancel.py

@@ -0,0 +1,73 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Command to cancel an operation."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from apitools.base.py import exceptions as apitools_exceptions
+from googlecloudsdk.api_lib.metastore import operations_util as operations_api_util
+from googlecloudsdk.api_lib.metastore import util as api_util
+from googlecloudsdk.api_lib.util import exceptions
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.metastore import resource_args
+from googlecloudsdk.core import log
+from googlecloudsdk.core.console import console_io
+
+
+DETAILED_HELP = {'EXAMPLES': """\
+          To cancel an active Dataproc Metastore operation with the name
+          `operation-1` in location `us-central1`, run:
+
+          $ {command} operation-1 --location=us-central1
+        """}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class Cancel(base.Command):
+  """Cancel a Dataproc Metastore operation."""
+
+  detailed_help = DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddOperationResourceArg(parser, 'cancel')
+
+  def Run(self, args):
+    operation_ref = args.CONCEPTS.operation.Parse()
+
+    console_io.PromptContinue(
+        message='Cancel the following operation: [%s] in [%s].\n'
+        % (operation_ref.operationsId, operation_ref.locationsId),
+        cancel_on_no=True,
+        cancel_string='Cancellation aborted by user.',
+        throw_if_unattended=True,
+    )
+
+    try:
+      operations_api_util.Cancel(
+          operation_ref.RelativeName(), release_track=self.ReleaseTrack()
+      )
+      log.status.Print('Cancelled operation [{0}].'.format(args.operation))
+    except apitools_exceptions.HttpError as e:
+      exc = exceptions.HttpException(e)
+      log.status.Print(
+          'ERROR: Failed to cancel operation [{0}]: {1}.'.format(
+              args.operation, exc.payload.status_message
+          )
+      )
+      raise api_util.Error('Cancellation did not succeed.')

gcloud auth application-default login/google-cloud-sdk/lib/surface/metastore/operations/delete.py

@@ -0,0 +1,89 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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.
+"""Command to delete an operation."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from apitools.base.py import exceptions as apitools_exceptions
+
+from googlecloudsdk.api_lib.metastore import operations_util as operations_api_util
+from googlecloudsdk.api_lib.metastore import util as api_util
+from googlecloudsdk.api_lib.util import exceptions
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.metastore import resource_args
+from googlecloudsdk.command_lib.metastore import util as command_util
+from googlecloudsdk.core import log
+from googlecloudsdk.core.console import console_io
+
+
+DETAILED_HELP = {
+    'EXAMPLES':
+        """\
+          To delete a Dataproc Metastore operation with the name
+          `operation-1` in location `us-central1`, run:
+
+          $ {command} operation-1 --location=us-central1
+
+          To delete multiple Dataproc Metastore services with the name
+          `operation-1` and `operation-2` in the same location
+          `us-central1`, run:
+
+          $ {command} operation-1 operation-2 --location=us-central1
+        """
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class Delete(base.DeleteCommand):
+  """Delete one or more completed Dataproc Metastore operations."""
+
+  detailed_help = DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddOperationResourceArg(parser, 'to delete', plural=True)
+
+  def Run(self, args):
+    op_refs = args.CONCEPTS.operations.Parse()
+
+    console_io.PromptContinue(
+        message=command_util.ConstructList(
+            'Deleting the following operations:', [
+                '[%s] in [%s]' % (op_ref.operationsId, op_ref.locationsId)
+                for op_ref in op_refs
+            ]),
+        cancel_on_no=True,
+        cancel_string='Deletion aborted by user.',
+        throw_if_unattended=True)
+
+    encountered_errors = False
+    for op_ref in op_refs:
+      try:
+        operations_api_util.Delete(
+            op_ref.RelativeName(), release_track=self.ReleaseTrack())
+        failed = None
+      except apitools_exceptions.HttpError as e:
+        exc = exceptions.HttpException(e)
+        failed = exc.payload.status_message
+        encountered_errors = True
+
+      log.DeletedResource(
+          op_ref.RelativeName(), kind='operation', failed=failed)
+
+    if encountered_errors:
+      raise api_util.Error('Some deletions did not succeed.')

gcloud auth application-default login/google-cloud-sdk/lib/surface/metastore/operations/describe.yaml

@@ -0,0 +1,28 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: |
+      Show metadata for a Dataproc Metastore operation.
+    description: |
+      Display all metadata associated with a Metastore operation given a valid
+      operation name.
+    examples: |
+      To display the metadata for an operation named `my-operation` in the default region,
+      run:
+
+        $ {command} my-operation
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.metastore.resources:operation
+      help_text: |
+        Arguments and flags that specify the Dataproc Metastore operation you
+        want to describe.
+
+  request:
+    ALPHA:
+      api_version: v1alpha
+    BETA:
+      api_version: v1beta
+    GA:
+      api_version: v1
+    collection: metastore.projects.locations.operations

gcloud auth application-default login/google-cloud-sdk/lib/surface/metastore/operations/list.yaml

@@ -0,0 +1,48 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: |
+      List Dataproc Metastore operations.
+    description: |
+      List all Metastore operations under the specified location.
+
+      To specify the maximum number of operations to list, use the --limit flag.
+    examples: |
+      To list up to five operations in location
+      `us-central1`, run:
+
+        $ {command} --location=us-central1 --limit=5
+
+      To list all operations in all locations,
+      run:
+
+        $ {command} --location=-
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.metastore.resources:location
+      help_text: |
+        The location of the operations to display.
+
+  request:
+    ALPHA:
+      api_version: v1alpha
+    BETA:
+      api_version: v1beta
+    GA:
+      api_version: v1
+    collection: metastore.projects.locations.operations
+
+  response:
+    id_field: name
+
+  output:
+    format: |
+     table(
+        name.basename():label=OPERATION_NAME,
+        name.segment(3):label=LOCATION,
+        metadata.verb:label=TYPE,
+        metadata.target.basename(),
+        done,
+        metadata.createTime.date():sort=1,
+        duration(start=metadata.createTime,end=metadata.endTime,precision=0,calendar=false).slice(2:).join("").yesno(no="<1S"):label=DURATION
+      )

gcloud auth application-default login/google-cloud-sdk/lib/surface/metastore/operations/wait.yaml

@@ -0,0 +1,29 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: Poll a long-running Dataproc Metastore operation until it completes.
+    description: |
+      Poll a long-running Dataproc Metastore operation until it completes. When
+      the operation is complete, this command will display the results of the
+      operation.
+    examples: |
+      To poll a long-running Dataproc Metastore operation named 'my-operation' until it completes, run the following:
+
+        $ {command} my-operation
+
+  request:
+    ALPHA:
+      api_version: v1alpha
+    BETA:
+      api_version: v1beta
+    GA:
+      api_version: v1
+    collection: metastore.projects.locations.operations
+
+  arguments:
+    resource:
+      help_text: ID for the operation to poll until complete.
+      spec: !REF googlecloudsdk.command_lib.metastore.resources:operation
+
+  async:
+    collection: metastore.projects.locations.operations
+    result_attribute: response