Calling Amazon Web Services services and prices using the Amazon Price List - Amazon Billing
OverviewGetting started with Amazon Price List
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Calling Amazon Web Services services and prices using the Amazon Price List

Note

To provide feedback about Amazon Price List, complete this short survey. Your responses will be anonymous. Note: This survey is in English only.

Amazon Price List provides a catalog of the products and prices for Amazon Web Services services that you can purchase on Amazon.

This catalog includes free offers from Amazon Web Services China Region Free Tier. This catalog doesn't include limited time or fixed usage based Free Tier products. For more information about Free Tier offers, see Trying services using Amazon Web Services China Region Free Tier. Also, this catalog doesn't include Amazon Elastic Compute Cloud (Amazon EC2) Spot Instances. For more information about Amazon EC2 Spot Instances, see Amazon EC2 Spot Instances.

For more information, see the following topics:

Overview

To help you use the Amazon Price List, the following are its key concepts:

Service

An Amazon Web Services service, such as Amazon EC2 or Savings Plans. For example, a Savings Plan for Amazon EC2 might be AWSComputeSavingsPlan and a Savings Plan for machine learning (ML) might be AWSMachineLearningSavingsPlans.

Product

An entity sold by an Amazon Web Services service. In the price list file, products are indexed by a unique stock keeping unit (SKU).

Attribute

The property associated with a product. This property consists of AttributeName and AttributeValue. Products can have multiple attributes. Each attribute has one AttributeName and a list of applicable AttributeValues.

You can use the following Amazon Price List APIs:

Amazon Price List Query API

This API provides a centralized and convenient way to programmatically query Amazon for services, products, and pricing information.

The Price List Query API uses product attributes and provides prices at the SKU level. Use this API to build cost control and scenario planning tools, reconcile billing data, forecast future spend for budgeting purposes, and provide cost benefit analyses that compare your internal workloads with Amazon.

Note

The Price List Query API doesn't support Savings Plan prices.

Amazon Price List Bulk API

This API provides a way to programmatically fetch up-to-date pricing information on current Amazon Web Services services and products in bulk by using the price list files. The price list files are available in JSON and CSV formats. The price list files are organized by Amazon Web Services service and Amazon Web Services Region.

Note

The Price List Query API and Price List Bulk API provide pricing details for informational purposes only. If there's a difference between the price list file and a service pricing page, Amazon charges the prices on the service pricing page.

For more information about Amazon Web Services service pricing, see Amazon Pricing.

To call the Amazon Price List APIs, we recommend that you use an Amazon SDK that supports your preferred programming language. Amazon SDKs save you time and simplify the process of signing requests. You can also integrate the Amazon SDKs with your development environment and access the related commands.

Getting started with Amazon Price List

IAM permissions

An Amazon Identity and Access Management (IAM) identity, such as a user or role, must have permission to use the Price List Query API or Price List Bulk API. To grant access, see Find products and prices.

Endpoints

The Price List Query API and Price List Bulk API provides the following endpoints:

  • https://api.pricing.cn-northwest-1.amazonaws.com.cn

The Amazon Web Services Region is the API endpoint for the Price List Query API. The endpoints aren't related to product or service attributes.

To call the Price List Query API or Price List Bulk API, see the following examples.

Java

In the following example, specify the region_name and use it to create the PricingClient.

public class Main {
    public static void main(String[] args) {

        // Create pricing client
        PricingClient client = PricingClient.builder()
                .region(Region.<region_name>)
                .credentialsProvider(DefaultCredentialsProvider.builder().build())
                .build();
        );
    }
}
Amazon Command Line Interface

Specify the Region with the following command.

aws pricing describe-services --region cn-northwest-1

Quotas

See Amazon Price List in the Quotas and restrictions page.

For more information about service quotas, see Amazon Web Services service quotas in the Amazon Web Services General Reference.