Amazon Redshift
API Reference (API Version 2012-12-01)
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.


Modifies the settings for a snapshot.

Request Parameters

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


The identifier of the snapshot whose setting you want to modify.

Type: String

Required: Yes


A Boolean option to override an exception if the retention period has already passed.

Type: Boolean

Required: No


The number of days that a manual snapshot is retained. If the value is -1, the manual snapshot is retained indefinitely.

If the manual snapshot falls outside of the new retention period, you can specify the force option to immediately delete the snapshot.

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

Type: Integer

Required: No

Response Elements

The following element is returned by the service.


Describes a snapshot.

Type: Snapshot object


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


The snapshot identifier does not refer to an existing cluster snapshot.

HTTP Status Code: 404


The specified cluster snapshot is not in the available state, or other accounts are authorized to access the snapshot.

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

See Also

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