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

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/recoverable_snapshots/__init__.py

@@ -0,0 +1,40 @@
+# -*- 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.
+"""Commands for reading and manipulating recoverable snapshots."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+DETAILED_HELP = {  # Dict[str, str]
+    'brief': (
+        'Recover, list, describe and delete Compute Engine recoverable'
+        ' snapshots.'
+    ),
+}
+
+
+@base.Hidden
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class RecoverableSnapshots(base.Group):
+  """Recover, list, describe and delete Compute Engine recoverable snapshots."""
+
+
+RecoverableSnapshots.category = base.INSTANCES_CATEGORY
+
+RecoverableSnapshots.detailed_help = DETAILED_HELP

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/recoverable_snapshots/delete.py

@@ -0,0 +1,89 @@
+# -*- 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.
+"""Command for deleting recoverable snapshots."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.compute import base_classes
+from googlecloudsdk.api_lib.compute import utils
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.compute import flags as compute_flags
+from googlecloudsdk.command_lib.compute import scope as compute_scope
+from googlecloudsdk.command_lib.compute.recoverable_snapshots import flags
+
+DELETE = 'Delete'
+DETAILED_HELP = {
+    'EXAMPLES':
+        """\
+        To delete Compute Engine recoverable snapshots with the names 'recoverable-snapshot-1'
+        and 'recoverable-snapshot-2', run:
+          $ {command} recoverable-snapshot-1 recoverable-snapshot-2
+        To list all recoverable snapshots that were created before a specific date, use
+        the --filter flag with the `{parent_command} list` command.
+          $ {parent_command} list --filter="creationTimestamp<'2017-01-01'"
+        For more information on how to use --filter with the list command,
+        run $ gcloud topic filters.
+        """,
+}
+
+
+def _AlphaArgs(parser):
+  """A helper function to build args for Alpha API version."""
+  Delete.RecoverableSnapshotArg = flags.MakeRecoverableSnapshotArg(
+      plural=True
+  )
+  Delete.RecoverableSnapshotArg.AddArgument(parser, operation_type='delete')
+
+
+@base.Hidden
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+@base.DefaultUniverseOnly
+class Delete(base.DeleteCommand):
+  """Delete Compute Engine recoverable snapshots.
+
+  *{command}* deletes one or more Compute Engine recoverable snapshots.
+  """
+  detailed_help = DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    _AlphaArgs(parser)
+
+  def Run(self, args):
+    return self._Run(args)
+
+  def _Run(self, args):
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    client = holder.client
+    recoverable_snapshot_refs = Delete.RecoverableSnapshotArg.ResolveAsResource(
+        args,
+        holder.resources,
+        scope_lister=compute_flags.GetDefaultScopeLister(client),
+        default_scope=compute_scope.ScopeEnum.GLOBAL,
+    )
+    utils.PromptForDeletion(recoverable_snapshot_refs)
+    requests = []
+    for recoverable_snapshot_ref in recoverable_snapshot_refs:
+      requests.append((
+          client.apitools_client.recoverableSnapshots,
+          DELETE,
+          client.messages.ComputeRecoverableSnapshotsDeleteRequest(
+              project=recoverable_snapshot_ref.project,
+              recoverableSnapshot=recoverable_snapshot_ref.recoverableSnapshot,
+          ),
+      ))
+    return client.MakeRequests(requests)

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/recoverable_snapshots/describe.py

@@ -0,0 +1,79 @@
+# -*- 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.
+"""Command for describing recoverable snapshots."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.compute import base_classes
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.compute import flags as compute_flags
+from googlecloudsdk.command_lib.compute import scope as compute_scope
+from googlecloudsdk.command_lib.compute.recoverable_snapshots import flags
+
+
+def _AlphaArgs(parser):
+  Describe.RecoverableSnapshotArg = (
+      flags.MakeRecoverableSnapshotArg()
+  )
+  Describe.RecoverableSnapshotArg.AddArgument(parser, operation_type='describe')
+
+
+@base.Hidden
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+@base.DefaultUniverseOnly
+class Describe(base.DescribeCommand):
+  """Describe a Compute Engine recoverable snapshot."""
+
+  @staticmethod
+  def Args(parser):
+    _AlphaArgs(parser)
+
+  def Run(self, args):
+    return self._Run(args)
+
+  def _Run(self, args):
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    client = holder.client
+    messages = client.messages
+
+    recoverable_snapshot_ref = (
+        Describe.RecoverableSnapshotArg.ResolveAsResource(
+            args,
+            holder.resources,
+            scope_lister=compute_flags.GetDefaultScopeLister(client),
+            default_scope=compute_scope.ScopeEnum.GLOBAL,
+        )
+    )
+
+    request = messages.ComputeRecoverableSnapshotsGetRequest(
+        **recoverable_snapshot_ref.AsDict()
+    )
+    return client.MakeRequests(
+        [(client.apitools_client.recoverableSnapshots, 'Get', request)]
+    )[0]
+
+
+Describe.detailed_help = {
+    'DESCRIPTION': """\
+        *{command}* displays all data associated with a Compute Engine
+        recoverable snapshot in the project.
+        """,
+    'EXAMPLES': """\
+        To describe a global recoverable snapshot, run:
+          $ {command} my-recoverable-snapshot
+        """,
+}

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/recoverable_snapshots/list.py

@@ -0,0 +1,62 @@
+# -*- 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.
+"""Command for listing recoverable snapshots."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.compute import base_classes
+from googlecloudsdk.api_lib.compute import lister
+from googlecloudsdk.calliope import base
+
+
+def _CommonArgs(parser):
+  """Set Args based on Release Track."""
+  parser.display_info.AddFormat("""\
+      table(
+        name,
+        status
+      )""")
+
+
+@base.Hidden
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+@base.DefaultUniverseOnly
+class List(base.ListCommand):
+  """List Compute Engine recoverable snapshots."""
+
+  @staticmethod
+  def Args(parser):
+    _CommonArgs(parser)
+
+  def Run(self, args):
+    return self._Run(args)
+
+  def _Run(self, args):
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    client = holder.client
+
+    request_data = lister.ParseNamesAndRegexpFlags(args, holder.resources)
+
+    list_implementation = lister.GlobalLister(
+        client, client.apitools_client.recoverableSnapshots
+    )
+
+    return lister.Invoke(request_data, list_implementation)
+
+
+List.detailed_help = base_classes.GetGlobalListerHelp('recoverable snapshots')
+

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/recoverable_snapshots/recover.py

@@ -0,0 +1,91 @@
+# -*- 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.
+"""Command for recovering recoverable snapshots."""
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.compute import base_classes
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.compute import flags as compute_flags
+from googlecloudsdk.command_lib.compute import scope as compute_scope
+from googlecloudsdk.command_lib.compute.recoverable_snapshots import flags as recoverable_snapshots_flags
+
+
+def _AlphaArgs(parser):
+  Recover.RecoverableSnapshotArg = (
+      recoverable_snapshots_flags.MakeRecoverableSnapshotArg(plural=False)
+  )
+  Recover.RecoverableSnapshotArg.AddArgument(parser, operation_type='recover')
+  parser.add_argument(
+      '--snapshot-name',
+      help=(
+          'Name of the snapshot after the recovery. If not provided, the '
+          'snapshot will be recovered with the original name.'
+      ),
+  )
+
+
+@base.Hidden
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+@base.DefaultUniverseOnly
+class Recover(base.Command):
+  """Recovers a Compute Engine recoverable snapshot."""
+
+  @staticmethod
+  def Args(parser):
+    _AlphaArgs(parser)
+
+  def Run(self, args):
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    client = holder.client
+    messages = client.messages
+
+    recoverable_snapshot_ref = (
+        Recover.RecoverableSnapshotArg.ResolveAsResource(
+            args,
+            holder.resources,
+            scope_lister=compute_flags.GetDefaultScopeLister(client),
+            default_scope=compute_scope.ScopeEnum.GLOBAL,
+        )
+    )
+
+    request = messages.ComputeRecoverableSnapshotsRecoverRequest(
+        project=recoverable_snapshot_ref.project,
+        recoverableSnapshot=recoverable_snapshot_ref.Name(),
+        snapshotName=args.snapshot_name,
+    )
+
+    return client.MakeRequests(
+        [(client.apitools_client.recoverableSnapshots, 'Recover', request)],
+        no_followup=True,
+    )[0]
+
+
+Recover.detailed_help = {
+    'DESCRIPTION': """\
+    Recovers the specified global recoverable snapshot.
+    If `--snapshot-name` is provided, the snapshot will be recovered with
+    that name. Otherwise, it will be recovered with the original name.
+    """,
+    'EXAMPLES': """\
+    To recover a recoverable snapshot named `recoverable-snapshot-1` with
+    the original name, run:
+      $ {command} recoverable-snapshot-1
+    To recover a recoverable snapshot named `recoverable-snapshot-1` with
+    a new name `new-snapshot-name`, run:
+      $ {command} recoverable-snapshot-1 --snapshot-name=new-snapshot-name
+    """,
+}