Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

DescribeSnapshotSchedules - Amazon Redshift

DescribeSnapshotSchedules

Returns a list of snapshot schedules.

Request Parameters

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

ClusterIdentifier

The unique identifier for the cluster whose snapshot schedules you want to view.

Type: String

Length Constraints: Maximum length of 2147483647.

Required: No

Marker

A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the marker parameter and retrying the command. If the marker field is empty, all response records have been retrieved for the request.

Type: String

Length Constraints: Maximum length of 2147483647.

Required: No

MaxRecords

The maximum number or response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

Type: Integer

Required: No

ScheduleIdentifier

A unique identifier for a snapshot schedule.

Type: String

Length Constraints: Maximum length of 2147483647.

Required: No

TagKeys.TagKey.N

The key value for a snapshot schedule tag.

Type: Array of strings

Length Constraints: Maximum length of 2147483647.

Required: No

TagValues.TagValue.N

The value corresponding to the key of the snapshot schedule tag.

Type: Array of strings

Length Constraints: Maximum length of 2147483647.

Required: No

Response Elements

The following elements are returned by the service.

Marker

A value that indicates the starting point for the next set of response records in a subsequent request. If a value is returned in a response, you can retrieve the next set of records by providing this returned marker value in the marker parameter and retrying the command. If the marker field is empty, all response records have been retrieved for the request.

Type: String

Length Constraints: Maximum length of 2147483647.

SnapshotSchedules.SnapshotSchedule.N

A list of SnapshotSchedules.

Type: Array of SnapshotSchedule objects

Errors

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

Examples

Example

This example illustrates one usage of DescribeSnapshotSchedules.

Sample Request

https://redshift.us-east-2.amazonaws.com/ ?Action=DescribeSnapshotSchedules &ClusterIdentifier=mycluster &ScheduleIdentifier=mysnapshotschedule &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

<DescribeSnapshotSchedulesResponse xmlns="http://redshift.amazonaws.com/doc/2012-12-01/"> <DescribeSnapshotSchedulesResult> <SnapshotSchedules> <SnapshotSchedule> <ScheduleDefinitions> <ScheduleDefinition>rate(12 hours)</ScheduleDefinition> </ScheduleDefinitions> <ScheduleDescription>My schedule description</ScheduleDescription> <AssociatedClusterCount>1</AssociatedClusterCount> <AssociatedClusters> <ClusterAssociatedToSchedule> <ScheduleAssociationState>ACTIVE</ScheduleAssociationState> <ClusterIdentifier>mycluster</ClusterIdentifier> </ClusterAssociatedToSchedule> </AssociatedClusters> <ScheduleIdentifier>mysnapshotschedule</ScheduleIdentifier> <Tags/> </SnapshotSchedule> </SnapshotSchedules> </DescribeSnapshotSchedulesResult> <ResponseMetadata> <RequestId>65030ae0-28d3-11ea-9caa-c956bec1ce87</RequestId> </ResponseMetadata> </DescribeSnapshotSchedulesResponse>

See Also

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

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.