# Reading the service price list files Read the service price list files | | | --- | | To provide feedback about Amazon Price List, complete this [short survey](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA). Your responses will be anonymous. **Note:** This survey is in English only. | The service price list file lists the products and prices for a single Amazon Web Services service or Savings Plan in *all Amazon Web Services Regions* or a single Amazon Web Services service or Savings Plan in a *specific Region*. Service price list files are available in CSV or JSON format. To read the file, you can use a spreadsheet program to read and sort the CSV file or an application that parses the JSON file. **Note** In the CSV file, the product and pricing details are combined into one section. In the JSON file, the product details and pricing details are in separate sections. **Topics** + [ # Reading the service price list file for an Amazon Web Services service ](reading-service-price-list-file-for-services.md) + [ # Reading the service price list file for a Savings Plan ](reading-service-price-list-file-for-savings-plans.md) # Reading the service price list file for an Amazon Web Services service Read the service price list file for an Amazon Web Services service | | | --- | | To provide feedback about Amazon Price List, complete this [short survey](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA). Your responses will be anonymous. **Note:** This survey is in English only. | 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 files, such as format version 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 this service price list file **Contents** + [ ## CSV file ](#reading-service-price-list-file-csv) + [ ## JSON file ](#reading-service-price-list-file-json) + [ ## Term definitions ](#term-definitions) + [ ### OnDemand and Reserved term definition ](#on-demand-reserved-term-definition) + [ ### FlatRate term ](#flat-rate-term) + [ ## Service price list definitions ](#service-price-list-files-details) + [ ## Product details (products) definitions ](#product-details-terms) + [ ## Product details (terms) definitions ](#product-details-metadata) + [ ## OnDemand and Reserved definitions ](#ondemand-reserved-definitions) + [ ## FlatRate definitions ](#flatrate-definitions) ## CSV file The first five rows of the CSV file contain the metadata for the price list file. The sixth row has the column names for the products and their attributes, such as `SKU`, `OfferTermCode`, `RateCode`, `TermType`, and more. The number of columns depends on the service. The first few columns contain the pricing details, and other columns contain the product details for a service. ## JSON file The product details and pricing details are in separate sections. The same product can be offered under multiple terms, and the same term can apply to multiple products. For example, an Amazon Elastic Compute Cloud (Amazon EC2) instance is available for an `Hourly` or `Reserved` term. You can use the SKU of a product to identify the terms that are available for that product. **Example: General JSON structure** ``` { "formatVersion":"The version of the file format", "disclaimer":"The disclaimers for the price list file", "offerCode":"The code for the service", "version":"The version of the price list file", "publicationDate":"The publication date of the price list file", "products": { "sku": { "sku":"The SKU of the product", "productFamily":"The product family of the product", "attributes": { "attributeName":"attributeValue" } } }, "terms": TermDefinitions } ``` ## Term definitions Different term types have different structures within the terms object. ### OnDemand and Reserved term definition ``` { "OnDemand|Reserved": { "sku": { "sku.offerTermCode": { "offerTermCode":"The term code of the product", "sku":"The SKU of the product", "effectiveDate":"The effective date of the pricing details", "termAttributesType":"The attribute type of the terms", "termAttributes": { "attributeName":"attributeValue" }, "priceDimensions": { "rateCode": { "rateCode":"The rate code of the price", "description":"The description of the term", "unit":"The usage measurement unit for the price", "startingRange":"The start range for the term", "endingRange":"The end range for the term", "pricePerUnit": { "currencyCode":"currencyRate" } } } } } } } ``` ### FlatRate term ``` { "FlatRate": { "plans": [{ "planCode": "Plan identifier (for example, Free, Pro, Business)", "sku": "The SKU associated with this plan", "features": [{ "featureCode": "Unique feature identifier", "featureName": "Human-readable feature name", "usageQuota": { "value": "Usage limit (for quantitative features)", "unit": "Unit of measurement (for example, requests, GB)" } }], "subscriptionPrice": { "rateCode": "The rate code of the price", "description": "The description of the term", "pricePerUnit": { "currencyCode": "currencyRate" } } }] } } ``` ## Service price list definitions The following list defines the terms in the service price list files. **formatVersion** An attribute that tracks which format version the service price list file is in. The `formatVersion` of the file is updated when the structure is changed. For example, the version will change from `v1` to `v2`. **disclaimer** Any disclaimers that apply to the service price list file. **offerCode** A unique code for the product of an Amazon Web Services service. For example, `AmazonEC2` for Amazon EC2 or `AmazonS3` for Amazon S3. **version** An attribute that tracks the version of the service price list file. Each time a new file is published, it contains a new version number. For example, `20150409022205` and `20150910182105`. **publicationDate** The date and time in UTC format when a service price list file was published. For example, `2015-04-09T02:22:05Z` and `2015-09-10T18:21:05Z`. ## Product details (products) definitions This section provides information about products in a service price list file for an Amazon Web Services service. Products are indexed by SKU. **products: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 lists `HCNSHWWAJSGVAHMH` as a SKU. **products:sku:productFamily** The category for the type of product. For example, `compute` for Amazon EC2 or `storage` for Amazon S3. **products:sku:attributes** A list of all of the product attributes. **products:sku:attributes:Attribute Name** The name of a product attribute. For example, `Instance Type`, `Processor`, or `OS`. **products:sku:attributes:Attribute Value** The value of a product attribute. For example, `m1.small` (instance type), `xen` (type of processor), or `Linux` (type of OS). ## Product details (terms) definitions This section provides information about the prices for products in a service price list file for an Amazon Web Services service. Prices are indexed by the terms. **terms:termType** The specific type of term that a term definition describes. The valid term types are `Reserved`, `OnDemand`, and `FlatRate`. ## OnDemand and Reserved definitions In this section, `termType` refers to `OnDemand` or `Reserved`. **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 `HCNSHWWAJSGVAHMH` is available only for a price that also lists `HCNSHWWAJSGVAHMH` as a SKU. **terms:termType:sku:Offer Term Code** A unique code for a specific type of term. For example, `KCAKZHGHG`. Product and price combinations are referenced by the SKU code followed by the term code, separated by a period. For example, `U7ADXS4BEK5XXHRU.KCAKZHGHG`. **terms:termType:sku:Effective Date** 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:Term Attributes Type** A unique code for identifying what product and product offering are covered by a term. For example, an `EC2-Reserved` attribute type means that a term is available for Amazon EC2 reserved hosts. **terms:termType:sku:Term Attributes** A list of all of the attributes that are applicable to a term type. The format appears as `attribute-name: attribute-value`. For example, this can be the length of term and the type of purchase covered by the term. **terms:termType:sku:Term Attributes:Attribute Name** The name of a `TermAttribute`. You can use it to look up specific attributes. For example, you can look up terms by `length` or `PurchaseOption`. **terms:termType:sku:Term Attributes:Attribute Value** The value of a `TermAttribute`. For example, terms can have a length of one year and a purchase option of `All Upfront`. **terms:termType:sku:Price Dimensions** The pricing details for the price list file, such as how usage is measured, the currency that you can use to pay with, and the pricing tier limitations. **terms:termType:sku:Price Dimensions:Rate Code** A unique code for a product, offer, and pricing-tier combination. Product and term combinations can have multiple price dimensions, such as free tier, low use tier, and high use tier. **terms:termType:sku:Price Dimensions:Rate Code:Description** The description for a price or rate. **terms:termType:sku:Price Dimensions:Rate Code:Unit** The type of unit that each service uses to measure usage for billing. For example, Amazon EC2 uses hours, and Amazon S3 uses GB. **terms:termType:sku:Price Dimensions:Rate Code:Starting Range** The lower limit of the price tier covered by this price. For example, 0 GB or 1,001 API operation calls. **terms:termType:sku:Price Dimensions:Rate Code:Ending Range** The upper limit of the price tier covered by this price. For example, 1,000 GB or 10,000 API operation calls. **terms:termType:sku:Price Dimensions:Rate Code:Price Per Unit** A calculation of how much a single measured unit for a service costs. **terms:termType:sku:Price Dimensions:Rate Code:Price Per Unit:Currency Code** A code that indicates the currency for prices for a specific product. **terms:termType:sku:Price Dimensions:Rate Code:Price Per Unit:Currency Rate** The rate for a product in various supported currencies. For example, \$11.2536 per unit. ## FlatRate definitions In this section, `termType` refers to `FlatRate`. **terms:termType:plans** An array of flat-rate pricing plans available. Each plan represents a complete pricing tier with bundled features and fixed subscription cost. **terms:termType:plans:planCode** A unique identifier for the flat-rate plan (for examle, "Free", "Pro"). **terms:termType:plans:sku** The SKU associated with this specific plan. Links the plan to the corresponding product in the products section. **terms:termType:plans:features** An array of features included in the flat-rate plan. **terms:termType:plans:features:featureCode** A unique identifier for the feature (for example, "Requests", "DataTransfer", "S3Storage"). **terms:termType:plans:features:featureName** Human-readable name of the feature (for example, "Requests", "Data Transfer"). **terms:termType:plans:features:usageQuota** Usage limits for quantitative features. This object is optional and only present for features that have measurable limits. **terms:termType:plans:features:usageQuota:value** The numeric limit for the feature (for example, "1000000" for 1 million requests, "100" for 100 GB). **terms:termType:plans:features:usageQuota:unit** The unit of measurement for the usage limit (for example, "requests", "GB"). **terms:termType:plans:subscriptionPrice** The subscription pricing details for the flat-rate plan. **terms:termType:plans:subscriptionPrice:rateCode** A unique code for a product, offer, and pricing-tier combination. **terms:termType:plans:subscriptionPrice:Description** The description for a price or rate. **terms:termType:plans:subscriptionPrice:Price Per Unit** A calculation of how much a single measured unit for a service costs. **terms:termType:plans:subscriptionPrice:Price Per Unit:Currency Code** A code that indicates the currency for prices for a specific product. **terms:termType:plans:subscriptionPrice:Price Per Unit:Currency Rate** The rate for a product in various supported currencies (for example, \$11.2536 per unit). # Reading the service price list file for a Savings Plan Read the service price list file for a Savings Plan | | | --- | | To provide feedback about Amazon Price List, complete this [short survey](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA). Your responses will be anonymous. **Note:** This survey is in English only. | 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 ](#service-price-list-file-for-saving-plans-csv) + [ ## JSON file ](#service-price-list-file-for-saving-plans-json) + [ ## Service price list definitions ](#service-price-list-file-definitions-savings-plan) + [ ## Product details (products) definitions ](#service-price-list-file-definitions-products-savings-plan) + [ ## Pricing details (terms) definitions ](#service-price-list-file-definitions-terms-savings-plan) ## 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` and `20150910182105`. **publicationDate** The date and time in UTC format when a service price list file was published. For example, `2015-04-09T02:22:05Z` and `2015-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 lists `HCNSHWWAJSGVAHMH` 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`, or `Purchase Option`. **products:product:attributes:attributeValue** The value of a product attribute. For example, `m1.small` (instance type), Amazon Local Zone (type of location), or `No 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 lists `496KPMD8YQ8RZNC` 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`.