1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-13 16:37:00 +00:00
gcloud-help/gcloud/beta/alloydb/clusters/restore
2023-06-08 11:29:23 +00:00

128 lines
4.5 KiB
Text

NAME
gcloud beta alloydb clusters restore - restore an AlloyDB cluster from a
given backup or a source cluster and a timestamp
SYNOPSIS
gcloud beta 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
(BETA) Restore an AlloyDB cluster from a given backup or a source cluster
and a timestamp.
EXAMPLES
To restore a cluster from a backup, run:
$ gcloud beta alloydb clusters restore my-cluster \
--region=us-central1 --backup=my-backup
To restore a cluster from a source cluster and a timestamp, run:
$ gcloud beta 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
--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
complete.
--network=NETWORK
Network in the current project that the instance will be part of. To
specify using a network with a shared VPC, use the full URL of the
network. For an example host project, 'testproject', and shared
network, 'testsharednetwork', this would be of the
form:--network=projects/testproject/global/networks/testsharednetwork
Key resource - The Cloud KMS (Key Management Service) cryptokey that will
be used to protect the cluster. The 'AlloyDB Service Agent' 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.
--kms-key=KMS_KEY
ID of the key or fully qualified identifier for the key.
To set the kms-key attribute:
▸ provide the argument --kms-key on the command line.
This flag argument must be specified if any of the other arguments in
this group are specified.
--kms-keyring=KMS_KEYRING
The KMS keyring of the key.
To set the kms-keyring attribute:
▸ provide the argument --kms-key on the command line with a fully
specified name;
▸ provide the argument --kms-keyring on the command line.
--kms-location=KMS_LOCATION
The Google Cloud location for the key.
To set the kms-location attribute:
▸ provide the argument --kms-key on the command line with a fully
specified name;
▸ provide the argument --kms-location on the command line.
--kms-project=KMS_PROJECT
The Google Cloud project for the key.
To set the kms-project attribute:
▸ provide the argument --kms-key on the command line with a fully
specified name;
▸ provide the argument --kms-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,
--help, --impersonate-service-account, --log-http, --project, --quiet,
--trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:
$ gcloud alloydb clusters restore
$ gcloud alpha alloydb clusters restore