software.amazon.awssdk.services.costexplorer

Interface CostExplorerAsyncClient

All Superinterfaces:

AutoCloseable, SdkAutoCloseable, SdkClient

@Generated(value="software.amazon.awssdk:codegen")
public interface CostExplorerAsyncClient
extends SdkClient, SdkAutoCloseable

Service client for accessing AWS Cost Explorer asynchronously. This can be created using the static builder() method.

The Cost Explorer API allows you to programmatically query your cost and usage data. You can query for aggregated data such as total monthly costs or total daily usage. You can also query for granular data, such as the number of daily write operations for DynamoDB database tables in your production environment.

Service Endpoint

The Cost Explorer API provides the following endpoint:

• https://ce.us-east-1.amazonaws.com

Field Summary

Fields

Modifier and Type	Field and Description
static String	SERVICE_NAME

Method Summary

Modifier and Type	Method and Description
static CostExplorerAsyncClientBuilder	builder() Create a builder that can be used to configure and create a CostExplorerAsyncClient.
static CostExplorerAsyncClient	create() Create a CostExplorerAsyncClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.
default CompletableFuture<GetCostAndUsageResponse>	getCostAndUsage(Consumer<GetCostAndUsageRequest.Builder> getCostAndUsageRequest) Retrieve cost and usage metrics for your account.
default CompletableFuture<GetCostAndUsageResponse>	getCostAndUsage(GetCostAndUsageRequest getCostAndUsageRequest) Retrieve cost and usage metrics for your account.
default CompletableFuture<GetDimensionValuesResponse>	getDimensionValues(Consumer<GetDimensionValuesRequest.Builder> getDimensionValuesRequest) You can use GetDimensionValues to retrieve all available filter values for a specific filter over a period of time.
default CompletableFuture<GetDimensionValuesResponse>	getDimensionValues(GetDimensionValuesRequest getDimensionValuesRequest) You can use GetDimensionValues to retrieve all available filter values for a specific filter over a period of time.
default CompletableFuture<GetReservationUtilizationResponse>	getReservationUtilization(Consumer<GetReservationUtilizationRequest.Builder> getReservationUtilizationRequest) You can retrieve the Reservation utilization for your account.
default CompletableFuture<GetReservationUtilizationResponse>	getReservationUtilization(GetReservationUtilizationRequest getReservationUtilizationRequest) You can retrieve the Reservation utilization for your account.
default CompletableFuture<GetTagsResponse>	getTags(Consumer<GetTagsRequest.Builder> getTagsRequest) You can query for available tag keys and tag values for a specified period.
default CompletableFuture<GetTagsResponse>	getTags(GetTagsRequest getTagsRequest) You can query for available tag keys and tag values for a specified period.

Methods inherited from interface software.amazon.awssdk.core.SdkClient

serviceName

Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable

close

Field Detail

SERVICE_NAME

static final String SERVICE_NAME

See Also:

Constant Field Values

Method Detail

create

static CostExplorerAsyncClient create()

Create a CostExplorerAsyncClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.

builder

static CostExplorerAsyncClientBuilder builder()

Create a builder that can be used to configure and create a CostExplorerAsyncClient.

getCostAndUsage

default CompletableFuture<GetCostAndUsageResponse> getCostAndUsage(GetCostAndUsageRequest getCostAndUsageRequest)

Retrieve cost and usage metrics for your account. You can specify which cost and usage-related metric, such as BlendedCosts or UsageQuantity, that you want the request to return. You can also filter and group your data by various dimensions, such as AWS Service or AvailabilityZone, in a specific time range. See the GetDimensionValues action for a complete list of the valid dimensions. Master accounts in an organization have access to all member accounts.

Parameters:

getCostAndUsageRequest -

Returns:

A Java Future containing the result of the GetCostAndUsage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• LimitExceededException You made too many calls in a short period of time. Try again later.
• SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
• SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
• CostExplorerException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

See Also:

AWS API Documentation

getCostAndUsage

default CompletableFuture<GetCostAndUsageResponse> getCostAndUsage(Consumer<GetCostAndUsageRequest.Builder> getCostAndUsageRequest)

Retrieve cost and usage metrics for your account. You can specify which cost and usage-related metric, such as BlendedCosts or UsageQuantity, that you want the request to return. You can also filter and group your data by various dimensions, such as AWS Service or AvailabilityZone, in a specific time range. See the GetDimensionValues action for a complete list of the valid dimensions. Master accounts in an organization have access to all member accounts.

This is a convenience which creates an instance of the GetCostAndUsageRequest.Builder avoiding the need to create one manually via GetCostAndUsageRequest.builder()

Parameters:

getCostAndUsageRequest - A Consumer that will call methods on GetCostAndUsageRequest.Builder to create a request.

Returns:

A Java Future containing the result of the GetCostAndUsage operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• LimitExceededException You made too many calls in a short period of time. Try again later.
• SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
• SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
• CostExplorerException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

See Also:

AWS API Documentation

getDimensionValues

default CompletableFuture<GetDimensionValuesResponse> getDimensionValues(GetDimensionValuesRequest getDimensionValuesRequest)

You can use GetDimensionValues to retrieve all available filter values for a specific filter over a period of time. You can search the dimension values for an arbitrary string.

Parameters:

getDimensionValuesRequest -

Returns:

A Java Future containing the result of the GetDimensionValues operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• LimitExceededException You made too many calls in a short period of time. Try again later.
• SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
• SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
• CostExplorerException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

See Also:

AWS API Documentation

getDimensionValues

default CompletableFuture<GetDimensionValuesResponse> getDimensionValues(Consumer<GetDimensionValuesRequest.Builder> getDimensionValuesRequest)

You can use GetDimensionValues to retrieve all available filter values for a specific filter over a period of time. You can search the dimension values for an arbitrary string.

This is a convenience which creates an instance of the GetDimensionValuesRequest.Builder avoiding the need to create one manually via GetDimensionValuesRequest.builder()

Parameters:

getDimensionValuesRequest - A Consumer that will call methods on GetDimensionValuesRequest.Builder to create a request.

Returns:

A Java Future containing the result of the GetDimensionValues operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• LimitExceededException You made too many calls in a short period of time. Try again later.
• SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
• SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
• CostExplorerException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

See Also:

AWS API Documentation

getReservationUtilization

default CompletableFuture<GetReservationUtilizationResponse> getReservationUtilization(GetReservationUtilizationRequest getReservationUtilizationRequest)

You can retrieve the Reservation utilization for your account. Master accounts in an organization have access to their associated member accounts. You can filter data by dimensions in a time period. You can use GetDimensionValues to determine the possible dimension values. Currently, you can group only by SUBSCRIPTION_ID.

Parameters:

getReservationUtilizationRequest -

Returns:

A Java Future containing the result of the GetReservationUtilization operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• LimitExceededException You made too many calls in a short period of time. Try again later.
• SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
• SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
• CostExplorerException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

See Also:

AWS API Documentation

getReservationUtilization

default CompletableFuture<GetReservationUtilizationResponse> getReservationUtilization(Consumer<GetReservationUtilizationRequest.Builder> getReservationUtilizationRequest)

You can retrieve the Reservation utilization for your account. Master accounts in an organization have access to their associated member accounts. You can filter data by dimensions in a time period. You can use GetDimensionValues to determine the possible dimension values. Currently, you can group only by SUBSCRIPTION_ID.

This is a convenience which creates an instance of the GetReservationUtilizationRequest.Builder avoiding the need to create one manually via GetReservationUtilizationRequest.builder()

Parameters:

getReservationUtilizationRequest - A Consumer that will call methods on GetReservationUtilizationRequest.Builder to create a request.

Returns:

A Java Future containing the result of the GetReservationUtilization operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• LimitExceededException You made too many calls in a short period of time. Try again later.
• SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
• SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
• CostExplorerException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

See Also:

AWS API Documentation

getTags

default CompletableFuture<GetTagsResponse> getTags(GetTagsRequest getTagsRequest)

You can query for available tag keys and tag values for a specified period. You can search the tag values for an arbitrary string.

Parameters:

getTagsRequest -

Returns:

A Java Future containing the result of the GetTags operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• LimitExceededException You made too many calls in a short period of time. Try again later.
• SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
• SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
• CostExplorerException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

See Also:

AWS API Documentation

getTags

default CompletableFuture<GetTagsResponse> getTags(Consumer<GetTagsRequest.Builder> getTagsRequest)

You can query for available tag keys and tag values for a specified period. You can search the tag values for an arbitrary string.

This is a convenience which creates an instance of the GetTagsRequest.Builder avoiding the need to create one manually via GetTagsRequest.builder()

Parameters:

getTagsRequest - A Consumer that will call methods on GetTagsRequest.Builder to create a request.

Returns:

A Java Future containing the result of the GetTags operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• LimitExceededException You made too many calls in a short period of time. Try again later.
• SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
• SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
• CostExplorerException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

See Also:

AWS API Documentation