EnableSnapshotCopy - Amazon Redshift
AWS services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with AWS services in China.


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 AWS Region that you want to copy snapshots to.

Constraints: Must be the name of a valid AWS 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 newly copied snapshots in the destination AWS Region after they are copied from the source AWS Region. If the value is -1, the manual snapshot is retained indefinitely.

The value must be either -1 or an integer between 1 and 3,653.

Type: Integer

Required: No


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 retention period specified is either in the past or is not a valid value.

The value must be either -1 or an integer between 1 and 3,653.

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


Sample Request

https://redshift.us-east-2.amazonaws.com/ ?Action=EnableSnapshotCopy &ClusterIdentifier=mycluster &DestinationRegion=us-east-1 &SignatureMethod=HmacSHA256&SignatureVersion=4 &Version=2012-12-01 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20190817/us-east-2/redshift/aws4_request &X-Amz-Date=20190825T160000Z &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date &X-Amz-Signature=0aa1234bb5cc678ddddd901ee2ff3aa45678b90c12d345e6ff789012345a6b7b

Sample Response

<EnableSnapshotCopyResponse xmlns="http://redshift.amazonaws.com/doc/2012-12-01/"> <EnableSnapshotCopyResult> <Cluster> <AllowVersionUpgrade>true</AllowVersionUpgrade> <ClusterIdentifier>mycluster</ClusterIdentifier> <NumberOfNodes>1</NumberOfNodes> <AvailabilityZone>us-east-2a</AvailabilityZone> <ClusterVersion>1.0</ClusterVersion> <ExpectedNextSnapshotScheduleTimeStatus>OnTrack</ExpectedNextSnapshotScheduleTimeStatus> <ManualSnapshotRetentionPeriod>-1</ManualSnapshotRetentionPeriod> <ClusterAvailabilityStatus>Available</ClusterAvailabilityStatus> <Endpoint> <Port>5439</Port> <Address>mycluster.cmeaswqeuae.us-east-2.redshift.amazonaws.com</Address> </Endpoint> <VpcId>vpc-a1abc1a1</VpcId> <PubliclyAccessible>true</PubliclyAccessible> <ClusterCreateTime>2019-12-27T17:48:01.504Z</ClusterCreateTime> <ClusterSnapshotCopyStatus> <ManualSnapshotRetentionPeriod>-1</ManualSnapshotRetentionPeriod> <DestinationRegion>us-east-1</DestinationRegion> <RetentionPeriod>7</RetentionPeriod> </ClusterSnapshotCopyStatus> <MasterUsername>adminuser</MasterUsername> <DBName>dev</DBName> <EnhancedVpcRouting>false</EnhancedVpcRouting> <IamRoles/> <ClusterSecurityGroups/> <ExpectedNextSnapshotScheduleTime>2019-12-28T05:48:20.939Z</ExpectedNextSnapshotScheduleTime> <NodeType>dc2.large</NodeType> <ClusterSubnetGroupName>default</ClusterSubnetGroupName> <NextMaintenanceWindowStartTime>2019-12-29T05:30:00Z</NextMaintenanceWindowStartTime> <DeferredMaintenanceWindows/> <Tags> <Tag> <Value>newtag</Value> <Key>mytag</Key> </Tag> </Tags> <VpcSecurityGroups> <VpcSecurityGroup> <VpcSecurityGroupId>sh-a1a123ab</VpcSecurityGroupId> <Status>active</Status> </VpcSecurityGroup> </VpcSecurityGroups> <ClusterParameterGroups> <ClusterParameterGroup> <ParameterGroupName>default.redshift-1.0</ParameterGroupName> <ParameterApplyStatus>in-sync</ParameterApplyStatus> </ClusterParameterGroup> </ClusterParameterGroups> <Encrypted>false</Encrypted> <MaintenanceTrackName>current</MaintenanceTrackName> <PendingModifiedValues/> <PreferredMaintenanceWindow>sun:05:30-sun:06:00</PreferredMaintenanceWindow> <AutomatedSnapshotRetentionPeriod>1</AutomatedSnapshotRetentionPeriod> <ClusterStatus>available</ClusterStatus> </Cluster> </EnableSnapshotCopyResult> <ResponseMetadata> <RequestId>76c22d87-28da-11ea-8314-974e2ba81189</RequestId> </ResponseMetadata> </EnableSnapshotCopyResponse>

See Also

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