| « PreviousNext » | |
  | Did this page help you? Yes | No | Tell us about it... |
DescribeReservedCacheNodesOfferings
Description
Lists available reserved Cache Node offerings.
Request Parameters
For information about the common parameters that all actions use, see Common Parameters.
- CacheNodeType
The Cache Node type filter value. Specify this parameter to show only the available offerings matching the specified Cache Node type.
Type: String
Required: No
- Duration
Duration filter value, specified in years or seconds. Specify this parameter to show only reservations for this duration.
Valid Values:
1 | 3 | 31536000 | 94608000Type: String
Required: No
- Marker
The marker provided in the previous request. If this parameter is specified, the response includes records beyond the marker only, up to
MaxRecords.Type: String
Required: No
- MaxRecords
The maximum number of records to include in the response. If more than the
MaxRecordsvalue is available, a marker is included in the response so that the following results can be retrieved.Default: 100
Constraints: minimum 20, maximum 100
Type: Integer
Required: No
- OfferingType
The offering type filter value. Specify this parameter to show only the available offerings matching the specified offering type.
Valid Values:
"Light Utilization" | "Medium Utilization" | "Heavy Utilization"Type: String
Required: No
- ProductDescription
Product description filter value. Specify this parameter to show only the available offerings matching the specified product description.
Type: String
Required: No
- ReservedCacheNodesOfferingId
The offering identifier filter value. Specify this parameter to show only the available offering that matches the specified reservation identifier.
Example:
438012d3-4052-4cc7-b2e3-8d3372e0e706Type: String
Required: No
Response Elements
The following
elements are
returned in a DescribeReservedCacheNodesOfferingsResult structure.
- Marker
A marker provided for paginated results.
Type: String
- ReservedCacheNodesOfferings
A list of reserved Cache Node offerings.
Type: ReservedCacheNodesOffering list
Errors
For information about the errors that are common to all actions, see Common Errors.
- InvalidParameterCombination
HTTP Status Code: 400
- InvalidParameterValue
HTTP Status Code: 400
- ReservedCacheNodesOfferingNotFound
Specified offering does not exist.
HTTP Status Code: 404
Examples
Sample Request
https://elasticache.amazonaws.com/ ?Action=DescribeReservedCacheNodesOfferings &ReservedCacheNodesOfferingId=438012d3-4052-4cc7-b2e3-8d3372e0e706 &SignatureVersion=2 &SignatureMethod=HmacSHA256 &Timestamp=2011-12-18T18%3A31%3A36.118Z &AWSAccessKeyId=<AWS Access Key ID> &Signature=<Signature>
Sample Response
<DescribeReservedCacheNodesOfferingsResponse xmlns="http://elasticache.amazonaws.com/doc/2012-11-15/">
<DescribeReservedCacheNodesOfferingsResult>
<ReservedCacheNodesOfferings>
<ReservedCacheNodesOffering>
<Duration>31536000</Duration>
<OfferingType>Heavy Utilization</OfferingType>
<RecurringCharges>
<RecurringCharge>
<RecurringChargeFrequency>Hourly</RecurringChargeFrequency>
<RecurringChargeAmount>0.123</RecurringChargeAmount>
</RecurringCharge>
</RecurringCharges>
<FixedPrice>162.0</FixedPrice>
<ProductDescription>memcached</ProductDescription>
<UsagePrice>0.0</UsagePrice>
<ReservedCacheNodesOfferingId>SampleOfferingId</ReservedCacheNodesOfferingId>
<CacheNodeType>cache.m1.small</CacheNodeType>
</ReservedCacheNodesOffering>
</ReservedCacheNodesOfferings>
</DescribeReservedCacheNodesOfferingsResult>
<ResponseMetadata>
<RequestId>521b420a-2961-11e1-bd06-6fe008f046c3</RequestId>
</ResponseMetadata>
</DescribeReservedCacheNodesOfferingsResponse>
