gcloud alpha sql instances clone - clones a Cloud SQL instance

gcloud alpha sql instances cloneSOURCEDESTINATION[--allocated-ip-range-name=ALLOCATED_IP_RANGE_NAME][--async][--destination-network=DESTINATION_NETWORK][--destination-project=DESTINATION_PROJECT][--preferred-secondary-zone=PREFERRED_SECONDARY_ZONE][--preferred-zone=PREFERRED_ZONE][--source-instance-deletion-time=SOURCE_INSTANCE_DELETION_TIME][--bin-log-file-name=BIN_LOG_FILE_NAME--bin-log-position=BIN_LOG_POSITION    | [--point-in-time=POINT_IN_TIME :--restore-database-name=RESTORE_DATABASE_NAME]][GCLOUD_WIDE_FLAG …]

For MySQL: The binary log coordinates or timestamp (point in time), ifspecified, act as the point in time the source instance is cloned from. If notspecified, the current state of the instance is cloned.

For PostgreSQL: The point in time, if specified, defines a past state of theinstance to clone. If not specified, the current state of the instance iscloned.

For SQL Server: The point in time, if specified, defines a past state of theinstance to clone. If not specified, the current state of the instance iscloned.

Note: The flags --destination-project and --destination-network are currentlyfor allowlisted customers only.

gcloudalphasqlinstancesclonemy-source-instancemy-cloned-instance

To clone a MySQL instance from an earlier point in time (past binary logcoordinates):

gcloudalphasqlinstancesclonemy-source-instancemy-cloned-instance--bin-log-file-namemysql-bin.000020--bin-log-position170

To clone a MySQL source instance at a specific point in time:

gcloudalphasqlinstancesclonemy-source-instancemy-cloned-instance--point-in-time'2012-11-15T16:19:00.094Z'

To clone a PostgreSQL source instance at a specific point in time:

gcloudalphasqlinstancesclonemy-source-instancemy-cloned-instance--point-in-time'2012-11-15T16:19:00.094Z'

To clone a SQL Server source instance at a specific point in time:

gcloudalphasqlinstancesclonemy-source-instancemy-cloned-instance--point-in-time'2012-11-15T16:19:00.094Z'

To clone a deleted instance, include the name and deletion time of the sourceinstance:

gcloudalphasqlinstancesclonemy-source-instancemy-cloned-instance--source-instance-deletion-time'2012-11-15T16:19:00.094Z'

To specify the allocated IP range for the private IP target Instance (reservedfor future use):

gcloudalphasqlinstancesclonemy-source-instancemy-cloned-instance--allocated-ip-range-namecloned-instance-ip-range

SOURCE

Cloud SQL instance ID of the source.

DESTINATION

Cloud SQL instance ID of the clone.

--allocated-ip-range-name=ALLOCATED_IP_RANGE_NAME

The name of the IP range allocated for the destination instance with privatenetwork connectivity. For example: 'google-managed-services-default'. If set,the destination instance IP is created in the allocated range represented bythis name. Reserved for future use.

--async

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

--destination-network=DESTINATION_NETWORK

The fully qualified URI of the VPC network to which the cloned instance will beconnected via Private Services Access for private IP. For example:projects/my-network-project/global/networks/my-network. This fieldis required only for cross-project cloning.

--destination-project=DESTINATION_PROJECT

The project ID of the destination project where the cloned instance will becreated. To perform a cross-project clone, this field is required. If notspecified, the clone is created in the same project as the source instance.

--preferred-secondary-zone=PREFERRED_SECONDARY_ZONE

The preferred secondary zone for the cloned regional instance. If you specify avalue for this flag, then the destination instance uses the value as thesecondary zone. The secondary zone can't be the same as the primary zone.

--preferred-zone=PREFERRED_ZONE

The preferred zone for the cloned instance. If you specify a value for thisflag, then the destination instance uses the value as the primary zone.

--source-instance-deletion-time=SOURCE_INSTANCE_DELETION_TIME

The time the source instance was deleted. This is required if cloning from adeleted instance.

At most one of these can be specified:

Binary log coordinates for point-in-time recovery.

--bin-log-file-name=BIN_LOG_FILE_NAME

The name of the binary log file. Enable point-in-time recovery on the sourceinstance to create a binary log file. If specified with<--bin-log-position> to form a valid binary log coordinate, it defines anearlier point in time to clone a source instance from. For example,mysql-bin.000001.

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

--bin-log-position=BIN_LOG_POSITION

Represents the state of an instance at any given point in time inside a binarylog file. If specified along with <--bin-log-file-name> to form a validbinary log coordinate, it defines an earlier point in time to clone a sourceinstance from. For example, 123 (a numeric value).

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

--point-in-time=POINT_IN_TIME

Represents the state of an instance at any given point in time inside atransaction log file. For MySQL, the binary log file is used for transactionlogs. For PostgreSQL, the write-ahead log file is used for transaction logs. ForSQL Server, the log backup file is used for such purpose. To create atransaction log, enable point-in-time recovery on the source instance. Instanceshould have transaction logs accumulated up to the point in time they want torestore up to. Uses RFC 3339 format in UTC timezone. If specified, defines apast state of the instance to clone. For example, '2012-11-15T16:19:00.094Z'.

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

--restore-database-name=RESTORE_DATABASE_NAME

The name of the database to be restored for a point-in-time restore. If set, thedestination instance will only restore the specified database.

Run$gcloud help for details.