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 theMaxRecords
parameter. You can retrieve the next set of response records by providing the returned marker value in theMarker
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 aMarker
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: