Using the AWS Price List Bulk API

To provide feedback about AWS 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 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.

Topics

• IAM permissions
• Endpoints
• Quotas
• Getting price list files
• Getting price list files manually
• Reading the price list files
• Finding prices in the service price list file

IAM permissions

An AWS 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://api.pricing.us-east-1.amazonaws.com

• https://api.pricing.eu-central-1.amazonaws.com

• https://api.pricing.ap-south-1.amazonaws.com

The AWS 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.US_EAST_1)// or Region.AP_SOUTH_1
                .credentialsProvider(DefaultCredentialsProvider.builder().build())
                .build();
        );
    }
}

AWS Command Line Interface

Specify the Region with the following command.

aws pricing describe-services --region us-east-1

Quotas

Some Price List Bulk API operations are throttled by using a token bucket scheme to maintain service availability. These quotas are per AWS 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 AWS service quotas in the AWS General Reference.