# Calling Amazon Web Services services and prices using the Amazon Price List
<a name="price-changes"></a>


|  | 
| --- |
| 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. | 

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 perpetual free offers from Amazon Web Services China Region Free Tier. This includes usage-based free tier offers that refresh periodically, available permanently. This catalog doesn't include time-limited Free Tier offers that expire based on how long the account's been active. For more information about Free Tier offers, see [Trying services using Amazon Web Services China Region Free Tier (before July 15, 2025)](billing-free-tier.md). 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](https://www.amazonaws.cn/ec2/spot/).

For more information, see the following topics:
+ [Amazon Billing and Cost Management API Reference](https://docs.amazonaws.cn/aws-cost-management/latest/APIReference/Welcome.html#Welcome_AWS_Price_List_Service)
+ [Language-specific Amazon SDKs](https://docs.amazonaws.cn/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html#API_pricing_DescribeServices_SeeAlso)
+ [Tools for Amazon Web Services](https://www.amazonaws.cn/tools)

## Overview
<a name="price-list-overview"></a>

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 is `AWSComputeSavingsPlan` or a service representing limited Amazon Marketplace offerings, for example: `AmazonBedrockFoundationModels`.

**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](using-price-list-query-api.md)**  
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.   
The Price List Query API doesn't support Savings Plan prices.

**[Amazon Price List Bulk API](using-the-aws-price-list-bulk-api.md)**  
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](https://aws.amazon.com/pricing/services/).

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
<a name="price-list-gettingstarted"></a>

### IAM permissions
<a name="iam-permissions-for-price-list-query-api"></a>

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](billing-example-policies.md#example-policy-pe-api).

### Endpoints
<a name="price-list-query-api-endpoints"></a>

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
<a name="quotas-price-list-query-api"></a>

See [Amazon Price List](billing-limits.md#price-list-api-quotas) in the *Quotas and restrictions* page.

For more information about service quotas, see [Amazon Web Services service quotas](https://docs.amazonaws.cn/general/latest/gr/aws_service_limits.html) in the *Amazon Web Services General Reference*.