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

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

@@ -0,0 +1,27 @@
+# -*- 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.
+"""Storage Insights operations commands."""
+
+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)
+class Operations(base.Group):
+  """Manage insights operations."""

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

@@ -0,0 +1,57 @@
+# -*- 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 insights operation."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.storage import insights_api
+from googlecloudsdk.calliope import base
+from googlecloudsdk.core import log
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+@base.DefaultUniverseOnly
+class Cancel(base.Command):
+  """Cancel an insights operation."""
+
+  detailed_help = {
+      'DESCRIPTION': """\
+      Cancel an insights operation. Since operations are asynchronous, this
+      request is best effort and may fail in cases such as when the operation
+      is already complete.
+      """,
+      'EXAMPLES': """\
+      To cancel the operation "12345" in "us-central1" for the project
+      "my-project", run:
+
+        $ {command} projects/my-project/locations/us-central1/operations/12345
+      """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    parser.add_argument(
+        'operation_name',
+        help=(
+            'The operation name in the format'
+            ' "projects/PROJECT/locations/LOCATION/operations/OPERATION_ID".'
+        ),
+    )
+
+  def Run(self, args):
+    insights_api.InsightsApi().cancel_operation(args.operation_name)
+    log.status.Print('Sent cancel request for {}'.format(args.operation_name))

gcloud auth application-default login/google-cloud-sdk/lib/surface/storage/insights/operations/describe.py

@@ -0,0 +1,53 @@
+# -*- 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 describe an insights operation."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.storage import insights_api
+from googlecloudsdk.calliope import base
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Describe(base.Command):
+  """Describe an insights operation."""
+
+  detailed_help = {
+      'DESCRIPTION': """\
+      Get details about an insights operation.
+      """,
+      'EXAMPLES': """\
+      To describe the operation "12345" in "us-central1" for the project
+      "my-project", run:
+
+        $ {command} projects/my-project/locations/us-central1/operations/12345
+      """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    parser.add_argument(
+        'operation_name',
+        help=(
+            'The operation name in the format'
+            ' "projects/PROJECT/locations/LOCATION/operations/OPERATION_ID".'
+        ),
+    )
+
+  def Run(self, args):
+    return insights_api.InsightsApi().get_operation(args.operation_name)

gcloud auth application-default login/google-cloud-sdk/lib/surface/storage/insights/operations/list.py

@@ -0,0 +1,56 @@
+# -*- 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 list Storage Insights operations."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.storage import insights_api
+from googlecloudsdk.calliope import base
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class List(base.ListCommand):
+  """List insights operations."""
+
+  detailed_help = {
+      'DESCRIPTION': """\
+      List storage operations.
+      """,
+      'EXAMPLES': """\
+      To list all operations in "us-central1" for the project "my-project", run:
+
+        $ {command} projects/my-project/locations/us-central1
+
+      To list operations in JSON format, run:
+
+        $ {command} projects/my-project/locations/us-central1 --format=json
+      """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    parser.add_argument(
+        'parent_resource_name',
+        help=(
+            'The operation parent resource in the format'
+            ' ""projects/PROJECT/locations/LOCATION".'
+        ),
+    )
+
+  def Run(self, args):
+    return insights_api.InsightsApi().list_operations(args.parent_resource_name)