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

This commit is contained in:
2026-01-01 20:26:35 +01:00
parent 5e23cbece0
commit a19e592eb7
25221 changed files with 8324611 additions and 0 deletions

View File

@@ -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 Vaults."""
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 BackupVaults(base.Group):
"""Create and manage Cloud NetApp Backup Vaults."""
@base.ReleaseTracks(base.ReleaseTrack.BETA)
class BackupVaultsBeta(BackupVaults):
"""Create and manage Cloud NetApp Backup Vaults."""

View File

@@ -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."""

View File

@@ -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

View File

@@ -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

View File

@@ -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

View File

@@ -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

View File

@@ -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

View File

@@ -0,0 +1,104 @@
# -*- 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 Vault."""
from __future__ import absolute_import
from __future__ import division
from __future__ import unicode_literals
from googlecloudsdk.api_lib.netapp.backup_vaults import client as backupvaults_client
from googlecloudsdk.calliope import base
from googlecloudsdk.command_lib.netapp.backup_vaults import flags as backupvaults_flags
from googlecloudsdk.command_lib.util.args import labels_util
from googlecloudsdk.core import log
@base.ReleaseTracks(base.ReleaseTrack.GA)
@base.DefaultUniverseOnly
class Create(base.CreateCommand):
"""Create a Cloud NetApp Backup Vault."""
_RELEASE_TRACK = base.ReleaseTrack.GA
detailed_help = {
'DESCRIPTION': """\
Create a Cloud NetApp Backup Vault.
""",
'EXAMPLES': """\
The following command creates a Backup Vault named BACKUP_VAULT asynchronously using the specified arguments:
$ {command} BACKUP_VAULT --location=LOCATION --async --description="test"
The following command creates a Backup Vault named CMEK_BACKUP_VAULT with a KMS config:
$ {command} CMEK_BACKUP_VAULT --location=LOCATION --kms-config=projects/PROJECT/locations/LOCATION/kmsConfigs/KMS_CONFIG
""",
}
@staticmethod
def Args(parser):
backupvaults_flags.AddBackupVaultCreateArgs(parser, Create._RELEASE_TRACK)
def Run(self, args):
"""Create a Cloud NetApp Backup Vault in the current project."""
backupvault_ref = args.CONCEPTS.backup_vault.Parse()
client = backupvaults_client.BackupVaultsClient(self._RELEASE_TRACK)
labels = labels_util.ParseCreateArgs(
args, client.messages.BackupVault.LabelsValue
)
backup_vault_type = None
backup_region = None
kms_config = args.kms_config
if self._RELEASE_TRACK == base.ReleaseTrack.BETA:
backup_vault_type = backupvaults_flags.GetBackupVaultTypeEnumFromArg(
args.backup_vault_type, client.messages
)
backup_region = args.backup_region
backup_vault = client.ParseBackupVault(
name=backupvault_ref.RelativeName(),
description=args.description,
labels=labels,
backup_retention_policy=args.backup_retention_policy,
backup_vault_type=backup_vault_type,
backup_region=backup_region,
kms_config=kms_config,
)
result = client.CreateBackupVault(
backupvault_ref, args.async_, backup_vault
)
if args.async_:
command = 'gcloud {} netapp backup-vaults list'.format(
' ' + self.ReleaseTrack().prefix if self.ReleaseTrack().prefix else ''
)
log.status.Print(
'Check the status of the new backup vault by listing all backup'
' vaults:\n $ {} '.format(command)
)
return result
@base.ReleaseTracks(base.ReleaseTrack.BETA)
class CreateBeta(Create):
"""Create a Cloud NetApp Backup Vault."""
_RELEASE_TRACK = base.ReleaseTrack.BETA
@staticmethod
def Args(parser):
backupvaults_flags.AddBackupVaultCreateArgs(
parser, CreateBeta._RELEASE_TRACK
)

View File

@@ -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 Vault."""
from __future__ import absolute_import
from __future__ import division
from __future__ import unicode_literals
from googlecloudsdk.api_lib.netapp.backup_vaults import client as backupvaults_client
from googlecloudsdk.calliope import base
from googlecloudsdk.command_lib.netapp.backup_vaults import flags as backupvaults_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 Vault."""
detailed_help = {
'DESCRIPTION': """\
Delete a Backup Vault.
""",
'EXAMPLES': """\
The following command deletes a Backup Vault instance named BACKUP_VAULT in the default netapp/location:
$ {command} BACKUP_VAULT
To delete a Backup Vault named BACKUP_VAULT asynchronously, run the following command:
$ {command} BACKUP_VAULT --async
""",
}
_RELEASE_TRACK = base.ReleaseTrack.GA
@staticmethod
def Args(parser):
backupvaults_flags.AddBackupVaultDeleteArgs(parser)
def Run(self, args):
"""Delete a Cloud NetApp Volumes Backup Vault."""
backupvault_ref = args.CONCEPTS.backup_vault.Parse()
if not args.quiet:
delete_warning = ('You are about to delete a Backup Vault {}.\n'
'Are you sure?'.format(backupvault_ref.RelativeName()))
if not console_io.PromptContinue(message=delete_warning):
return None
client = backupvaults_client.BackupVaultsClient(
release_track=self._RELEASE_TRACK)
result = client.DeleteBackupVault(backupvault_ref, args.async_)
if args.async_:
command = 'gcloud {} netapp backup-vaults list'.format(
self.ReleaseTrack().prefix)
log.status.Print(
'Check the status of the deletion by listing all Backup Vaults:\n '
'$ {} '.format(command))
return result
@base.ReleaseTracks(base.ReleaseTrack.BETA)
class DeleteBeta(Delete):
"""Delete a Cloud NetApp Volumes Backup Vault."""
_RELEASE_TRACK = base.ReleaseTrack.BETA

View File

@@ -0,0 +1,65 @@
# -*- 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 Vault."""
from __future__ import absolute_import
from __future__ import division
from __future__ import unicode_literals
from googlecloudsdk.api_lib.netapp.backup_vaults import client as backupvaults_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 Vault."""
detailed_help = {
'DESCRIPTION': """\
Describe a Backup Vault.
""",
'EXAMPLES': """\
The following command gets metadata using describe for a Backup Vault instance named BACKUP_VAULT in the default netapp/location:
$ {command} BACKUP_VAULT
To get metadata on a Backup Vault named BACKUP_VAULT in a specified location, run:
$ {command} BACKUP_VAULT --location=us-central1
""",
}
_RELEASE_TRACK = base.ReleaseTrack.GA
@staticmethod
def Args(parser):
concept_parsers.ConceptParser([flags.GetBackupVaultPresentationSpec(
'The Backup Vault to describe.')]).AddToParser(parser)
def Run(self, args):
"""Run the describe command."""
backupvault_ref = args.CONCEPTS.backup_vault.Parse()
client = backupvaults_client.BackupVaultsClient(
release_track=self._RELEASE_TRACK)
return client.GetBackupVault(backupvault_ref)
@base.ReleaseTracks(base.ReleaseTrack.BETA)
class DescribeBeta(Describe):
"""Show metadata for a Cloud NetApp Volumes Backup Vault."""
_RELEASE_TRACK = base.ReleaseTrack.BETA

View File

@@ -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 Vaults."""
from __future__ import absolute_import
from __future__ import division
from __future__ import unicode_literals
from googlecloudsdk.api_lib.netapp.backup_vaults import client as backupvaults_client
from googlecloudsdk.calliope import base
from googlecloudsdk.command_lib.netapp import flags
from googlecloudsdk.command_lib.netapp.backup_vaults import flags as backupvaults_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 Vaults."""
detailed_help = {
'DESCRIPTION': """\
Lists Cloud NetApp Backup Vaults to store Cloud NetApp Volumes Backups.
""",
'EXAMPLES': """\
The following command lists all Backup Vaults in the default netapp/location
$ {command}
To list all Backup Vaults 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 Vaults.'
)
]
).AddToParser(parser)
parser.display_info.AddFormat(
backupvaults_flags.BACKUP_VAULTS_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 Backup Vaults 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 = backupvaults_client.BackupVaultsClient(
release_track=self._RELEASE_TRACK)
return list(client.ListBackupVaults(location_ref))
@base.ReleaseTracks(base.ReleaseTrack.BETA)
class ListBeta(List):
"""List Cloud NetApp Volumes Backup Vaults."""
_RELEASE_TRACK = base.ReleaseTrack.BETA

View File

@@ -0,0 +1,104 @@
# -*- 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 Vaults."""
from __future__ import absolute_import
from __future__ import division
from __future__ import unicode_literals
from googlecloudsdk.api_lib.netapp.backup_vaults import client as backupvaults_client
from googlecloudsdk.calliope import base
from googlecloudsdk.command_lib.netapp.backup_vaults import flags as backupvaults_flags
from googlecloudsdk.command_lib.util.args import labels_util
from googlecloudsdk.core import log
@base.ReleaseTracks(base.ReleaseTrack.GA)
@base.DefaultUniverseOnly
class Update(base.UpdateCommand):
"""Update a Cloud NetApp Volumes Backup Vault."""
detailed_help = {
'DESCRIPTION': """\
Updates a Backup Vault
""",
'EXAMPLES': """\
The following command updates a Backup Vault instance named BACKUP_VAULT
$ {command} BACKUP_VAULT --location=us-central1 --description="new description" --update-labels=newkey=newval
To update a Backup Vault named BACKUP_VAULT asynchronously, run the following command:
$ {command} BACKUP_VAULT --async --location=us-central1 --description="new description" --update-labels=newkey=newval """,
}
_RELEASE_TRACK = base.ReleaseTrack.GA
@staticmethod
def Args(parser):
backupvaults_flags.AddBackupVaultUpdateArgs(parser)
def Run(self, args):
"""Update a Cloud NetApp Backup Vaults in the current project."""
backupvault_ref = args.CONCEPTS.backup_vault.Parse()
client = backupvaults_client.BackupVaultsClient(self._RELEASE_TRACK)
labels_diff = labels_util.Diff.FromUpdateArgs(args)
orig_backupvault = client.GetBackupVault(backupvault_ref)
# Update labels
if labels_diff.MayHaveUpdates():
labels = labels_diff.Apply(
client.messages.BackupVault.LabelsValue, orig_backupvault.labels
).GetOrNone()
else:
labels = None
backup_vault = client.ParseUpdatedBackupVault(
orig_backupvault,
description=args.description,
labels=labels,
backup_retention_policy=args.backup_retention_policy,
)
updated_fields = []
if args.IsSpecified('description'):
updated_fields.append('description')
if args.IsSpecified('backup_retention_policy'):
updated_fields.append('backupRetentionPolicy')
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.UpdateBackupVault(
backupvault_ref, backup_vault, update_mask, args.async_
)
if args.async_:
command = 'gcloud {} netapp backup-vaults list'.format(
self.ReleaseTrack().prefix
)
log.status.Print(
'Check the status of the updated backup vault by listing all kms'
' configs:\n $ {} '.format(command)
)
return result
@base.ReleaseTracks(base.ReleaseTrack.BETA)
class UpdateBeta(Update):
"""Update a Cloud NetApp Volumes Backup Vault."""
_RELEASE_TRACK = base.ReleaseTrack.BETA