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

PurchaseReservedNodeOffering

Allows you to purchase reserved nodes. Amazon Redshift offers a predefined set of reserved node offerings. You can purchase one or more of the offerings. You can call the DescribeReservedNodeOfferings API to obtain the available reserved node offerings. You can call this API by providing a specific reserved node offering and the number of nodes you want to reserve.

For more information about reserved node offerings, go to Purchasing Reserved Nodes in the Amazon Redshift Cluster Management Guide.

Request Parameters

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

ReservedNodeOfferingId

The unique identifier of the reserved node offering you want to purchase.

Type: String

Required: Yes

NodeCount

The number of reserved nodes that you want to purchase.

Default: 1

Type: Integer

Required: No

Response Elements

The following element is returned by the service.

ReservedNode

Describes a reserved node. You can call the DescribeReservedNodeOfferings API to obtain the available reserved node offerings.

Type: ReservedNode object

Errors

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

ReservedNodeAlreadyExists

User already has a reservation with the given identifier.

HTTP Status Code: 404

ReservedNodeOfferingNotFound

Specified offering does not exist.

HTTP Status Code: 404

ReservedNodeQuotaExceeded

Request would exceed the user's compute node quota. For information about increasing your quota, go to Limits in Amazon Redshift in the Amazon Redshift Cluster Management Guide.

HTTP Status Code: 400

UnsupportedOperation

The requested operation isn't supported.

HTTP Status Code: 400

Example

Sample Request

https://redshift.us-east-1.amazonaws.com/
   ?Action=PurchaseReservedNodeOffering
   &ReservedNodeOfferingId=3a98bf7d-979a-49cc-b568-18f24315baf0
   &NodeCount=2
   &Version=2012-12-01
   &x-amz-algorithm=AWS4-HMAC-SHA256
   &x-amz-credential=AKIAIOSFODNN7EXAMPLE/20130117/us-east-1/redshift/aws4_request
   &x-amz-date=20130117T232351Z
   &x-amz-signedheaders=content-type;host;x-amz-date

Sample Response

<PurchaseReservedNodeOfferingResponse xmlns="http://redshift.amazonaws.com/doc/2012-12-01/">
  <PurchaseReservedNodeOfferingResult>
    <ReservedNode>
      <StartTime>2013-01-18T21:42:44.402Z</StartTime>
      <OfferingType>Heavy Utilization</OfferingType>
      <Duration>94608000</Duration>
      <RecurringCharges>
        <RecurringCharge>
          <RecurringChargeFrequency>Hourly</RecurringChargeFrequency>
          <RecurringChargeAmount>0.21</RecurringChargeAmount>
        </RecurringCharge>
      </RecurringCharges>
      <FixedPrice>12452.0</FixedPrice>
      <UsagePrice>0.0</UsagePrice>
      <State>payment-pending</State>
      <NodeType>ds2.8xlarge</NodeType>
      <NodeCount>2</NodeCount>
      <ReservedNodeId>1ba8e2e3-dacf-48d9-841f-cc675182a8a6</ReservedNodeId>
    </ReservedNode>
  </PurchaseReservedNodeOfferingResult>
  <ResponseMetadata>
    <RequestId>fcb117cc-61b7-11e2-b6e9-87e586e4ca38</RequestId>
  </ResponseMetadata>
</PurchaseReservedNodeOfferingResponse>

See Also

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