Menu
Amazon ElastiCache
User Guide (API Version 2015-02-02)

Purchasing a Reserved Node

The following examples show how to purchase a reserved node offering using the AWS Management Console, the AWS CLI, and the ElastiCache API.

Important

Following the examples in this section will incur charges on your AWS account that you cannot reverse.

Purchasing a Reserved Node (Console)

This example shows purchasing a specific reserved node offering, 649fd0c8-cf6d-47a0-bfa6-060f8e75e95f, with a reserved node ID of myreservationID.

The following procedure uses the AWS Management Console to purchase the reserved node offering by offering id.

To purchase reserved nodes

  1. Sign in to the AWS Management Console and open the ElastiCache console at https://console.aws.amazon.com/elasticache/.

  2. In the navigation list, choose the Reserved Cache Nodes link.

  3. Choose the Purchase Reserved Cache Node button.

  4. Choose the node type from the Product Description drop-down list box.

  5. Choose the node class from the Cache Node Class drop-down list box.

  6. Choose length of time you want to reserve the node for from the Term drop-down list box.

  7. Do either one of the following:

    • Choose the offering type from the Offering Type drop-down list box.

    • Enter a reserved node ID in the Reserved Cache Node ID text box.

      Note

      The Reserved Cache Node ID is an unique customer-specified identifier to track this reservation. If this box is left blank, ElastiCache automatically generates an identifier for the reservation.

  8. Choose the Next button.

    The Purchase Reserved Cache Node dialog box shows a summary of the reserved node attributes that you've chosen and the payment due.

  9. Choose the Yes, Purchase button to proceed and purchase the reserved node.

    Important

    When you choose Yes, Purchase you incur the charges for the reserved nodes you selected. To avoid incurring these charges, choose Cancel.

Purchasing a Reserved Node (AWS CLI)

The following example shows purchasing the specific reserved cluster offering, 649fd0c8-cf6d-47a0-bfa6-060f8e75e95f, with a reserved node ID of myreservationID.

Type the following command at a command prompt:

For Linux, macOS, or Unix:

Copy
aws elasticache purchase-reserved-cache-nodes-offering \ --reserved-cache-nodes-offering-id 649fd0c8-cf6d-47a0-bfa6-060f8e75e95f \ --reserved-cache-node-id myreservationID

For Windows:

Copy
aws elasticache purchase-reserved-cache-nodes-offering ^ --reserved-cache-nodes-offering-id 649fd0c8-cf6d-47a0-bfa6-060f8e75e95f ^ --reserved-cache-node-id myreservationID

The command returns output similar to the following:

RESERVATION  ReservationId      Class           Start Time                Duration  Fixed Price  Usage Price  Count  State            Description      Offering Type
RESERVATION  myreservationid    cache.m1.small  2013-12-19T00:30:23.247Z  1y        455.00 USD   0.092 USD    1      payment-pending  memcached        Medium Utilization

For more information, see purchase-reserved-cache-nodes-offering in the AWS CLI Reference.

Purchasing a Reserved Node (ElastiCache API)

The following example shows purchasing the specific reserved node offering, 649fd0c8-cf6d-47a0-bfa6-060f8e75e95f, with a reserved cluster ID of myreservationID.

Call the PurchaseReservedCacheNodesOffering operation with the following parameters:

  • ReservedCacheNodesOfferingId = 649fd0c8-cf6d-47a0-bfa6-060f8e75e95f

  • ReservedCacheNodeID = myreservationID

  • CacheNodeCount = 1

Copy
https://elasticache.us-west-2.amazonaws.com/ ?Action=PurchaseReservedCacheNodesOffering &ReservedCacheNodesOfferingId=649fd0c8-cf6d-47a0-bfa6-060f8e75e95f &ReservedCacheNodeID=myreservationID &CacheNodeCount=1 &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20141201T220302Z &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Date=20141201T220302Z &X-Amz-SignedHeaders=Host &X-Amz-Expires=20141201T220302Z &X-Amz-Credential=<credential> &X-Amz-Signature=<signature>

This call returns output similar to the following:

<PurchaseReservedCacheNodesOfferingResponse xmlns="http://elasticache.us-west-2.amazonaws.com/doc/2013-06-15/">
  <PurchaseReservedCacheNodesOfferingResult>
    <ReservedCacheNode>
      <OfferingType>Medium Utilization</OfferingType>
      <CurrencyCode>USD</CurrencyCode>
      <RecurringCharges/>
      <ProductDescription>memcached</ProductDescription>
      <ReservedCacheNodesOfferingId>649fd0c8-cf6d-47a0-bfa6-060f8e75e95f</ReservedCacheNodesOfferingId>
      <State>payment-pending</State>
      <ReservedCacheNodeId>myreservationID</ReservedCacheNodeId>
      <CacheNodeCount>10</CacheNodeCount>
      <StartTime>2013-07-18T23:24:56.577Z</StartTime>
      <Duration>31536000</Duration>
      <FixedPrice>123.0</FixedPrice>
      <UsagePrice>0.123</UsagePrice>
      <CacheNodeType>cache.m1.small</CacheNodeType>
    </ReservedCacheNode>
  </PurchaseReservedCacheNodesOfferingResult>
  <ResponseMetadata>
    <RequestId>7f099901-29cf-11e1-bd06-6fe008f046c3</RequestId>
  </ResponseMetadata>
</PurchaseReservedCacheNodesOfferingResponse>

For more information, see PurchaseReservedCacheNodesOffering in the ElastiCache API Reference.