Using the Amazon Price List Bulk 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 Bulk 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 Bulk API when you want to do the following tasks:

  • Consume large amounts of product and pricing information for Amazon Web Services.

  • Consume product and pricing information with a high throughput for an Amazon Web 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.

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

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

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

Endpoints

The Price List Bulk API provides the following endpoints:

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

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

To call the 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

Some Price List Bulk 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. Quotas for each API operation are shown in the following table.

API operation Token bucket size Refill rate per second
DescribeServices 10 5
GetPriceListFileUrl 10 5
ListPriceLists 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.