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_policies/__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 Backup Policies."""
+
+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 BackupPolicies(base.Group):
+  """Create and manage Cloud NetApp Backup Policies."""
+
+
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class BackupPoliciesBeta(BackupPolicies):
+  """Create and manage Cloud NetApp Backup Policies."""
+

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

@@ -0,0 +1,84 @@
+# -*- 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.
+"""Creates a Cloud NetApp Backup Policy."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.netapp.backup_policies import client as backuppolicies_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.netapp.backup_policies import flags as backuppolicies_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 Policy."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.GA
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Creates a Backup Policy for Cloud NetApp Volumes.
+          """,
+      'EXAMPLES': """\
+          The following command creates a Backup Policy named BACKUP_POLICY with all possible arguments:
+
+              $ {command} BACKUP_POLICY --location=us-central1 --enabled=true --daily-backup-limit=3 --weekly-backup-limit=5 --monthly-backup-limit=2 --description="first backup policy" --labels=key1=val1
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    backuppolicies_flags.AddBackupPolicyCreateArgs(parser)
+
+  def Run(self, args):
+    """Create a Cloud NetApp Backup Policy in the current project."""
+    backuppolicy_ref = args.CONCEPTS.backup_policy.Parse()
+    client = backuppolicies_client.BackupPoliciesClient(self._RELEASE_TRACK)
+    labels = labels_util.ParseCreateArgs(
+        args, client.messages.BackupPolicy.LabelsValue)
+
+    backup_policy = client.ParseBackupPolicy(
+        name=backuppolicy_ref.RelativeName(),
+        enabled=args.enabled,
+        daily_backup_limit=args.daily_backup_limit,
+        weekly_backup_limit=args.weekly_backup_limit,
+        monthly_backup_limit=args.monthly_backup_limit,
+        description=args.description,
+        labels=labels,
+    )
+    result = client.CreateBackupPolicy(
+        backuppolicy_ref, args.async_, backup_policy
+    )
+    if args.async_:
+      command = 'gcloud {} netapp backup-policies list'.format(
+          self.ReleaseTrack().prefix
+      )
+      log.status.Print(
+          'Check the status of the new backup policy by listing all backup'
+          ' policies:\n  $ {} '.format(command)
+      )
+    return result
+
+
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class CreateBeta(Create):
+  """Create a Cloud NetApp Backup Policy."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA

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

@@ -0,0 +1,79 @@
+# -*- 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 Volumes Backup Policy."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.netapp.backup_policies import client as backuppolicies_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.netapp.backup_policies import flags as backuppolicies_flags
+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 Volumes Backup Policy."""
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Delete a Backup Policy
+          """,
+      'EXAMPLES': """\
+          The following command deletes a Backup Policy instance named BACKUP_POLICY in the default netapp/location
+
+              $ {command} BACKUP_POLICY
+
+          To delete a Backup Policy named BACKUP_POLICY asynchronously, run the following command:
+
+              $ {command} BACKUP_POLICY --async
+          """,
+  }
+
+  _RELEASE_TRACK = base.ReleaseTrack.GA
+
+  @staticmethod
+  def Args(parser):
+    backuppolicies_flags.AddBackupPolicyDeleteArgs(parser)
+
+  def Run(self, args):
+    """Delete a Cloud NetApp Volumes Backup Policy."""
+
+    backuppolicy_ref = args.CONCEPTS.backup_policy.Parse()
+    if not args.quiet:
+      delete_warning = ('You are about to delete a Backup Policy {}.\n'
+                        'Are you sure?'.format(backuppolicy_ref.RelativeName()))
+      if not console_io.PromptContinue(message=delete_warning):
+        return None
+    client = backuppolicies_client.BackupPoliciesClient(
+        release_track=self._RELEASE_TRACK)
+    result = client.DeleteBackupPolicy(backuppolicy_ref, args.async_)
+
+    if args.async_:
+      command = 'gcloud {} netapp backup-policies list'.format(
+          self.ReleaseTrack().prefix)
+      log.status.Print(
+          'Check the status of the deletion by listing all Backup Policies:\n  '
+          '$ {} '.format(command))
+    return result
+
+
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class DeleteBeta(Delete):
+  """Delete a Cloud NetApp Volumes Backup Policy."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA

gcloud auth application-default login/google-cloud-sdk/lib/surface/netapp/backup_policies/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.
+"""Describes a Cloud NetApp Volumes Backup Policy."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.netapp.backup_policies import client as backuppolicies_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.netapp import flags
+from googlecloudsdk.command_lib.util.concepts import concept_parsers
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Describe(base.DescribeCommand):
+  """Show metadata for a Cloud NetApp Volumes Backup Policy."""
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Describe a Backup Policy
+          """,
+      'EXAMPLES': """\
+          The following command gets metadata using describe for a Backup Policy  named BACKUP_POLICY in the default netapp/location:
+
+              $ {command} BACKUP_POLICY
+
+          To get metadata on a Backup Policy named BACKUP_POLICY in a specified location, run:
+
+              $ {command} BACKUP_POLICY --location=us-central1
+          """,
+  }
+
+  _RELEASE_TRACK = base.ReleaseTrack.GA
+
+  @staticmethod
+  def Args(parser):
+    concept_parsers.ConceptParser([flags.GetBackupPolicyPresentationSpec(
+        'The Backup Policy to describe.')]).AddToParser(parser)
+
+  def Run(self, args):
+    """Run the describe command."""
+    backuppolicy_ref = args.CONCEPTS.backup_policy.Parse()
+    client = backuppolicies_client.BackupPoliciesClient(
+        release_track=self._RELEASE_TRACK)
+    return client.GetBackupPolicy(backuppolicy_ref)
+
+
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class DescribeBeta(Describe):
+  """Show metadata for a Cloud NetApp Volumes Backup Policy."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA
+

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

@@ -0,0 +1,83 @@
+# -*- 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.
+"""Lists Cloud NetApp Volumes Backup Policies."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.netapp.backup_policies import client as backuppolicies_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.netapp import flags
+from googlecloudsdk.command_lib.netapp.backup_policies import flags as backuppolicies_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 Volumes Backup Policies."""
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Lists Backup Policies for Cloud NetApp Volumes
+          """,
+      'EXAMPLES': """\
+          The following command lists all Backup Policies in the default netapp/location
+
+              $ {command}
+
+          To list all Backup Policies in a specified location, run:
+
+              $ {command} --location=us-central1
+          """,
+  }
+
+  _RELEASE_TRACK = base.ReleaseTrack.GA
+
+  @staticmethod
+  def Args(parser):
+    concept_parsers.ConceptParser(
+        [
+            flags.GetResourceListingLocationPresentationSpec(
+                'The location in which to list Backup Policies.'
+            )
+        ]
+    ).AddToParser(parser)
+    parser.display_info.AddFormat(
+        backuppolicies_flags.BACKUP_POLICIES_LIST_FORMAT
+    )
+
+  def Run(self, args):
+    """Run the list command."""
+    # Ensure that project is set before parsing location resource.
+    properties.VALUES.core.project.GetOrFail()
+    location_ref = args.CONCEPTS.location.Parse().RelativeName()
+    # Default to listing all Cloud NetApp Active Directories in all locations.
+    location = args.location if args.location else '-'
+    location_list = location_ref.split('/')
+    location_list[-1] = location
+    location_ref = '/'.join(location_list)
+    client = backuppolicies_client.BackupPoliciesClient(
+        release_track=self._RELEASE_TRACK)
+    return list(client.ListBackupPolicies(location_ref, limit=args.limit))
+
+
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class ListBeta(List):
+  """List Cloud NetApp Volumes Backup Policies."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA
+

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

@@ -0,0 +1,113 @@
+# -*- 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.
+"""Updates a Cloud NetApp Volumes Backup Policies."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.netapp.backup_policies import client as backuppolicies_client
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.netapp.backup_policies import flags as backuppolicies_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 Volumes Backup Policies."""
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          Updates a Backup Policy
+          """,
+      'EXAMPLES': """\
+          The following command updates a Backup Policy named BACKUP_POLICY with all possible arguments
+
+              $ {command} BACKUP_POLICY --location=us-central1 --enabled=True --daily-backup-limit=5 --weekly-backup-limit=3 --monthly-backup-limit=2
+
+          To update a Backup Policy named BACKUP_POLICY asynchronously, run the following command:
+
+              $ {command} BACKUP_POLICY --async --location=us-central1 --enabled=True --daily-backup-limit=5 --weekly-backup-limit=3 --monthly-backup-limit=2
+              """,
+  }
+
+  _RELEASE_TRACK = base.ReleaseTrack.GA
+
+  @staticmethod
+  def Args(parser):
+    backuppolicies_flags.AddBackupPolicyUpdateArgs(parser)
+
+  def Run(self, args):
+    """Update a Cloud NetApp Volumes Backup Policy in the current project."""
+    backuppolicy_ref = args.CONCEPTS.backup_policy.Parse()
+    client = backuppolicies_client.BackupPoliciesClient(self._RELEASE_TRACK)
+    labels_diff = labels_util.Diff.FromUpdateArgs(args)
+    orig_backuppolicy = client.GetBackupPolicy(backuppolicy_ref)
+    ## Update labels
+    if labels_diff.MayHaveUpdates():
+      labels = labels_diff.Apply(
+          client.messages.BackupPolicy.LabelsValue, orig_backuppolicy.labels
+      ).GetOrNone()
+    else:
+      labels = None
+    backup_policy = client.ParseUpdatedBackupPolicy(
+        orig_backuppolicy,
+        enabled=args.enabled,
+        daily_backup_limit=args.daily_backup_limit,
+        weekly_backup_limit=args.weekly_backup_limit,
+        monthly_backup_limit=args.monthly_backup_limit,
+        description=args.description,
+        labels=labels,
+    )
+
+    updated_fields = []
+    if args.IsSpecified('enabled'):
+      updated_fields.append('enabled')
+    if args.IsSpecified('daily_backup_limit'):
+      updated_fields.append('dailyBackupLimit')
+    if args.IsSpecified('weekly_backup_limit'):
+      updated_fields.append('weeklyBackupLimit')
+    if args.IsSpecified('monthly_backup_limit'):
+      updated_fields.append('monthlyBackupLimit')
+    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.UpdateBackupPolicy(
+        backuppolicy_ref, backup_policy, update_mask, args.async_
+    )
+    if args.async_:
+      command = 'gcloud {} netapp backup-policies list'.format(
+          self.ReleaseTrack().prefix
+      )
+      log.status.Print(
+          'Check the status of the updated backup policy by listing all kms'
+          ' configs:\n  $ {} '.format(command)
+      )
+    return result
+
+
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class UpdateBeta(Update):
+  """Update a Cloud NetApp Volumes Backup Policies."""
+
+  _RELEASE_TRACK = base.ReleaseTrack.BETA