gcloud beta alloydb clusters create-secondary - create a new AlloyDB SECONDARY cluster within a given project

gcloud beta alloydb clusters create-secondaryCLUSTER--primary-cluster=PRIMARY_CLUSTER--region=REGION[--allocated-ip-range-name=ALLOCATED_IP_RANGE_NAME][--async][--tags=[KEY=VALUE,…]][--automated-backup-days-of-week=[DAYS_OF_WEEK,…]--automated-backup-start-times=[START_TIMES,…]--automated-backup-window=TIMEOUT_PERIOD--enable-automated-backup [--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 [--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]][--kms-key=KMS_KEY :--kms-keyring=KMS_KEYRING--kms-location=KMS_LOCATION--kms-project=KMS_PROJECT][GCLOUD_WIDE_FLAG …]

CLUSTER

AlloyDB cluster ID

--primary-cluster=PRIMARY_CLUSTER

AlloyDB primary cluster ID

--region=REGION

Regional location (e.g.asia-east1,us-east1). See thefull list of regions athttps://cloud.google.com/sql/docs/instance-locations.

--allocated-ip-range-name=ALLOCATED_IP_RANGE_NAME

Name of the allocated IP range for the private IP AlloyDB cluster, for example:"google-managed-services-default". If set, the instance IPs for this clusterwill be created in the allocated range. The range name must comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regularexpression[a-z]([-a-z0-9]*[a-z0-9])?.

--async

Return immediately, without waiting for the operation in progress to complete.

--tags=[KEY=VALUE,…]

List of tags KEY=VALUE pairs to bind. Each item must be expressed as<tag-key-namespaced-name>=<tag-value-short-name>.

Example:123/environment=production,123/costCenter=marketing

Automated backup policy. If unspecified, automated backups are copied from theassociated primary cluster.

--automated-backup-days-of-week=[DAYS_OF_WEEK,…]

Comma-separated list of days of the week to perform a backup. At least one dayof the week must be provided. (e.g.,--automated-backup-days-of-week=MONDAY,WEDNESDAY,SUNDAY).DAYS_OF_WEEK must be one of:MONDAY,TUESDAY,WEDNESDAY,THURSDAY,FRIDAY,SATURDAY,SUNDAY.

--automated-backup-start-times=[START_TIMES,…]

Comma-separated list of times during the day to start a backup. At least onestart time must be provided. The start times are assumed to be in UTC andrequired to be an exact hour in the format HH:00. (e.g.,--automated-backup-start-times=01:00,13:00)

--automated-backup-window=TIMEOUT_PERIOD

The length of the time window beginning at start time during which a backup canbe taken. If a backup does not succeed within this time window, it will becanceled and considered failed. The backup window must be at least 5 minuteslong. There is no upper bound on the window. If not set, it will default to 1hour.

--enable-automated-backup

Enables Automated Backups on the cluster.

Key resource - The Cloud KMS (Key Management Service) cryptokey that will beused to protect the automated backups. The 'AlloyDB Service Agent' serviceaccount must hold permission 'Cloud KMS CryptoKey Encrypter/Decrypter'. Thearguments in this group can be used to specify the attributes of this resource.

--automated-backup-encryption-key=AUTOMATED_BACKUP_ENCRYPTION_KEY

ID of the key or fully qualified identifier for the key.

To set thekms-key attribute:

• provide the argument--automated-backup-encryption-key on thecommand line.

This flag argument must be specified if any of the other arguments in this groupare specified.

--automated-backup-encryption-key-keyring=AUTOMATED_BACKUP_ENCRYPTION_KEY_KEYRING

The KMS keyring of the key.

To set thekms-keyring attribute:

• provide the argument--automated-backup-encryption-key on thecommand line with a fully specified name;
• provide the argument--automated-backup-encryption-key-keyring onthe command line.

--automated-backup-encryption-key-location=AUTOMATED_BACKUP_ENCRYPTION_KEY_LOCATION

The Google Cloud location for the key.

To set thekms-location attribute:

• provide the argument--automated-backup-encryption-key on thecommand line with a fully specified name;
• provide the argument--automated-backup-encryption-key-location onthe command line.

--automated-backup-encryption-key-project=AUTOMATED_BACKUP_ENCRYPTION_KEY_PROJECT

The Google Cloud project for the key.

To set thekms-project attribute:

• provide the argument--automated-backup-encryption-key on thecommand line with a fully specified name;
• provide the argument--automated-backup-encryption-key-project onthe command line;
• set the propertycore/project.

Retention policy. If no retention policy is provided, all automated backups willbe retained.

At most one of these can be specified:

--automated-backup-retention-count=RETENTION_COUNT

Number of most recent successful backups retained.

--automated-backup-retention-period=RETENTION_PERIOD

Retention period of the backup relative to creation time. See$gcloud topic datetimesfor information on duration formats.

Continuous Backup configuration. If unspecified, continuous backups are copiedfrom the associated primary cluster.

--continuous-backup-recovery-window-days=RECOVERY_PERIOD

Recovery window of the log files and backups saved to support ContinuousBackups.

--enable-continuous-backup

Enables Continuous Backups on the cluster.

Key resource - The Cloud KMS (Key Management Service) cryptokey that will beused to protect the continuous backup. The 'AlloyDB Service Agent's serviceaccount must hold permission 'Cloud KMS CryptoKey Encrypter/Decrypter'. Thearguments 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 thekms-key attribute:

• provide the argument--continuous-backup-encryption-key on thecommand line.

This flag argument must be specified if any of the other arguments in this groupare specified.

--continuous-backup-encryption-key-keyring=CONTINUOUS_BACKUP_ENCRYPTION_KEY_KEYRING

The KMS keyring of the key.

To set thekms-keyring attribute:

• provide the argument--continuous-backup-encryption-key on thecommand line with a fully specified name;
• provide the argument--continuous-backup-encryption-key-keyring onthe command line.

--continuous-backup-encryption-key-location=CONTINUOUS_BACKUP_ENCRYPTION_KEY_LOCATION

The Google Cloud location for the key.

To set thekms-location attribute:

• provide the argument--continuous-backup-encryption-key on thecommand line with a fully specified name;
• provide the argument--continuous-backup-encryption-key-location onthe command line.

--continuous-backup-encryption-key-project=CONTINUOUS_BACKUP_ENCRYPTION_KEY_PROJECT

The Google Cloud project for the key.

To set thekms-project attribute:

• provide the argument--continuous-backup-encryption-key on thecommand line with a fully specified name;
• provide the argument--continuous-backup-encryption-key-project onthe command line;
• set the propertycore/project.

Key resource - The Cloud KMS (Key Management Service) cryptokey that will beused to protect the cluster. The 'AlloyDB Service Agent' service account musthold permission 'Cloud KMS CryptoKey Encrypter/Decrypter'. The arguments in thisgroup 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 thekms-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 groupare specified.

--kms-keyring=KMS_KEYRING

The KMS keyring of the key.

To set thekms-keyring attribute:

• provide the argument--kms-key on the command line with a fullyspecified name;
• provide the argument--kms-keyring on the command line.

--kms-location=KMS_LOCATION

The Google Cloud location for the key.

To set thekms-location attribute:

• provide the argument--kms-key on the command line with a fullyspecified name;
• provide the argument--kms-location on the command line.

--kms-project=KMS_PROJECT

The Google Cloud project for the key.

To set thekms-project attribute:

• provide the argument--kms-key on the command line with a fullyspecified name;
• provide the argument--kms-project on the command line;
• set the propertycore/project.

Run$gcloud help for details.