Request Syntax Request Parameters Response Syntax Response Elements Errors See Also

DescribeReservedNodesOfferings

Lists available reserved node offerings.

Request Syntax


{
   "Duration": "string",
   "MaxResults": number,
   "NextToken": "string",
   "NodeType": "string",
   "OfferingType": "string",
   "ReservedNodesOfferingId": "string"
}

Request Parameters

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

The request accepts the following data in JSON format.

Duration

Duration filter value, specified in years or seconds. Use this parameter to show only reservations for a given duration.

Type: String

Required: No

MaxResults

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

Type: Integer

Required: No

NextToken

An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

Type: String

Required: No

NodeType

The node type for the reserved nodes. For more information, see Supported node types.

Type: String

Required: No

OfferingType

The offering type filter value. Use this parameter to show only the available offerings matching the specified offering type. Valid values: "All Upfront"|"Partial Upfront"| "No Upfront"

Type: String

Required: No

ReservedNodesOfferingId

The offering identifier filter value. Use this parameter to show only the available offering that matches the specified reservation identifier.

Type: String

Required: No

Response Syntax


{
   "NextToken": "string",
   "ReservedNodesOfferings": [ 
      { 
         "Duration": number,
         "FixedPrice": number,
         "NodeType": "string",
         "OfferingType": "string",
         "RecurringCharges": [ 
            { 
               "RecurringChargeAmount": number,
               "RecurringChargeFrequency": "string"
            }
         ],
         "ReservedNodesOfferingId": "string"
      }
   ]
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

NextToken

Type: String

ReservedNodesOfferings

Lists available reserved node offerings.

Type: Array of ReservedNodesOffering objects

Errors

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

InvalidParameterCombinationException

HTTP Status Code: 400

InvalidParameterValueException

HTTP Status Code: 400

ReservedNodesOfferingNotFoundFault

The requested node offering does not exist.

HTTP Status Code: 400

ServiceLinkedRoleNotFoundFault

HTTP Status Code: 400