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

BatchModifyClusterSnapshots

Modifies the settings for a list of snapshots.

Request Parameters

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

SnapshotIdentifierList.String.N

A list of snapshot identifiers you want to modify.

Type: Array of strings

Required: Yes

Force

A boolean value indicating whether to override an exception if the retention period has passed.

Type: Boolean

Required: No

ManualSnapshotRetentionPeriod

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

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

If you decrease the manual snapshot retention period from its current value, existing manual snapshots that fall outside of the new retention period will return an error. If you want to suppress the errors and delete the snapshots, use the force option.

Type: Integer

Required: No

Response Elements

The following elements are returned by the service.

Errors.SnapshotErrorMessage.N

A list of any errors returned.

Type: Array of SnapshotErrorMessage objects

Resources.String.N

A list of the snapshots that were modified.

Type: Array of strings

Errors

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

BatchModifyClusterSnapshotsLimitExceededFault

The maximum number for snapshot identifiers has been reached. The limit is 100.

HTTP Status Code: 400

InvalidRetentionPeriodFault

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: