Using the Amazon Price List Query API - Amazon Billing
IAM permissionsEndpointsQuotas
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).

Using the Amazon Price List Query API

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

We recommend that you use the Price List Query API when you want to:

  • Find pricing information about a product.

  • Search for products and rates that match your filters.

  • Quickly find products and prices that you need when you're developing applications that have limited resources, such as front-end environments.

Topics

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. To grant access, use the following IAM policy.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "pricing:DescribeServices",
                "pricing:GetAttributeValues",
                "pricing:GetProducts"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}
Note

This policy only grants access to the Price List Query API. To also grant access to the Amazon Price List Bulk API, see the example Find products and prices policy.

Endpoints

The Price List Query 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, 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

Some Price List Query API operations are throttled by using a token bucket scheme to maintain service availability. These quotas are per Amazon Web Services account on a per Region basis. The following table shows the quotas for each API operation.

API operation Token bucket size Refill rate per second
DescribeServices 10 5
GetAttributeValues 10 5
GetProducts 10 5

For more information about service quotas (formerly referred to as limits), see Amazon Web Service quotas in the Amazon Web Services General Reference.