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

DescribeNodeConfigurationOptions

Returns properties of possible node configurations such as node type, number of nodes, and disk usage for the specified action type.

Request Parameters

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

ActionType

The action type to evaluate for possible node configurations. Specify "restore-cluster" to get configuration combinations based on an existing snapshot. Specify "recommend-node-config" to get configuration recommendations based on an existing cluster or snapshot.

Type: String

Valid Values: restore-cluster | recommend-node-config

Required: Yes

ClusterIdentifier

The identifier of the cluster to evaluate for possible node configurations.

Type: String

Required: No

Filter.NodeConfigurationOptionsFilter.N

A set of name, operator, and value items to filter the results.

Type: Array of NodeConfigurationOptionsFilter objects

Required: No

Marker

An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeNodeConfigurationOptions request exceed the value specified in MaxRecords, AWS returns a value in the Marker field of the response. 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

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.

Default: 500

Constraints: minimum 100, maximum 500.

Type: Integer

Required: No

OwnerAccount

The AWS customer account used to create or copy the snapshot. Required if you are restoring a snapshot you do not own, optional if you own the snapshot.

Type: String

Required: No

SnapshotIdentifier

The identifier of the snapshot to evaluate for possible node configurations.

Type: String

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

NodeConfigurationOptionList.NodeConfigurationOption.N

A list of valid node configurations.

Type: Array of NodeConfigurationOption objects

Errors

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

AccessToSnapshotDenied

The owner of the specified snapshot has not authorized your account to access the snapshot.

HTTP Status Code: 400

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

InvalidClusterSnapshotState

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

HTTP Status Code: 400

See Also

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