Reading the service price list file for a Savings Plan
Note
To provide feedback about Amazon Price List, complete this short survey
The service price list files for an Amazon Web Services service includes the following types of information:
-
Service price list file details – Metadata about the service price list file, such as the version, Amazon Web Services Region, and publication date
-
Product details – Product metadata that lists the products in a service price list file along with product information
-
Pricing details (terms) – Prices for all products in the service price list file
Contents
CSV file
The first five rows of the CSV file are the metadata for the price list file. The sixth
row has the column names for the products and their attributes, such as
SKU
, RateCode
, and more.
The number of columns varies depends on the Savings Plan. The first few columns contain the pricing details, while other columns contain the product details for a Savings Plan.
JSON file
The product details and pricing details are in separate sections. A JSON service price list file looks like the following example.
{ "version" : "The version of the price list file", "publicationDate" : "The publication date of the price list file", "regionCode" : "Region for which price list file is valid for", "products" : [ { "sku" : "The SKU of the product", "productFamily" : "The product family of the product", "serviceCode" : "Savings plan code", "attributes" : { "attributeName":"attributeValue", } }, ... ], "terms" : { "savingsPlan" : [ { "sku" : "The SKU of the product", "description" : "Description of the product", "effectiveDate" : "The effective date of the pricing details", "leaseContractLength" : { "duration" : "Length of the lease contract - it is a number", "unit" : "Unit of the duration" }, "rates" : [ { "discountedSku" : "The SKU of the discounted on demand product", "discountedUsageType" : "Usage type of the discounted product", "discountedOperation" : "Operation of the discounted product", "discountedServiceCode" : "Service code of the discounted product", "rateCode" : "The rate code of this price detail", "unit" : "Unit used to measure usage of the product", "discountedRate" : { "price" : "Price of the product", "currency" : "Currency of the price" } }, ... ] }, ... ] } }
Service price list definitions
The following list defines the terms in the service price list files.
- regionCode
-
The Region code of the Region for which the price list is valid for.
- version
-
An attribute that tracks the version of the price list file. Each time a new file is published, it contains a new version number. For example,
20150409022205
and20150910182105
. - publicationDate
-
The date and time in UTC format when a service price list file was published. For example,
2015-04-09T02:22:05Z
and2015-09-10T18:21:05Z
.
Product details (products) definitions
This section provides information about products in a price list file for a Savings Plan. Products are indexed by SKU.
- products:product:sku
-
A unique code for a product. Use the
SKU
code to correlate product details and pricing.For example, a product with a SKU of
HCNSHWWAJSGVAHMH
is available only for a price that also listsHCNSHWWAJSGVAHMH
as a SKU. - products:product:productFamily
-
The category for the type of product. For example,
EC2InstanceSavingsPlans
for Compute Savings Plans. - products:product:serviceCode
-
The service code of the Savings Plan. For example,
ComputeSavingsPlans
. - products:product:attributes
-
A list of all product attributes.
- products:product:attributes:attributeName
-
The name of a product attribute. For example,
Instance Type
,Location Type
, orPurchase Option
. - products:product:attributes:attributeValue
-
The value of a product attribute. For example,
m1.small
(instance type), Amazon Local Zone (type of location), orNo Upfront
(type of purchase option).
Pricing details (terms) definitions
This section provides information about the prices for products in a price list file for a Savings Plan.
Prices are indexed first by the terms (savingsPlan
).
- terms:termType
-
The specific type of term that a term definition describes. The valid term type is
savingsPlan
. - terms:termType:sku
-
A unique code for a product. Use the
SKU
code to correlate product details and pricing.For example, a product with a SKU of
T496KPMD8YQ8RZNC
is available only for a price that also lists496KPMD8YQ8RZNC
as a SKU. - terms:termType:sku:description
-
The description of the product.
- terms:termType:sku:effectiveDate
-
The date that an service price list file goes into effect. For example, if a term has an
EffectiveDate
of November 1, 2017, the price isn't valid before that date. - terms:termType:sku:leaseContractLength:duration
-
The length of the lease contract. This value is a number. For example, 1 or 3.
- terms:termType:sku:rates
-
A list all of the discounted rates that are applicable to a Savings Plan product. One Savings Plan product is a combination of multiple products from other services and this contains multiple rates for the combination.
- terms:termType:sku:rates:discountedSku
-
The SKU of the discounted on demand product.
- terms:termType:sku:rates:discountedUsageType
-
The usage type of the discounted on-demand product.
- terms:termType:sku:rates:discountedOperation
-
The operation of the discounted on-demand product.
- terms:termType:sku:rates:discountedServiceCode
-
The service code of the discounted on-demand product.
- terms:termType:sku:rates:rateCode
-
The rate code of this rate offered under the Savings Plan product. For example,
T496KPMD8YQ8RZNC.26PW7ZDSYZZ6YBTZ
- terms:termType:sku:rates:unit
-
The unit used to measure usage of the product. For example,
Hrs
for an Amazon EC2 instance. - terms:termType:sku:rates:discountedRate:price
-
The price of the offered discounted product under Savings Plan product. For example,
3.434
. - terms:termType:sku:rates:discountedRate:currency
-
The currency of the price of the offered discounted product under a Savings Plan product. For example,
USD
.