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

gcloud auth application-default login/google-cloud-sdk/lib/surface/netapp/backup_vaults/backups/__init__.py

@@ -0,0 +1,32 @@
+# -*- 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 group for Cloud NetApp Backups."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Backups(base.Group):
+  """Create and manage Cloud NetApp Backups."""
+
+
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class BackupsBeta(Backups):
+  """Create and manage Cloud NetApp Backups."""
+

gcloud auth application-default login/google-cloud-sdk/lib/surface/netapp/backup_vaults/backups/create.py

@@ -0,0 +1,80 @@
+# -*- 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.
+"""Create a Cloud NetApp Backup."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.netapp.backup_vaults.backups import client as backups_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.netapp.backup_vaults.backups import flags as backups_flags
+from googlecloudsdk.command_lib.util.args import labels_util
+
+from googlecloudsdk.core import log
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Create(base.CreateCommand):
+  """Create a Cloud NetApp Backup."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.GA
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Create a Cloud NetApp Backup.
+          """,
+      'EXAMPLES': """\
+          The following command creates a Backup named BACKUP attached to a Backup Vault named BACKUP_VAULT, and a source volume named SOURCE_VOL asynchronously using the specified arguments:
+
+              $ {command} BACKUP --location=LOCATION --async --backup-vault=BACKUP_VAULT --source-volume=SOURCE_VOL
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    backups_flags.AddBackupCreateArgs(parser)
+
+  def Run(self, args):
+    """Create a Cloud NetApp Backup in the current project."""
+    backup_ref = args.CONCEPTS.backup.Parse()
+    client = backups_client.BackupsClient(self._RELEASE_TRACK)
+    labels = labels_util.ParseCreateArgs(
+        args, client.messages.Backup.LabelsValue
+    )
+    backup = client.ParseBackup(
+        name=backup_ref.RelativeName(),
+        source_volume=args.source_volume,
+        source_snapshot=args.source_snapshot,
+        description=args.description,
+        labels=labels,
+    )
+    result = client.CreateBackup(backup_ref, args.async_, backup)
+    if args.async_:
+      command = 'gcloud {} netapp backup-vaults backups list'.format(
+          self.ReleaseTrack().prefix
+      )
+      log.status.Print(
+          'Check the status of the new backup by listing all backups:\n  $ {} '
+          .format(command)
+      )
+    return result
+
+
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class CreateBeta(Create):
+  """Create a Cloud NetApp Backup."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA

gcloud auth application-default login/google-cloud-sdk/lib/surface/netapp/backup_vaults/backups/delete.py

@@ -0,0 +1,91 @@
+# -*- 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.
+"""Delete a Cloud NetApp Backup."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.netapp.backup_vaults.backups import client as backups_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.netapp import flags
+from googlecloudsdk.command_lib.netapp.backup_vaults.backups import flags as backups_flags
+from googlecloudsdk.command_lib.util.concepts import concept_parsers
+
+from googlecloudsdk.core import log
+from googlecloudsdk.core.console import console_io
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Delete(base.DeleteCommand):
+  """Delete a Cloud NetApp Backup."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.GA
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Delete a Cloud NetApp Backup.
+          """,
+      'EXAMPLES': """\
+          The following command deletes a Backup named BACKUP inside a backup vault named BACKUP_VAULT using the required arguments:
+
+              $ {command} BACKUP --location=us-central1 --backup-vault=BACKUP_VAULT
+
+          To delete a Backup named BACKUP asynchronously, run the following command:
+
+              $ {command} BACKUP --location=us-central1 --backup-vault=BACKUP_VAULT --async
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    """Add args for deleting a Backup."""
+    concept_parsers.ConceptParser([
+        flags.GetBackupPresentationSpec('The Backup to delete.')
+    ]).AddToParser(parser)
+    backups_flags.AddBackupBackupVaultResourceArg(parser)
+    flags.AddResourceAsyncFlag(parser)
+
+  def Run(self, args):
+    """Delete a Cloud NetApp Backup in the current project."""
+    backup_ref = args.CONCEPTS.backup.Parse()
+
+    if not args.quiet:
+      delete_warning = (
+          'You are about to delete a Backup {}.\nAre you sure?'.format(
+              backup_ref.RelativeName()
+          )
+      )
+      if not console_io.PromptContinue(message=delete_warning):
+        return None
+
+    client = backups_client.BackupsClient(self._RELEASE_TRACK)
+    result = client.DeleteBackup(backup_ref, args.async_)
+    if args.async_:
+      command = 'gcloud {} netapp backup-vaults backups list'.format(
+          self.ReleaseTrack().prefix
+      )
+      log.status.Print(
+          'Check the status of the deletion by listing all backups:\n  '
+          '$ {} '.format(command)
+      )
+    return result
+
+
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class DeleteBeta(Delete):
+  """Delete a Cloud NetApp Backup."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA

gcloud auth application-default login/google-cloud-sdk/lib/surface/netapp/backup_vaults/backups/describe.py

@@ -0,0 +1,66 @@
+# -*- 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.
+"""Describe a Cloud NetApp Backup."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.netapp.backup_vaults.backups import client as backups_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.netapp import flags
+from googlecloudsdk.command_lib.netapp.backup_vaults.backups import flags as backups_flags
+from googlecloudsdk.command_lib.util.concepts import concept_parsers
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Describe(base.DescribeCommand):
+  """Describe a Cloud NetApp Backup."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.GA
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Describe a Cloud NetApp Backup.
+          """,
+      'EXAMPLES': """\
+          The following command describes a Backup named BACKUP in the given location and backup vault:
+
+              $ {command} NAME --location=us-central1 --backup-vault=BACKUP_VAULT
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    concept_parsers.ConceptParser(
+        [flags.GetBackupPresentationSpec('The Backup to describe.')]
+    ).AddToParser(parser)
+    backups_flags.AddBackupBackupVaultResourceArg(parser)
+
+  def Run(self, args):
+    """Get a Cloud NetApp Backup in the current project."""
+    backup_ref = args.CONCEPTS.backup.Parse()
+
+    client = backups_client.BackupsClient(
+        release_track=self._RELEASE_TRACK
+    )
+    return client.GetBackup(backup_ref)
+
+
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class DescribeBeta(Describe):
+  """Describe a Cloud NetApp Backup."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA

gcloud auth application-default login/google-cloud-sdk/lib/surface/netapp/backup_vaults/backups/list.py

@@ -0,0 +1,78 @@
+# -*- 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.
+"""List Cloud NetApp Backups."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.netapp.backup_vaults.backups import client as backups_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions
+from googlecloudsdk.command_lib.netapp import flags
+from googlecloudsdk.command_lib.netapp.backup_vaults.backups import flags as backups_flags
+from googlecloudsdk.command_lib.util.concepts import concept_parsers
+from googlecloudsdk.core import properties
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class List(base.ListCommand):
+  """List Cloud NetApp Backups."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.GA
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Lists Cloud NetApp Backups.
+          """,
+      'EXAMPLES': """\
+          The following command lists all Backups in the given location and Backup Vault named BACKUP_VAULT:
+
+              $ {command} --location=us-central1 --backup-vault=BACKUP_VAULT
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    concept_parsers.ConceptParser(
+        [
+            flags.GetResourceListingLocationPresentationSpec(
+                'The location in which to list Backups.'
+            )
+        ]
+    ).AddToParser(parser)
+    backups_flags.AddBackupBackupVaultResourceArg(parser)
+
+  def Run(self, args):
+    """Run the list command."""
+    # Ensure that project is set before parsing location resource.
+    properties.VALUES.core.project.GetOrFail()
+
+    if args.CONCEPTS.backup_vault.Parse() is None:
+      raise exceptions.RequiredArgumentException(
+          '--backup-vault', 'Requires a Backup Vault to list Backups of'
+      )
+    backupvault_ref = args.CONCEPTS.backup_vault.Parse().RelativeName()
+    client = backups_client.BackupsClient(
+        release_track=self._RELEASE_TRACK
+    )
+    return list(client.ListBackups(backupvault_ref))
+
+
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class ListBeta(List):
+  """List Cloud NetApp Backups."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA

gcloud auth application-default login/google-cloud-sdk/lib/surface/netapp/backup_vaults/backups/update.py

@@ -0,0 +1,100 @@
+# -*- 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.
+"""Update a Cloud NetApp Backups."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.netapp.backup_vaults.backups import client as backups_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.netapp.backup_vaults.backups import flags as backups_flags
+from googlecloudsdk.command_lib.util.args import labels_util
+
+from googlecloudsdk.core import log
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Update(base.UpdateCommand):
+  """Update a Cloud NetApp Backup."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.GA
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Update a Cloud NetApp Backup and its specified parameters.
+          """,
+      'EXAMPLES': """\
+          The following command updates a Backup named BACKUP and its specified parameters:
+
+              $ {command} NAME --location=us-central1 --description="new description"
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    """Add args for updating a Backup."""
+    backups_flags.AddBackupUpdateArgs(parser)
+
+  def Run(self, args):
+    """Update a Cloud NetApp Backup in the current project."""
+    backup_ref = args.CONCEPTS.backup.Parse()
+
+    client = backups_client.BackupsClient(self._RELEASE_TRACK)
+    labels_diff = labels_util.Diff.FromUpdateArgs(args)
+    original_backup = client.GetBackup(backup_ref)
+
+    # Update labels
+    if labels_diff.MayHaveUpdates():
+      labels = labels_diff.Apply(
+          client.messages.Backup.LabelsValue, original_backup.labels
+      ).GetOrNone()
+    else:
+      labels = None
+
+    backup = client.ParseUpdatedBackup(
+        original_backup, description=args.description, labels=labels,
+    )
+
+    updated_fields = []
+    if args.IsSpecified('description'):
+      updated_fields.append('description')
+    if (
+        args.IsSpecified('update_labels')
+        or args.IsSpecified('remove_labels')
+        or args.IsSpecified('clear_labels')
+    ):
+      updated_fields.append('labels')
+    update_mask = ','.join(updated_fields)
+
+    result = client.UpdateBackup(
+        backup_ref, backup, update_mask, args.async_
+    )
+    if args.async_:
+      command = 'gcloud {} netapp backup-vaults backups list'.format(
+          self.ReleaseTrack().prefix
+      )
+      log.status.Print(
+          'Check the status of the updated backup by listing all'
+          ' backups:\n  $ {} '.format(command)
+      )
+    return result
+
+
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class UpdateBeta(Update):
+  """Update a Cloud NetApp Backup."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA