com.amazonaws.services.pricing.AWSPricingAsync Maven / Gradle / Ivy
Show all versions of aws-java-sdk-pricing Show documentation
/*
* Copyright 2016-2021 Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
* the License. A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
* CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
* and limitations under the License.
*/
package com.amazonaws.services.pricing;
import javax.annotation.Generated;
import com.amazonaws.services.pricing.model.*;
/**
* Interface for accessing AWS Pricing asynchronously. Each asynchronous method will return a Java Future object
* representing the asynchronous operation; overloads which accept an {@code AsyncHandler} can be used to receive
* notification when an asynchronous operation completes.
*
* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from
* {@link com.amazonaws.services.pricing.AbstractAWSPricingAsync} instead.
*
*
*
* AWS Price List Service API (AWS Price List Service) is a centralized and convenient way to programmatically query
* Amazon Web Services for services, products, and pricing information. The AWS 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 AWS 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 AWS.
*
*
* Use GetServices without a service code to retrieve the service codes for all AWS services, then
* GetServices with a service code to retreive 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
*
*
* AWS 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
*
*
*
*/
@Generated("com.amazonaws:aws-java-sdk-code-generator")
public interface AWSPricingAsync extends AWSPricing {
/**
*
* 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.
*
*
* @param describeServicesRequest
* @return A Java Future containing the result of the DescribeServices operation returned by the service.
* @sample AWSPricingAsync.DescribeServices
* @see AWS API
* Documentation
*/
java.util.concurrent.Future describeServicesAsync(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.
*
*
* @param describeServicesRequest
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
* implementation of the callback methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the DescribeServices operation returned by the service.
* @sample AWSPricingAsyncHandler.DescribeServices
* @see AWS API
* Documentation
*/
java.util.concurrent.Future describeServicesAsync(DescribeServicesRequest describeServicesRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Returns a list of attribute values. Attibutes are similar to the details in a Price List API offer file. For a
* list of available attributes, see Offer File
* Definitions in the AWS Billing and Cost
* Management User Guide.
*
*
* @param getAttributeValuesRequest
* @return A Java Future containing the result of the GetAttributeValues operation returned by the service.
* @sample AWSPricingAsync.GetAttributeValues
* @see AWS API
* Documentation
*/
java.util.concurrent.Future getAttributeValuesAsync(GetAttributeValuesRequest getAttributeValuesRequest);
/**
*
* Returns a list of attribute values. Attibutes are similar to the details in a Price List API offer file. For a
* list of available attributes, see Offer File
* Definitions in the AWS Billing and Cost
* Management User Guide.
*
*
* @param getAttributeValuesRequest
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
* implementation of the callback methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the GetAttributeValues operation returned by the service.
* @sample AWSPricingAsyncHandler.GetAttributeValues
* @see AWS API
* Documentation
*/
java.util.concurrent.Future getAttributeValuesAsync(GetAttributeValuesRequest getAttributeValuesRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Returns a list of all products that match the filter criteria.
*
*
* @param getProductsRequest
* @return A Java Future containing the result of the GetProducts operation returned by the service.
* @sample AWSPricingAsync.GetProducts
* @see AWS API
* Documentation
*/
java.util.concurrent.Future getProductsAsync(GetProductsRequest getProductsRequest);
/**
*
* Returns a list of all products that match the filter criteria.
*
*
* @param getProductsRequest
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
* implementation of the callback methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the GetProducts operation returned by the service.
* @sample AWSPricingAsyncHandler.GetProducts
* @see AWS API
* Documentation
*/
java.util.concurrent.Future getProductsAsync(GetProductsRequest getProductsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
}