GetReservedNodeExchangeConfigurationOptions - Amazon Redshift

GetReservedNodeExchangeConfigurationOptions

Gets the configuration options for the reserved-node exchange. These options include information about the source reserved node and target reserved node offering. Details include the node type, the price, the node count, and the offering type.

Request Parameters

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

ActionType

The action type of the reserved-node configuration. The action type can be an exchange initiated from either a snapshot or a resize.

Type: String

Valid Values: restore-cluster | resize-cluster

Required: Yes

ClusterIdentifier

The identifier for the cluster that is the source for a reserved-node exchange.

Type: String

Length Constraints: Maximum length of 2147483647.

Required: No

Marker

An optional pagination token provided by a previous GetReservedNodeExchangeConfigurationOptions request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by the MaxRecords parameter. You can retrieve the next set of response records by providing the returned marker value in the Marker parameter and retrying the request.

Type: String

Length Constraints: Maximum length of 2147483647.

Required: No

MaxRecords

The maximum number of 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

SnapshotIdentifier

The identifier for the snapshot that is the source for the reserved-node exchange.

Type: String

Length Constraints: Maximum length of 2147483647.

Required: No

Response Elements

The following elements are returned by the service.

Marker

A pagination token provided by a previous GetReservedNodeExchangeConfigurationOptions request.

Type: String

Length Constraints: Maximum length of 2147483647.

ReservedNodeConfigurationOptionList.ReservedNodeConfigurationOption.N

the configuration options for the reserved-node exchange. These options include information about the source reserved node and target reserved node. Details include the node type, the price, the node count, and the offering type.

Type: Array of ReservedNodeConfigurationOption objects

Errors

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

ClusterNotFound

The ClusterIdentifier parameter does not refer to an existing cluster.

HTTP Status Code: 404

ClusterSnapshotNotFound

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

HTTP Status Code: 404

DependentServiceUnavailableFault

Your request cannot be completed because a dependent internal service is temporarily unavailable. Wait 30 to 60 seconds and try again.

HTTP Status Code: 400

InvalidReservedNodeState

Indicates that the Reserved Node being exchanged is not in an active state.

HTTP Status Code: 400

ReservedNodeAlreadyMigrated

Indicates that the reserved node has already been exchanged.

HTTP Status Code: 400

ReservedNodeNotFound

The specified reserved compute node not found.

HTTP Status Code: 404

ReservedNodeOfferingNotFound

Specified offering does not exist.

HTTP Status Code: 404

UnsupportedOperation

The requested operation isn't supported.

HTTP Status Code: 400

See Also

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