Amazon Redshift
API Reference (API Version 2012-12-01)


Enables the automatic copy of snapshots from one region to another region for a specified cluster.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.


The unique identifier of the source cluster to copy snapshots from.

Constraints: Must be the valid name of an existing cluster that does not already have cross-region snapshot copy enabled.

Type: String

Required: Yes


The destination region that you want to copy snapshots to.

Constraints: Must be the name of a valid region. For more information, see Regions and Endpoints in the Amazon Web Services General Reference.

Type: String

Required: Yes


The number of days to retain automated snapshots in the destination region after they are copied from the source region.

Default: 7.

Constraints: Must be at least 1 and no more than 35.

Type: Integer

Required: No


The name of the snapshot copy grant to use when snapshots of an AWS KMS-encrypted cluster are copied to the destination region.

Type: String

Required: No

Response Elements

The following element is returned by the service.


Describes a cluster.

Type: Cluster object


For information about the errors that are common to all actions, see Common Errors.


The ClusterIdentifier parameter does not refer to an existing cluster.

HTTP Status Code: 404


Cross-region snapshot copy was temporarily disabled. Try your request again.

HTTP Status Code: 400


The request cannot be completed because a dependent service is throttling requests made by Amazon Redshift on your behalf. Wait and retry the request.

HTTP Status Code: 400


The specified options are incompatible.

HTTP Status Code: 400


The specified cluster is not in the available state.

HTTP Status Code: 400


The encryption key has exceeded its grant limit in AWS KMS.

HTTP Status Code: 400


The cluster already has cross-region snapshot copy enabled.

HTTP Status Code: 400


The specified snapshot copy grant can't be found. Make sure that the name is typed correctly and that the grant exists in the destination region.

HTTP Status Code: 400


Your account is not authorized to perform the requested operation.

HTTP Status Code: 400


The specified region is incorrect or does not exist.

HTTP Status Code: 404

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: