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

Purchasing a Reserved Node

The following example shows how to purchase a reserved node offering.

Important

Following the examples in this section will incur charges on your AWS account.

Purchasing a Reserved Node (Console)

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

  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 cache node type from the Product Description drop-down list box.

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

  6. Choose length of time you want the cache node reserved from the Term drop-down list box.

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

  8. You can optionally enter a reserved cache 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.

  9. Choose the Next button.

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

  10. Choose the Yes, Purchase button to proceed and purchase the reserved cache 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 a specific reserved cluster offering, 649fd0c8-cf6d-47a0-bfa6-060f8e75e95f, with a reserved cluster 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:

Copy
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

Purchasing a Reserved Node (ElastiCache API)

The following example shows purchasing a specific reserved cluster 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:

Copy
<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>