Calling AWS services and prices using the AWS Price List - AWS Billing
OverviewGetting started with AWS Price List

Calling AWS services and prices using the AWS Price List

Note

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

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

This catalog includes free offers from AWS 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 AWS 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 AWS Price List, the following are its key concepts:

Service

An AWS 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 AWS 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 AWS Price List APIs:

AWS Price List Query API

This API provides a centralized and convenient way to programmatically query AWS 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 AWS.

Note

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

AWS Price List Bulk API

This API provides a way to programmatically fetch up-to-date pricing information on current AWS 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 AWS service and AWS 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, AWS charges the prices on the service pricing page.

For more information about AWS service pricing, see AWS Pricing.

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

Getting started with AWS Price List

IAM permissions

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

See AWS Price List in the Quotas and restrictions page.

For more information about service quotas, see AWS service quotas in the AWS General Reference.