@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public interface AWSPricing
Note: Do not directly implement this interface, new methods are added to it regularly. Extend from
AbstractAWSPricing
instead.
Amazon Web Services Price List Service API (Amazon Web Services Price List Service) is a centralized and convenient
way to programmatically query Amazon Web Services for services, products, and pricing information. The Amazon Web
Services Price List Service uses standardized product attributes such as Location
,
Storage Class
, and Operating System
, and provides prices at the SKU level. You can use the
Amazon Web Services Price List Service to build cost control and scenario planning tools, reconcile billing data,
forecast future spend for budgeting purposes, and provide cost benefit analysis that compare your internal workloads
with Amazon Web Services.
Use GetServices
without a service code to retrieve the service codes for all AWS services, then
GetServices
with a service code to retrieve the attribute names for that service. After you have the
service code and attribute names, you can use GetAttributeValues
to see what values are available for an
attribute. With the service code and an attribute name and value, you can use GetProducts
to find
specific products that you're interested in, such as an AmazonEC2
instance, with a
Provisioned IOPS
volumeType
.
Service Endpoint
Amazon Web Services Price List Service API provides the following two endpoints:
https://api.pricing.us-east-1.amazonaws.com
https://api.pricing.ap-south-1.amazonaws.com
Modifier and Type | Field and Description |
---|---|
static String |
ENDPOINT_PREFIX
The region metadata service name for computing region endpoints.
|
Modifier and Type | Method and Description |
---|---|
DescribeServicesResult |
describeServices(DescribeServicesRequest describeServicesRequest)
Returns the metadata for one service or a list of the metadata for all services.
|
GetAttributeValuesResult |
getAttributeValues(GetAttributeValuesRequest getAttributeValuesRequest)
Returns a list of attribute values.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful request, typically used for debugging issues
where a service isn't acting as expected.
|
GetProductsResult |
getProducts(GetProductsRequest getProductsRequest)
Returns a list of all products that match the filter criteria.
|
void |
shutdown()
Shuts down this client object, releasing any resources that might be held open.
|
static final String ENDPOINT_PREFIX
DescribeServicesResult describeServices(DescribeServicesRequest describeServicesRequest)
Returns the metadata for one service or a list of the metadata for all services. Use this without a service code
to get the service codes for all services. Use it with a service code, such as AmazonEC2
, to get
information specific to that service, such as the attribute names available for that service. For example, some
of the attribute names available for EC2 are volumeType
, maxIopsVolume
,
operation
, locationType
, and instanceCapacity10xlarge
.
describeServicesRequest
- InternalErrorException
- An error on the server occurred during the processing of your request. Try again later.InvalidParameterException
- One or more parameters had an invalid value.NotFoundException
- The requested resource can't be found.InvalidNextTokenException
- The pagination token is invalid. Try again without a pagination token.ExpiredNextTokenException
- The pagination token expired. Try again without a pagination token.GetAttributeValuesResult getAttributeValues(GetAttributeValuesRequest getAttributeValuesRequest)
Returns a list of attribute values. Attributes are similar to the details in a Price List API offer file. For a list of available attributes, see Offer File Definitions in the Amazon Web Services Billing and Cost Management User Guide.
getAttributeValuesRequest
- InternalErrorException
- An error on the server occurred during the processing of your request. Try again later.InvalidParameterException
- One or more parameters had an invalid value.NotFoundException
- The requested resource can't be found.InvalidNextTokenException
- The pagination token is invalid. Try again without a pagination token.ExpiredNextTokenException
- The pagination token expired. Try again without a pagination token.GetProductsResult getProducts(GetProductsRequest getProductsRequest)
Returns a list of all products that match the filter criteria.
getProductsRequest
- InternalErrorException
- An error on the server occurred during the processing of your request. Try again later.InvalidParameterException
- One or more parameters had an invalid value.NotFoundException
- The requested resource can't be found.InvalidNextTokenException
- The pagination token is invalid. Try again without a pagination token.ExpiredNextTokenException
- The pagination token expired. Try again without a pagination token.void shutdown()
ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
request
- The originally executed request.