1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-16 20:36:39 +00:00

gcloud: Thu Jun 8 11:29:23 UTC 2023

This commit is contained in:
Automated 2023-06-08 11:29:23 +00:00
parent 91de7103bb
commit 435c9359b5
115 changed files with 1566 additions and 491 deletions

View file

@ -5,6 +5,10 @@ NAME
SYNOPSIS
gcloud alloydb clusters create CLUSTER --password=PASSWORD --region=REGION
[--async] [--network=NETWORK]
[--continuous-backup-recovery-window-days=RECOVERY_PERIOD
--enable-continuous-backup
[--continuous-backup-encryption-key=CONTINUOUS_BACKUP_ENCRYPTION_KEY
: --continuous-backup-encryption-key-keyring=CONTINUOUS_BACKUP_ENCRYPTION_KEY_KEYRING --continuous-backup-encryption-key-location=CONTINUOUS_BACKUP_ENCRYPTION_KEY_LOCATION --continuous-backup-encryption-key-project=CONTINUOUS_BACKUP_ENCRYPTION_KEY_PROJECT]]
[--disable-automated-backup
| [--automated-backup-days-of-week=[DAYS_OF_WEEK,...]
--automated-backup-start-times=[START_TIMES,...]
@ -48,6 +52,59 @@ OPTIONAL FLAGS
network, 'testsharednetwork', this would be of the
form:--network=projects/testproject/global/networks/testsharednetwork
Continuous Backup configuration.
--continuous-backup-recovery-window-days=RECOVERY_PERIOD
Recovery window of the log files and backups saved to support
Continuous Backups.
--enable-continuous-backup
Enables Continuous Backups on the cluster.
Key resource - The Cloud KMS (Key Management Service) cryptokey that
will be used to protect the continuous backup. The 'AlloyDB Service
Agent's service account must hold permission 'Cloud KMS CryptoKey
Encrypter/Decrypter'. The arguments in this group can be used to specify
the attributes of this resource.
--continuous-backup-encryption-key=CONTINUOUS_BACKUP_ENCRYPTION_KEY
ID of the key or fully qualified identifier for the key.
To set the kms-key attribute:
▫ provide the argument --continuous-backup-encryption-key on the
command line.
This flag argument must be specified if any of the other arguments
in this group are specified.
--continuous-backup-encryption-key-keyring=CONTINUOUS_BACKUP_ENCRYPTION_KEY_KEYRING
The KMS keyring of the key.
To set the kms-keyring attribute:
▫ provide the argument --continuous-backup-encryption-key on the
command line with a fully specified name;
▫ provide the argument --continuous-backup-encryption-key-keyring
on the command line.
--continuous-backup-encryption-key-location=CONTINUOUS_BACKUP_ENCRYPTION_KEY_LOCATION
The Google Cloud location for the key.
To set the kms-location attribute:
▫ provide the argument --continuous-backup-encryption-key on the
command line with a fully specified name;
▫ provide the argument
--continuous-backup-encryption-key-location on the command line.
--continuous-backup-encryption-key-project=CONTINUOUS_BACKUP_ENCRYPTION_KEY_PROJECT
The Google Cloud project for the key.
To set the kms-project attribute:
▫ provide the argument --continuous-backup-encryption-key on the
command line with a fully specified name;
▫ provide the argument --continuous-backup-encryption-key-project
on the command line;
▫ set the property core/project.
Automated backup policy. If unspecified, automated backups are enabled.
At most one of these can be specified:

View file

@ -35,7 +35,8 @@ COMMANDS
Promote an AlloyDB SECONDARY cluster in a given project and region.
restore
Restore an AlloyDB cluster from a given backup.
Restore an AlloyDB cluster from a given backup or a source cluster and
a timestamp.
update
Update an AlloyDB cluster within a given project and region.

View file

@ -1,16 +1,19 @@
NAME
gcloud alloydb clusters restore - restore an AlloyDB cluster from a given
backup
backup or a source cluster and a timestamp
SYNOPSIS
gcloud alloydb clusters restore CLUSTER --backup=BACKUP --region=REGION
gcloud alloydb clusters restore CLUSTER --region=REGION
(--backup=BACKUP
| --point-in-time=POINT_IN_TIME --source-cluster=SOURCE_CLUSTER)
[--async] [--network=NETWORK]
[--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING
--kms-location=KMS_LOCATION --kms-project=KMS_PROJECT]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
Restore an AlloyDB cluster from a given backup.
Restore an AlloyDB cluster from a given backup or a source cluster and a
timestamp.
EXAMPLES
To restore a cluster from a backup, run:
@ -18,18 +21,43 @@ EXAMPLES
$ gcloud alloydb clusters restore my-cluster --region=us-central1 \
--backup=my-backup
To restore a cluster from a source cluster and a timestamp, run:
$ gcloud alloydb clusters restore my-cluster --region=us-central1 \
--source-cluster=old-cluster \
--point-in-time=2012-11-15T16:19:00.094Z
POSITIONAL ARGUMENTS
CLUSTER
AlloyDB cluster ID
REQUIRED FLAGS
--backup=BACKUP
AlloyDB backup ID
--region=REGION
Regional location (e.g. asia-east1, us-east1). See the full list of
regions at https://cloud.google.com/sql/docs/instance-locations.
RestoreCluster source types.
Exactly one of these must be specified:
--backup=BACKUP
AlloyDB backup ID
Restore a cluster from a source cluster at a given point in time.
--point-in-time=POINT_IN_TIME
Point in time to restore to, in RFC 3339 format. For example,
2012-11-15T16:19:00.094Z.
This flag argument must be specified if any of the other arguments
in this group are specified.
--source-cluster=SOURCE_CLUSTER
Source cluster name.
This flag argument must be specified if any of the other arguments
in this group are specified.
OPTIONAL FLAGS
--async
Return immediately, without waiting for the operation in progress to

View file

@ -10,6 +10,9 @@ SYNOPSIS
: --automated-backup-window=TIMEOUT_PERIOD
[--automated-backup-encryption-key=AUTOMATED_BACKUP_ENCRYPTION_KEY
: --automated-backup-encryption-key-keyring=AUTOMATED_BACKUP_ENCRYPTION_KEY_KEYRING --automated-backup-encryption-key-location=AUTOMATED_BACKUP_ENCRYPTION_KEY_LOCATION --automated-backup-encryption-key-project=AUTOMATED_BACKUP_ENCRYPTION_KEY_PROJECT] --automated-backup-retention-count=RETENTION_COUNT | --automated-backup-retention-period=RETENTION_PERIOD]]
[--continuous-backup-recovery-window-days=RECOVERY_PERIOD
--enable-continuous-backup --clear-continuous-backup-encryption-key
| [--continuous-backup-encryption-key=CONTINUOUS_BACKUP_ENCRYPTION_KEY : --continuous-backup-encryption-key-keyring=CONTINUOUS_BACKUP_ENCRYPTION_KEY_KEYRING --continuous-backup-encryption-key-location=CONTINUOUS_BACKUP_ENCRYPTION_KEY_LOCATION --continuous-backup-encryption-key-project=CONTINUOUS_BACKUP_ENCRYPTION_KEY_PROJECT]]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
@ -132,6 +135,68 @@ OPTIONAL FLAGS
Retention period of the backup relative to creation time. See $
gcloud topic datetimes for information on duration formats.
Continuous Backup configuration.
--continuous-backup-recovery-window-days=RECOVERY_PERIOD
Recovery window of the log files and backups saved to support
Continuous Backups.
--enable-continuous-backup
Enables Continuous Backups on the cluster.
Encryption configuration for Continuous Backups.
At most one of these can be specified:
--clear-continuous-backup-encryption-key
Clears the encryption configuration for Continuous Backups. Google
default encryption will be used for future Continuous Backups.
Key resource - The Cloud KMS (Key Management Service) cryptokey that
will be used to protect the continuous backup. The 'AlloyDB Service
Agent's service account must hold permission 'Cloud KMS CryptoKey
Encrypter/Decrypter'. The arguments in this group can be used to
specify the attributes of this resource.
--continuous-backup-encryption-key=CONTINUOUS_BACKUP_ENCRYPTION_KEY
ID of the key or fully qualified identifier for the key.
To set the kms-key attribute:
◇ provide the argument --continuous-backup-encryption-key on
the command line.
This flag argument must be specified if any of the other
arguments in this group are specified.
--continuous-backup-encryption-key-keyring=CONTINUOUS_BACKUP_ENCRYPTION_KEY_KEYRING
The KMS keyring of the key.
To set the kms-keyring attribute:
◇ provide the argument --continuous-backup-encryption-key on
the command line with a fully specified name;
◇ provide the argument
--continuous-backup-encryption-key-keyring on the command line.
--continuous-backup-encryption-key-location=CONTINUOUS_BACKUP_ENCRYPTION_KEY_LOCATION
The Google Cloud location for the key.
To set the kms-location attribute:
◇ provide the argument --continuous-backup-encryption-key on
the command line with a fully specified name;
◇ provide the argument
--continuous-backup-encryption-key-location on the command
line.
--continuous-backup-encryption-key-project=CONTINUOUS_BACKUP_ENCRYPTION_KEY_PROJECT
The Google Cloud project for the key.
To set the kms-project attribute:
◇ provide the argument --continuous-backup-encryption-key on
the command line with a fully specified name;
◇ provide the argument
--continuous-backup-encryption-key-project on the command line;
◇ set the property core/project.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,