# Getting price list files using the AWS Price List Bulk API Getting price list files | | | --- | | To provide feedback about AWS 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. | We recommend that you use the Price List Bulk API when you want to do the following tasks: + Consume large amounts of product and pricing information for AWS services. + Consume product and pricing information with a high throughput for an AWS service, such as processing in bulk. Also, when the Price List Query API doesn't provide sufficient throughput and quotas for your use case, use the Price List Bulk API.Get price list files We recommend that you use the AWS Price List Bulk API to find and download price list files programmatically. To get the URL of the price list files, see the following steps. If you don't want to use the AWS Price List Bulk API, you can download the price list files manually. For more information, see [Getting price list files manually](using-the-aws-price-list-bulk-api-fetching-price-list-files-manually.md). ### Step 1: Finding available AWS services Step 1: Find available AWS services Use the `DescribeServices` API operation to find all available AWS services that the Price List Bulk API supports. This API operation returns the `ServiceCode` value from the list of services. You use this value later to find relevant price list files. **Example: Find available services** The following command shows how to find available AWS services. ``` aws pricing describe-services --region us-east-1 ``` The AWS Region is the API endpoint for the Price List Bulk API. The endpoints aren't related to product or service attributes. **Response** ``` { "FormatVersion": "aws_v1", "NextToken": "abcdefg123", "Services": [ { "AttributeNames": [ "volumeType", "maxIopsvolume", "instanceCapacity10xlarge", "locationType", "operation" ], "ServiceCode": "AmazonEC2" }, { "AttributeNames": [ "productFamily", "volumeType", "engineCode", "memory" ], "ServiceCode": "AmazonRDS" }, {...} ] } ``` For more information about this API operation, see [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html) and [language-specific AWS SDKs](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html#API_pricing_DescribeServices_SeeAlso) in the *AWS Billing and Cost Management API Reference* **Note** While the `DescribeServices` API currently doesn't return `serviceCodes` for Savings Plans, you will need the following `serviceCodes` to use Savings Plans in subsequent API calls: | ServiceCode | SavingsPlanCode | | --- | --- | | ComputeSavingsPlans | AWSComputeSavingsPlan | | MachineLearningSavingsPlans | AWSMachineLearningSavingsPlans | | DatabaseSavingsPlans | AWSDatabaseSavingsPlans | Use the `ServiceCode` values when working with the `ListPriceLists` and `GetPriceListFileUrl` API operations. The `SavingsPlanCode` is only needed if you are downloading price list files manually instead of using the APIs. ### Step 2: Finding price list files for an available AWS service Step 2: Find price list files for an available AWS service Use the `ListPriceLists` API operation to get a list of price list references that you have permission to view. To filter your results, you can specify the `ServiceCode`, `CurrencyCode`, and `EffectiveDate` parameters. The AWS Region is the API endpoint for the Price List Bulk API. The endpoints aren't related to product or service attributes. #### Examples to find price list files **Example: Find price list files for all AWS Regions** If you don't specify the `--region-code` parameter, the API operation returns price list file references from all available AWS Regions. ``` aws pricing list-price-lists --service-code AmazonRDS --currency-code USD --effective-date "2023-04-03 00:00" ``` **Response** ``` { "NextToken": "abcd1234", "PriceLists": [ { "CurrencyCode": "USD", "FileFormats": [ "json", "csv" ], "PriceListArn": "arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-east-1", "RegionCode": "us-east-1" }, { "CurrencyCode": "USD", "FileFormats": [ "json", "csv" ], "PriceListArn": "arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-west-2", "RegionCode": "us-west-2" }, ... ] } ``` **Example: Find price list files for a specific Region** If you specify the `RegionCode` parameter, the API operation returns price list file references that are specific to that Region. To find historical price list files, use the `EffectiveDate` parameter. For example, you can specify a date in the past to find a specific price list file. From the response, you can then use the `PriceListArn` value with the [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html) API operation to get your preferred price list files. ``` aws pricing list-price-lists --service-code AmazonRDS --currency-code USD --region-code us-west-2 --effective-date "2023-04-03 00:00" ``` **Response** ``` { "PriceLists": [ { "CurrencyCode": "USD", "FileFormats": [ "json", "csv" ], "PriceListArn": "arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-west-2", "RegionCode": "us-west-2" } ] } ``` For more information about this API operation, see [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html) and [language-specific AWS SDKs](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html#API_pricing_ListPriceLists_SeeAlso) in the *AWS Billing and Cost Management API Reference*. ### Step 3: Getting a specific price list file Step 3: Get a specific price list file Use the `GetPriceListFileUrl` API operation to get a URL for a price list file. This URL is based on the `PriceListArn` and `FileFormats` values that you retrieved from the `ListPriceLists` response in [step 1](#price-bulk-api-step-1-find-available-services) and [step 2](#price-list-bulk-api-step-2-find-available-price-list-files) **Example: Get a specific price list file** The following command gets the URL for a specific price list file for Amazon RDS. ``` aws pricing get-price-list-file-url --price-list-arn arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-east-1 --file-format json --region us-east-1 ``` **Response** ``` { "Url": "https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/20230328234721/us-east-1/index.json" } ``` From the response, you can use the URL to download the price list file. For more information about this API operation, see the following topics: + [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html) and [language-specific AWS SDKs](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html#API_pricing_GetPriceListFileUrl_SeeAlso) in the *AWS Billing and Cost Management API Reference* + [Reading the price list files](bulk-api-reading-price-list-files.md) # Getting price list files manually Get price list files manually | | | --- | | To provide feedback about AWS 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. | We recommend that you use the AWS Price List Bulk API to find and download price list files programmatically. For more information, see [Step 1: Finding available AWS services](using-the-aws-price-list-bulk-api.md#price-bulk-api-step-1-find-available-services). If you don't want to use the AWS Price List Bulk API, you can download the price list files manually. You can skip to the relevant topics if you already have the information that you need. **Topics** ## Step 1: Finding available AWS services Step 1: Find available AWS services | | | --- | | To provide feedback about AWS 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. | You can use the service index file to find available AWS services and Savings Plans that are provided by the AWS Price List Bulk API. To download the service index file, navigate to the following URL. ``` https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/index.json ``` In the service index file, you can search for the service to find its prices. To download the service-specific price list file, use either the `offerCode` or `serviceCode`. For more information, see the following topics: + [Reading the service index file](bulk-api-reading-price-list-files.md#reading-service-index-files) + [Step 1: Finding available AWS services](using-the-aws-price-list-bulk-api.md#price-bulk-api-step-1-find-available-services) ## Step 2: Finding available versions for an AWS service Step 2: Find available versions for an AWS service | | | --- | | To provide feedback about AWS 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. | For an AWS service or Savings Plan that you retrieved in [step 1](#fetching-price-list-manually-step-1), you can find all the historical versions of the price lists by using the [service version index file](using-the-aws-price-list-bulk-api-reading-price-list-files-reading-service-version-index-file.md). To download the service version index file, use the `serviceCode` or `savingsPlanCode`. To find the values for `serviceCode` and `savingsPlanCode`, see [Step 1: Finding available AWS services](using-the-aws-price-list-bulk-api.md#price-bulk-api-step-1-find-available-services). To download the service version index file for an AWS service, navigate to the following URL. Replace ** with your own information. ``` https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws//index.json ``` For example, Amazon Elastic Compute Cloud (Amazon EC2) appears in a URL like the following URL. ``` https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonEC2/index.json ``` **Note** In addition to the versions available in the service version index file, there is another version named `current`. The `current` version points to the latest version of the price list files for a specific AWS service. To download the latest service version index file for Savings Plan, specify `savingsPlanCode` and `current` in the URL. Replace ** with your own information. ``` https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws//current/index.json ``` For example, the current version of `AWSComputeSavingsPlan` appears like the following URL. ``` https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/current/index.json ``` For more information, see [Reading the service version index file](using-the-aws-price-list-bulk-api-reading-price-list-files-reading-service-version-index-file.md). ## Step 3: Finding available AWS Regions for a version of an AWS service Step 3: Find available AWS Regions for a version of a service | | | --- | | To provide feedback about AWS 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. | For a version of an AWS service or Savings Plan in [the previous step](#fetching-price-list-files-manually-step-2), you can find all the AWS Regions and edge locations in which an AWS service provides products for purchase. To download the service Region index file for an AWS service, navigate to the following URL. Replace ** and ** with your own information. ``` https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws///region_index.json ``` For example, the service code for `AmazonRDS` and its `current` version has the following URL. ``` https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/current/region_index.json ``` To download the service Region index file for Savings Plan, navigate to the following URL. Replace ** with your own information. ``` https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws//current/region_index.json ``` For example, a Savings Plan for `AWSComputeSavingsPlan` and its `current` version has the following URL. ``` https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/current/region_index.json ``` For more information, see [Reading the service Region index file](reading-service-region-index-files.md). ## Step 4: Finding available price lists for an AWS Region and version of an AWS service Step 4: Find available price lists for a Region and version of an AWS service | | | --- | | To provide feedback about AWS 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. | In the previous steps, you retrieved the following information about an AWS service: + Service code + Savings Plan code + Version + AWS Regions Next, you can use this information to find the prices in the service price list files. These files are available in JSON and CSV formats. **Contents** + [ ### Finding service price list files ](#fetching-price-list-files-manually-step-4-finding-service-price-list-files) + [ ### Finding service price list files for Savings Plan ](#find-service-price-list-files-for-savings-plans) ### Finding service price list files The service price list file provides the service related details, such as the following: + The effective date of the prices in that file + The version of the service price list + The list of offered products and their details, along with prices in JSON and CSV formats In the following URLs, you can change the URL to specify the format that you want (JSON or CSV). To download the service price list file, navigate to the following URL. Replace each *user input placeholder* with your own information. ``` https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws////index. ``` The following examples are for Amazon Relational Database Service (Amazon RDS). This service appears as AmazonRDS in the URL. **Example: Current version of the price list file for Amazon RDS** To get the current version of the price list file for Amazon RDS in the US East (Ohio) Region, use the following URL. CSV format ``` https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/current/us-east-2/index.csv ``` JSON format ``` https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/current/us-east-2/index.json ``` **Example: Specific version of the price list file for Amazon RDS** To get the specific version of the price list file for Amazon RDS in the US East (Ohio) Region, use the following URL. CSV format ``` https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/20230328234721/us-east-2/index.csv ``` JSON format ``` https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/20230328234721/us-east-2/index.json ``` ### Finding service price list files for Savings Plan Find service price list files for Savings Plan The service price list file for Savings Plan provides Savings Plan related details, such as the following: + The effective date of the prices in that file + The version of the service price list + The list of offered products and their details, along with prices in JSON and CSV formats In the following URLs, you can change the URL to specify the format that you want (JSON or CSV). To download the service price list files for Savings Plan, use the following URL. Replace each *user input placeholder* with your own information. ``` https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws////index.json ``` **Example: Service price list file for Amazon SageMaker AI** To get a specific version (`20230509202901`) of the price list file for SageMaker AI (`AWSComputeSavingsPlan`) in the US East (Ohio) Region, use the following URL. CSV format ``` https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/20230509202901/us-east-2/index.csv ``` JSON format ``` https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/20230509202901/us-east-2/index.json ``` For more information, see [Reading the service price list files](reading-service-price-list-files.md). # Reading the price list files Read the price list files | | | --- | | To provide feedback about AWS 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. | Use this section to understand how to read your price list files. This covers the service index file, the service version index file, the Region index file, and the price list files for both AWS services and Savings Plans use cases. ## Reading the service index file Reading the service index file | | | --- | | To provide feedback about AWS 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. | After you have the service index file, you can use it to find an service price list file. The service index file is available as a JSON file. To read the file, you can use a text application or a program that parses the JSON. The service index file has two main sections: + Metadata about the service index file + Either a list of the services that AWS offers or via AWS Marketplace. The information about the service index file includes the URL where you can download the prices and a URL for the service Region index file for that service. ### Example: Service index file The service index file looks like the following. ``` { "formatVersion":"The version number for the offer index format", "disclaimer":"The disclaimers for this offer index", "publicationDate":"The publication date of this offer index", "offers":{ "firstService":{ "offerCode":"The service that this price list is for", "currentVersionUrl":"The URL for this offer file", "currentRegionIndexUrl":"The URL for the regional offer index file", "savingsPlanVersionIndexUrl":"The URL for the Savings Plan index file (if applicable)" }, "secondService":{ "offerCode": ..., "currentVersionUrl": ..., "currentRegionIndexUrl": ..., "savingsPlanVersionIndexUrl":... }, ... }, } ``` ### Service index file definitions The following list defines the terms that are used in the service index file: **FormatVersion** An attribute that tracks which format version the service version index 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 version index file. **PublicationDate** The date and time in UTC format when a service version index file was published. For example, this might look like `2015-04-09T02:22:05Z` and `2015-09-10T18:21:05Z`. **Offers** A list of available service price list files. **Offers:OfferCode** A unique code for the product of an AWS service. For example, this might be `AmazonEC2` or `AmazonS3`. The `OfferCode` is used as the lookup key for the index. **Offers:CurrentVersionUrl** The URL where you can download the most up-to-date service price list file. **Offers:currentRegionIndexUrl** A list of available service price list files by Region. **Offers:savingsPlanVersionIndexUrl** The list of applicable Savings Plan offers. # Reading the service version index file Read the service version index file | | | --- | | To provide feedback about AWS 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 version index file is available in JSON format. To read the file, you can use a text program or an application that parses the JSON. The service version index file consists of two main sections: + Metadata about the service version index file + List of all versions of price list files available for an AWS service The information about a service version includes the URL that you can use to download the prices for that service for the specified time period. **Topics** + [ # Service version index file for an AWS service ](service-version-index-file-for-aws-service.md) + [ # Service version index file for Savings Plan ](service-version-index-file-for-savings-plans.md) # Service version index file for an AWS service | | | --- | | To provide feedback about AWS 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. | To understand the service version index file, see the following references: **Topics** + [ ## Example: Service version index file for a service ](#example-service-version-index-file-service) + [ ## Service version index file definitions ](#service-version-index-definitions-sps) ## Example: Service version index file for a service The service version index file looks like the following. ``` { "formatVersion":"The version number for the service version index format", "disclaimer":"The disclaimers for this service version index", "publicationDate":"The publication date of this service version index", "offerCode": "The service code/Savings Plan code", "currentVersion": "The latest version of the service" "versions":{ "firstVersion":{ "versionEffectiveBeginDate":"The date starting which this version is effective", "versionEffectiveEndDate":"The date until which this version is effective", "offerVersionUrl":"The relative URL for the service price list file of this version" }, "secondVersion":{ "versionEffectiveBeginDate": ..., "versionEffectiveEndDate": ..., "offerVersionUrl": ... }, ... }, } ``` ## Service version index file definitions The following list defines the terms in the service version index file. **formatVersion** An attribute that tracks which format version the service version index 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 version index file. **publicationDate** The date and time in UTC format when a service version index file was published. For example, `2023-03-28T23:47:21Z`. **offerCode** A unique code for the product of an AWS service. For example, `AmazonRDS` or `AmazonS3`. **currentVersion** The latest version number of the AWS service. For example, `20230328234721`. **versions** The list of available versions for this AWS service. **versions:version** A unique code for the version of a price list for an AWS service. This is used as the lookup key in the versions list. For example, `20230328234721`, **versions:version:versionEffectiveBeginDate** The start date and time in UTC format, which this version is effective. For example, `2023-03-28T23:47:21Z`. **versions:version:versionEffectiveEndDate** The end date and time in UTC format, which this version is effective. For example, `2023-03-28T23:47:21Z`. If this property isn't set, this means that this version is the currently active version. **versions:version:offerVersionUrl** The relative URL for the service price list files of the version. For example, `/offers/v1.0/aws/AmazonRDS/20230328234721/index.json`. # Service version index file for Savings Plan | | | --- | | To provide feedback about AWS 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. | To understand the service version index file for Savings Plan, see the following references: **Contents** + [ ## Example: Service version index file for Savings Plan ](#service-version-index-file-savings-plans-example) + [ ## Service version index definitions ](#service-version-index-definitions) ## Example: Service version index file for Savings Plan The service version index file for a Savings Plan looks like the following. ``` { "disclaimer":"The disclaimers for this service version index", "publicationDate":"The publication date of this service version index", "currentOfferVersionUrl" "The relative URL of region index file for latest version number of the service" "versions":[ { "publicationDate":"The publication date of this version of service from which this version was effective", "offerVersionUrl":"The relative URL for the service region index file of this version" }, { "publicationDate": ..., "offerVersionUrl": ... }, ... ], } ``` ## Service version index definitions The following list defines the terms in the service version index file. **disclaimer** Any disclaimers that apply to the service version index file. **publicationDate** The date and time in UTC format when a service version index file was published. For example, `2023-03-28T23:47:21Z`. **currentOfferVersionUrl** The relative URL of the regional index file for latest version number of the service. For example, `/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/current/region_index.json`. **versions** The list of available version for this AWS service. **versions:version:publicationDate** The date and time in UTC format when an service version index file was published. For example, `2023-04-07T14:57:05Z` **versions:version:offerVersionUrl** The relative URL for the service regional index file of this version. For example, `/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/20230407145705/region_index.json`. # Reading the service Region index file Read the service Region index file | | | --- | | To provide feedback about AWS 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 Region index file is available in JSON format. To read the file, you can use a text program or an application that parses the JSON. The service Region index file consists of two main sections: + Metadata about the service Region index file + List of all AWS Regions in which AWS services, Savings Plan or a service representing limited AWS Marketplace offerings are available. The information about a service Region includes the URL where you can download the prices for that service for the specified time period and Region. **Topics** + [ # Service Region index file for AWS services ](service-region-index-file-for-service.md) + [ # Service Region index file for Savings Plan ](service-region-index-files-for-savings-plan.md) # Service Region index file for AWS services | | | --- | | To provide feedback about AWS 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. | To understand the service version index file for AWS services, see the following references: **Contents** + [ ## Example: Service Region index file for an AWS service ](#service-region-index-file-for-service) + [ ## Service Region index definitions ](#service-region-index-definitions-services) ## Example: Service Region index file for an AWS service The service Region index file for an AWS service looks like the following. ``` { "formatVersion":"The version number for the service region index format", "disclaimer":"The disclaimers for this service region index", "publicationDate":"The publication date of this service region index", "regions":{ "firstRegion":{ "regionCode":"A unique identifier that identifies this region", "currentVersionUrl":"The relative URL for the service regional price list file of this version" }, "secondRegion":{ "regionCode": ..., "currentVersionUrl": ... }, ... } } ``` ## Service Region index definitions The following list defines the terms in the service Region index file. **formatVersion** An attribute that tracks which format version the service Region index 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 Region index file. **publicationDate** The date and time in UTC format when a service Region index file was published. For example, `2023-03-28T23:47:21Z`. **regions** The list of available AWS Region for the AWS service. **regions:regionCode** A unique code for the Region in which this AWS service is offered. This is used as the lookup key in the Regions list. For example, `us-east-2` is the US East (Ohio) Region. **regions:regionCode:currentVersionUrl** The relative URL for the service Region index file of this version. For example, `/offers/v1.0/aws/AmazonRDS/20230328234721/us-east-2/index.json`. # Service Region index file for Savings Plan | | | --- | | To provide feedback about AWS 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. | To understand the service Region index file for Savings Plan, see the following references: **Topics** + [ ## Example: Service Region index file for Savings Plan ](#service-region-index-file-for-savings-plans) + [ ## Service Region index definitions ](#service-region-index-file-definitions) ## Example: Service Region index file for Savings Plan The service Region index file for Savings Plan looks like the following. ``` { "disclaimer":"The disclaimers for this service version index", "publicationDate":"The publication date of this service region index", "regions":[ { "regionCode":"A unique identifier that identifies this region", "versionUrl":"The relative URL for the service regional price list file of this version" }, { "regionCode": ..., "versionUrl": ... }, ... ] } ``` ## Service Region index definitions The following list defines the terms in the service Region index file. **disclaimer** Any disclaimers that apply to the service Region index file. **publicationDate** The date and time in UTC format when a service Region index file was published. For example, `2023-03-28T23:47:21Z`. **regions** The list of available AWS Region for the AWS service. **regions:regionCode** A unique code for the Region in which this AWS service is offered. This is used as the lookup key in the Regions list. For example, `us-east-2` is the (US East (Ohio) Region. **regions:versionUrl** The relative URL for the service Region index file of this version. For example, `/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/20230407145705/us-east-2/index.json`. # Reading the service price list files Read the service price list files | | | --- | | To provide feedback about AWS 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 AWS service or Savings Plan in *all AWS Regions* or a single AWS 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 AWS 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 AWS service Read the service price list file for an AWS service | | | --- | | To provide feedback about AWS 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 AWS 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 AWS 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 AWS 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 AWS 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 AWS 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 AWS service includes the following types of information: + Service price list file details – Metadata about the service price list file, such as the version, AWS 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), AWS 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`. # Finding prices in the service price list file Find prices in the service price list file | | | --- | | To provide feedback about AWS 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 AWS Price List Bulk API provides prices for all AWS products for informational purposes, including On-Demand and Reserved Instances pricing. To find the prices and terms for a specific product, you can use the offer files. For example, you can find a list of Amazon Elastic Compute Cloud (Amazon EC2) instance prices. **Note** The AWS Price List Bulk API is not a comprehensive source for limited period offers, such as AWS Free Tier pricing. For information about Free Tier prices, see [AWS Free Tier](https://aws.amazon.com/free/). To find prices for the products you're interested in. **Contents** + [ ## Finding On-Demand prices for services ](#finding-one-demand-prices-services) + [ ## Finding tiered prices for services ](#finding-tiered-prices-services) + [ ## Finding tiered prices for services with Free Tier ](#finding-tiered-prices-services-free-tier) + [ ### Example ](#finding-tiered-prices-services-free-tier-example) + [ ## Finding prices for services with Reserved Instances ](#finding-prices-services-reserved-instances) ## Finding On-Demand prices for services Find On-Demand prices for services The following procedure shows how to find On-Demand prices for AWS services, such as Amazon EC2. **To find an On-Demand price by using the CSV file** 1. Download the CSV file for the service. 1. Open the CSV file with your preferred application. 1. Under the **TermType** column, filter to show **OnDemand**. 1. Find the usage type and operation that you want. 1. In the **PricePerUnit** column, see the corresponding price. **To find an On-Demand price by using the JSON file** 1. Download the JSON file for the service. 1. Open the JSON file with your preferred application. 1. Under **terms** and **On-Demand**, find the SKU that you want. If you don't know the SKU, search under **products** for the **usage type** and **operation**. 1. See the **pricePerUnit** to find the corresponding On-Demand price for the SKU. ## Finding tiered prices for services Find tiered prices for services The following procedure shows how to find tiered prices for services, such as Amazon Simple Storage Service (Amazon S3). **To find tiered prices for services by using the CSV file** 1. Download the CSV file for the service. 1. Open the CSV file with your preferred application 1. Under the **TermType** column, filter to show **OnDemand**. 1. Find the usage type and operation that you want. 1. In the **PricePerUnit** column, see the corresponding price for each **StartingRange** and **EndingRange**. **To find tiered prices for services by using the JSON file** 1. Download the JSON file. 1. Open the JSON file with your preferred application. 1. Under **terms** and **On-Demand** find the SKU that you want. If you don't know the SKU, search under **products** for the **usage type** and **operation**. 1. Under each **beginRange** and **endRange**, see the **pricePerUnit** to find the corresponding tiered prices. ## Finding tiered prices for services with Free Tier Find tiered prices for services with Free Tier The following procedure shows how to find AWS services that publish Free Tier prices in the AWS Price List Bulk API, such as AWS Lambda. All Free Tier prices are subject to the terms documented in [AWS Free Tier](https://aws.amazon.com/free). **To find prices for services with Free Tier by using the CSV file** 1. Download the CSV file for the service. 1. Open the CSV file with your preferred application. 1. Under the **TermType** column, filter to show **OnDemand**. 1. Under the **Location** column, filter to show **Any**. **Any** doesn't represent all AWS Regions in this scenario. It's a subset of Regions defined by other line items in the CSV file, with a **RelatedTo** column matching the SKU for the location **Any** entry. 1. To find a list of all eligible locations and products for a specific Free Tier SKU, find the Free Tier SKU under the **RelatedTo** column. 1. To find the covered usage by Free Tier across all eligible locations, see the **StartingRange** and **EndingRange** for the location **Any**. ### Example This example assumes there are no more entries in the price file where **RelatedTo** equals to the SKU `ABCD`. As shown in the following table, the Free Tier offer with SKU `ABCD` is valid in the `Asia Pacific (Singapore)` and `US East (Ohio)` Regions, but not in `AWS GovCloud (US)`. The covered usage by Free Tier is 400,000 seconds total, used across both eligible Regions. **** | SKU | StartingRage | EndingRange | Unit | RelatedTo | Location | | --- | --- | --- | --- | --- | --- | | ABCD | 0 | 400000 | seconds | | Any | | QWER | 0 | Inf | seconds | ABCD | Asia Pacific (Singapore) | | WERT | 0 | Inf | seconds | ABCD | US East (Ohio) | | ERTY | 0 | Inf | seconds | | AWS GovCloud (US) | **To find tiered prices for services with Free Tier by using the JSON file** 1. Download the JSON file for the service. 1. Open the JSON file with your preferred application. 1. Under **products**, find the **usagetype** with the Region prefix **Global**. 1. Take note of the SKU, and look for the same SKU under **terms** and **OnDemand**. 1. For the amount of Free Tier usage, see the **BeginRange** and **EndRange** . For a list of products and Regions covered by Free Tier, see **appliesTo**. ## Finding prices for services with Reserved Instances Find prices for services with Reserved Instances The following procedure shows how to find prices for services with Reserved Instances, such as Amazon Relational Database Service (Amazon RDS). **To find prices for a Reserved Instance by using the CSV file** 1. Download the Amazon EC2 CSV file. 1. Open the CSV file with your preferred application. 1. Under the **TermType** column, filter to show **reserved**. 1. Find the usage type and operation that you want. 1. For each **LeaseContractLength**, **PurchaseOption**, and **OfferingClass**, see the **PricePerUnit** column for the corresponding price. **To find prices for Reserved Instances by using the JSON file** 1. Download the JSON file for the service. 1. Open the JSON file with your preferred application. 1. Under **terms** and **Reserved**, find the SKU that you want. If you don't know the SKU, search under **products** for the **usage type** and **operation**. You can find prices for **LeaseContractLength**, **PurchaseOption**, and **OfferingClass** for the same product.