Package software.amazon.awssdk.services.costexplorer

Interface CostExplorerAsyncClient

  • All Superinterfaces:
    AutoCloseable, AwsClient, SdkAutoCloseable, SdkClient
    @Generated("software.amazon.awssdk:codegen")
@ThreadSafe
public interface CostExplorerAsyncClient
extends AwsClient
    Service client for accessing AWS Cost Explorer asynchronously. This can be created using the static builder() method.

    You can use the Cost Explorer API 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. This might include the number of daily write operations for Amazon DynamoDB database tables in your production environment.

    Service Endpoint

    The Cost Explorer API provides the following endpoint:

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

    For information about the costs that are associated with the Cost Explorer API, see Amazon Web Services Cost Management Pricing.

    • Method Detail

      • createAnomalyMonitor

        default CompletableFuture<CreateAnomalyMonitorResponse> createAnomalyMonitor​(CreateAnomalyMonitorRequest createAnomalyMonitorRequest)

        Creates a new cost anomaly detection monitor with the requested type and monitor specification.

        Parameters:
        createAnomalyMonitorRequest -
        Returns:
        A Java Future containing the result of the CreateAnomalyMonitor 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

      • createAnomalyMonitor

        default CompletableFuture<CreateAnomalyMonitorResponse> createAnomalyMonitor​(Consumer<CreateAnomalyMonitorRequest.Builder> createAnomalyMonitorRequest)

        Creates a new cost anomaly detection monitor with the requested type and monitor specification.


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

        Parameters:
        createAnomalyMonitorRequest - A Consumer that will call methods on CreateAnomalyMonitorRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the CreateAnomalyMonitor 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

      • createAnomalySubscription

        default CompletableFuture<CreateAnomalySubscriptionResponse> createAnomalySubscription​(CreateAnomalySubscriptionRequest createAnomalySubscriptionRequest)

        Adds an alert subscription to a cost anomaly detection monitor. You can use each subscription to define subscribers with email or SNS notifications. Email subscribers can set an absolute or percentage threshold and a time frequency for receiving notifications.

        Parameters:
        createAnomalySubscriptionRequest -
        Returns:
        A Java Future containing the result of the CreateAnomalySubscription operation returned by the service.
        The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
        • UnknownMonitorException The cost anomaly monitor does not exist for the account.
        • 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

      • createAnomalySubscription

        default CompletableFuture<CreateAnomalySubscriptionResponse> createAnomalySubscription​(Consumer<CreateAnomalySubscriptionRequest.Builder> createAnomalySubscriptionRequest)

        Adds an alert subscription to a cost anomaly detection monitor. You can use each subscription to define subscribers with email or SNS notifications. Email subscribers can set an absolute or percentage threshold and a time frequency for receiving notifications.


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

        Parameters:
        createAnomalySubscriptionRequest - A Consumer that will call methods on CreateAnomalySubscriptionRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the CreateAnomalySubscription operation returned by the service.
        The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
        • UnknownMonitorException The cost anomaly monitor does not exist for the account.
        • 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

      • createCostCategoryDefinition

        default CompletableFuture<CreateCostCategoryDefinitionResponse> createCostCategoryDefinition​(CreateCostCategoryDefinitionRequest createCostCategoryDefinitionRequest)

        Creates a new Cost Category with the requested name and rules.

        Parameters:
        createCostCategoryDefinitionRequest -
        Returns:
        A Java Future containing the result of the CreateCostCategoryDefinition operation returned by the service.
        The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
        • ServiceQuotaExceededException You've reached the limit on the number of resources you can create, or exceeded the size of an individual resource.
        • 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

      • createCostCategoryDefinition

        default CompletableFuture<CreateCostCategoryDefinitionResponse> createCostCategoryDefinition​(Consumer<CreateCostCategoryDefinitionRequest.Builder> createCostCategoryDefinitionRequest)

        Creates a new Cost Category with the requested name and rules.


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

        Parameters:
        createCostCategoryDefinitionRequest - A Consumer that will call methods on CreateCostCategoryDefinitionRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the CreateCostCategoryDefinition operation returned by the service.
        The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
        • ServiceQuotaExceededException You've reached the limit on the number of resources you can create, or exceeded the size of an individual resource.
        • 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

      • deleteAnomalyMonitor

        default CompletableFuture<DeleteAnomalyMonitorResponse> deleteAnomalyMonitor​(DeleteAnomalyMonitorRequest deleteAnomalyMonitorRequest)

        Deletes a cost anomaly monitor.

        Parameters:
        deleteAnomalyMonitorRequest -
        Returns:
        A Java Future containing the result of the DeleteAnomalyMonitor 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.
        • UnknownMonitorException The cost anomaly monitor does not exist for the account.
        • 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

      • deleteAnomalyMonitor

        default CompletableFuture<DeleteAnomalyMonitorResponse> deleteAnomalyMonitor​(Consumer<DeleteAnomalyMonitorRequest.Builder> deleteAnomalyMonitorRequest)

        Deletes a cost anomaly monitor.


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

        Parameters:
        deleteAnomalyMonitorRequest - A Consumer that will call methods on DeleteAnomalyMonitorRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the DeleteAnomalyMonitor 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.
        • UnknownMonitorException The cost anomaly monitor does not exist for the account.
        • 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

      • deleteAnomalySubscription

        default CompletableFuture<DeleteAnomalySubscriptionResponse> deleteAnomalySubscription​(DeleteAnomalySubscriptionRequest deleteAnomalySubscriptionRequest)

        Deletes a cost anomaly subscription.

        Parameters:
        deleteAnomalySubscriptionRequest -
        Returns:
        A Java Future containing the result of the DeleteAnomalySubscription 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.
        • UnknownSubscriptionException The cost anomaly subscription does not exist for the account.
        • 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

      • deleteAnomalySubscription

        default CompletableFuture<DeleteAnomalySubscriptionResponse> deleteAnomalySubscription​(Consumer<DeleteAnomalySubscriptionRequest.Builder> deleteAnomalySubscriptionRequest)

        Deletes a cost anomaly subscription.


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

        Parameters:
        deleteAnomalySubscriptionRequest - A Consumer that will call methods on DeleteAnomalySubscriptionRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the DeleteAnomalySubscription 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.
        • UnknownSubscriptionException The cost anomaly subscription does not exist for the account.
        • 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

      • deleteCostCategoryDefinition

        default CompletableFuture<DeleteCostCategoryDefinitionResponse> deleteCostCategoryDefinition​(DeleteCostCategoryDefinitionRequest deleteCostCategoryDefinitionRequest)

        Deletes a Cost Category. Expenses from this month going forward will no longer be categorized with this Cost Category.

        Parameters:
        deleteCostCategoryDefinitionRequest -
        Returns:
        A Java Future containing the result of the DeleteCostCategoryDefinition operation returned by the service.
        The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
        • ResourceNotFoundException The specified ARN in the request doesn't exist.
        • 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

      • deleteCostCategoryDefinition

        default CompletableFuture<DeleteCostCategoryDefinitionResponse> deleteCostCategoryDefinition​(Consumer<DeleteCostCategoryDefinitionRequest.Builder> deleteCostCategoryDefinitionRequest)

        Deletes a Cost Category. Expenses from this month going forward will no longer be categorized with this Cost Category.


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

        Parameters:
        deleteCostCategoryDefinitionRequest - A Consumer that will call methods on DeleteCostCategoryDefinitionRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the DeleteCostCategoryDefinition operation returned by the service.
        The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
        • ResourceNotFoundException The specified ARN in the request doesn't exist.
        • 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

      • describeCostCategoryDefinition

        default CompletableFuture<DescribeCostCategoryDefinitionResponse> describeCostCategoryDefinition​(DescribeCostCategoryDefinitionRequest describeCostCategoryDefinitionRequest)

        Returns the name, Amazon Resource Name (ARN), rules, definition, and effective dates of a Cost Category that's defined in the account.

        You have the option to use EffectiveOn to return a Cost Category that's active on a specific date. If there's no EffectiveOn specified, you see a Cost Category that's effective on the current date. If Cost Category is still effective, EffectiveEnd is omitted in the response.

        Parameters:
        describeCostCategoryDefinitionRequest -
        Returns:
        A Java Future containing the result of the DescribeCostCategoryDefinition operation returned by the service.
        The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
        • ResourceNotFoundException The specified ARN in the request doesn't exist.
        • 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

      • describeCostCategoryDefinition

        default CompletableFuture<DescribeCostCategoryDefinitionResponse> describeCostCategoryDefinition​(Consumer<DescribeCostCategoryDefinitionRequest.Builder> describeCostCategoryDefinitionRequest)

        Returns the name, Amazon Resource Name (ARN), rules, definition, and effective dates of a Cost Category that's defined in the account.

        You have the option to use EffectiveOn to return a Cost Category that's active on a specific date. If there's no EffectiveOn specified, you see a Cost Category that's effective on the current date. If Cost Category is still effective, EffectiveEnd is omitted in the response.


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

        Parameters:
        describeCostCategoryDefinitionRequest - A Consumer that will call methods on DescribeCostCategoryDefinitionRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the DescribeCostCategoryDefinition operation returned by the service.
        The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
        • ResourceNotFoundException The specified ARN in the request doesn't exist.
        • 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

      • getAnomalies

        default CompletableFuture<GetAnomaliesResponse> getAnomalies​(GetAnomaliesRequest getAnomaliesRequest)

        Retrieves all of the cost anomalies detected on your account during the time period that's specified by the DateInterval object. Anomalies are available for up to 90 days.

        Parameters:
        getAnomaliesRequest -
        Returns:
        A Java Future containing the result of the GetAnomalies 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.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getAnomalies

        default CompletableFuture<GetAnomaliesResponse> getAnomalies​(Consumer<GetAnomaliesRequest.Builder> getAnomaliesRequest)

        Retrieves all of the cost anomalies detected on your account during the time period that's specified by the DateInterval object. Anomalies are available for up to 90 days.


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

        Parameters:
        getAnomaliesRequest - A Consumer that will call methods on GetAnomaliesRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the GetAnomalies 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.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getAnomalyMonitors

        default CompletableFuture<GetAnomalyMonitorsResponse> getAnomalyMonitors​(GetAnomalyMonitorsRequest getAnomalyMonitorsRequest)

        Retrieves the cost anomaly monitor definitions for your account. You can filter using a list of cost anomaly monitor Amazon Resource Names (ARNs).

        Parameters:
        getAnomalyMonitorsRequest -
        Returns:
        A Java Future containing the result of the GetAnomalyMonitors 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.
        • UnknownMonitorException The cost anomaly monitor does not exist for the account.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getAnomalyMonitors

        default CompletableFuture<GetAnomalyMonitorsResponse> getAnomalyMonitors​(Consumer<GetAnomalyMonitorsRequest.Builder> getAnomalyMonitorsRequest)

        Retrieves the cost anomaly monitor definitions for your account. You can filter using a list of cost anomaly monitor Amazon Resource Names (ARNs).


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

        Parameters:
        getAnomalyMonitorsRequest - A Consumer that will call methods on GetAnomalyMonitorsRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the GetAnomalyMonitors 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.
        • UnknownMonitorException The cost anomaly monitor does not exist for the account.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getAnomalySubscriptions

        default CompletableFuture<GetAnomalySubscriptionsResponse> getAnomalySubscriptions​(GetAnomalySubscriptionsRequest getAnomalySubscriptionsRequest)

        Retrieves the cost anomaly subscription objects for your account. You can filter using a list of cost anomaly monitor Amazon Resource Names (ARNs).

        Parameters:
        getAnomalySubscriptionsRequest -
        Returns:
        A Java Future containing the result of the GetAnomalySubscriptions 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.
        • UnknownSubscriptionException The cost anomaly subscription does not exist for the account.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getAnomalySubscriptions

        default CompletableFuture<GetAnomalySubscriptionsResponse> getAnomalySubscriptions​(Consumer<GetAnomalySubscriptionsRequest.Builder> getAnomalySubscriptionsRequest)

        Retrieves the cost anomaly subscription objects for your account. You can filter using a list of cost anomaly monitor Amazon Resource Names (ARNs).


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

        Parameters:
        getAnomalySubscriptionsRequest - A Consumer that will call methods on GetAnomalySubscriptionsRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the GetAnomalySubscriptions 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.
        • UnknownSubscriptionException The cost anomaly subscription does not exist for the account.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getApproximateUsageRecords

        default CompletableFuture<GetApproximateUsageRecordsResponse> getApproximateUsageRecords​(GetApproximateUsageRecordsRequest getApproximateUsageRecordsRequest)

        Retrieves estimated usage records for hourly granularity or resource-level data at daily granularity.

        Parameters:
        getApproximateUsageRecordsRequest -
        Returns:
        A Java Future containing the result of the GetApproximateUsageRecords 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.
        • DataUnavailableException The requested data is unavailable.
        • 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

      • getApproximateUsageRecords

        default CompletableFuture<GetApproximateUsageRecordsResponse> getApproximateUsageRecords​(Consumer<GetApproximateUsageRecordsRequest.Builder> getApproximateUsageRecordsRequest)

        Retrieves estimated usage records for hourly granularity or resource-level data at daily granularity.


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

        Parameters:
        getApproximateUsageRecordsRequest - A Consumer that will call methods on GetApproximateUsageRecordsRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the GetApproximateUsageRecords 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.
        • DataUnavailableException The requested data is unavailable.
        • 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​(GetCostAndUsageRequest getCostAndUsageRequest)

        Retrieves cost and usage metrics for your account. You can specify which cost and usage-related metric that you want the request to return. For example, you can specify BlendedCosts or UsageQuantity. You can also filter and group your data by various dimensions, such as SERVICE or AZ, in a specific time range. For a complete list of valid dimensions, see the GetDimensionValues operation. Management account in an organization in Organizations have access to all member accounts.

        For information about filter limitations, see Quotas and restrictions in the Billing and Cost Management User Guide.

        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.
        • BillExpirationException The requested report expired. Update the date interval and try again.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • RequestChangedException Your request parameters changed between pages. Try again with the old parameters or without a pagination token.
        • 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)

        Retrieves cost and usage metrics for your account. You can specify which cost and usage-related metric that you want the request to return. For example, you can specify BlendedCosts or UsageQuantity. You can also filter and group your data by various dimensions, such as SERVICE or AZ, in a specific time range. For a complete list of valid dimensions, see the GetDimensionValues operation. Management account in an organization in Organizations have access to all member accounts.

        For information about filter limitations, see Quotas and restrictions in the Billing and Cost Management User Guide.


        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.
        • BillExpirationException The requested report expired. Update the date interval and try again.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • RequestChangedException Your request parameters changed between pages. Try again with the old parameters or without a pagination token.
        • 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

      • getCostAndUsageWithResources

        default CompletableFuture<GetCostAndUsageWithResourcesResponse> getCostAndUsageWithResources​(GetCostAndUsageWithResourcesRequest getCostAndUsageWithResourcesRequest)

        Retrieves cost and usage metrics with resources 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 SERVICE or AZ, in a specific time range. For a complete list of valid dimensions, see the GetDimensionValues operation. Management account in an organization in Organizations have access to all member accounts. This API is currently available for the Amazon Elastic Compute Cloud – Compute service only.

        This is an opt-in only feature. You can enable this feature from the Cost Explorer Settings page. For information about how to access the Settings page, see Controlling Access for Cost Explorer in the Billing and Cost Management User Guide.

        Parameters:
        getCostAndUsageWithResourcesRequest -
        Returns:
        A Java Future containing the result of the GetCostAndUsageWithResources operation returned by the service.
        The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
        • DataUnavailableException The requested data is unavailable.
        • LimitExceededException You made too many calls in a short period of time. Try again later.
        • BillExpirationException The requested report expired. Update the date interval and try again.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • RequestChangedException Your request parameters changed between pages. Try again with the old parameters or without a pagination token.
        • 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

      • getCostAndUsageWithResources

        default CompletableFuture<GetCostAndUsageWithResourcesResponse> getCostAndUsageWithResources​(Consumer<GetCostAndUsageWithResourcesRequest.Builder> getCostAndUsageWithResourcesRequest)

        Retrieves cost and usage metrics with resources 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 SERVICE or AZ, in a specific time range. For a complete list of valid dimensions, see the GetDimensionValues operation. Management account in an organization in Organizations have access to all member accounts. This API is currently available for the Amazon Elastic Compute Cloud – Compute service only.

        This is an opt-in only feature. You can enable this feature from the Cost Explorer Settings page. For information about how to access the Settings page, see Controlling Access for Cost Explorer in the Billing and Cost Management User Guide.


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

        Parameters:
        getCostAndUsageWithResourcesRequest - A Consumer that will call methods on GetCostAndUsageWithResourcesRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the GetCostAndUsageWithResources operation returned by the service.
        The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
        • DataUnavailableException The requested data is unavailable.
        • LimitExceededException You made too many calls in a short period of time. Try again later.
        • BillExpirationException The requested report expired. Update the date interval and try again.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • RequestChangedException Your request parameters changed between pages. Try again with the old parameters or without a pagination token.
        • 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

      • getCostCategories

        default CompletableFuture<GetCostCategoriesResponse> getCostCategories​(GetCostCategoriesRequest getCostCategoriesRequest)

        Retrieves an array of Cost Category names and values incurred cost.

        If some Cost Category names and values are not associated with any cost, they will not be returned by this API.

        Parameters:
        getCostCategoriesRequest -
        Returns:
        A Java Future containing the result of the GetCostCategories 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.
        • BillExpirationException The requested report expired. Update the date interval and try again.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • RequestChangedException Your request parameters changed between pages. Try again with the old parameters or without a pagination token.
        • 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

      • getCostCategories

        default CompletableFuture<GetCostCategoriesResponse> getCostCategories​(Consumer<GetCostCategoriesRequest.Builder> getCostCategoriesRequest)

        Retrieves an array of Cost Category names and values incurred cost.

        If some Cost Category names and values are not associated with any cost, they will not be returned by this API.


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

        Parameters:
        getCostCategoriesRequest - A Consumer that will call methods on GetCostCategoriesRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the GetCostCategories 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.
        • BillExpirationException The requested report expired. Update the date interval and try again.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • RequestChangedException Your request parameters changed between pages. Try again with the old parameters or without a pagination token.
        • 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

      • getCostForecast

        default CompletableFuture<GetCostForecastResponse> getCostForecast​(GetCostForecastRequest getCostForecastRequest)

        Retrieves a forecast for how much Amazon Web Services predicts that you will spend over the forecast time period that you select, based on your past costs.

        Parameters:
        getCostForecastRequest -
        Returns:
        A Java Future containing the result of the GetCostForecast 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.
        • DataUnavailableException The requested data is unavailable.
        • 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

      • getCostForecast

        default CompletableFuture<GetCostForecastResponse> getCostForecast​(Consumer<GetCostForecastRequest.Builder> getCostForecastRequest)

        Retrieves a forecast for how much Amazon Web Services predicts that you will spend over the forecast time period that you select, based on your past costs.


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

        Parameters:
        getCostForecastRequest - A Consumer that will call methods on GetCostForecastRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the GetCostForecast 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.
        • DataUnavailableException The requested data is unavailable.
        • 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)

        Retrieves all available filter values for a specified 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.
        • BillExpirationException The requested report expired. Update the date interval and try again.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • RequestChangedException Your request parameters changed between pages. Try again with the old parameters or without a pagination token.
        • 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)

        Retrieves all available filter values for a specified 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.
        • BillExpirationException The requested report expired. Update the date interval and try again.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • RequestChangedException Your request parameters changed between pages. Try again with the old parameters or without a pagination token.
        • 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

      • getReservationCoverage

        default CompletableFuture<GetReservationCoverageResponse> getReservationCoverage​(GetReservationCoverageRequest getReservationCoverageRequest)

        Retrieves the reservation coverage for your account, which you can use to see how much of your Amazon Elastic Compute Cloud, Amazon ElastiCache, Amazon Relational Database Service, or Amazon Redshift usage is covered by a reservation. An organization's management account can see the coverage of the associated member accounts. This supports dimensions, Cost Categories, and nested expressions. For any time period, you can filter data about reservation usage by the following dimensions:

        • AZ

        • CACHE_ENGINE

        • DATABASE_ENGINE

        • DEPLOYMENT_OPTION

        • INSTANCE_TYPE

        • LINKED_ACCOUNT

        • OPERATING_SYSTEM

        • PLATFORM

        • REGION

        • SERVICE

        • TAG

        • TENANCY

        To determine valid values for a dimension, use the GetDimensionValues operation.

        Parameters:
        getReservationCoverageRequest - You can use the following request parameters to query for how much of your instance usage a reservation covered.
        Returns:
        A Java Future containing the result of the GetReservationCoverage 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.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getReservationCoverage

        default CompletableFuture<GetReservationCoverageResponse> getReservationCoverage​(Consumer<GetReservationCoverageRequest.Builder> getReservationCoverageRequest)

        Retrieves the reservation coverage for your account, which you can use to see how much of your Amazon Elastic Compute Cloud, Amazon ElastiCache, Amazon Relational Database Service, or Amazon Redshift usage is covered by a reservation. An organization's management account can see the coverage of the associated member accounts. This supports dimensions, Cost Categories, and nested expressions. For any time period, you can filter data about reservation usage by the following dimensions:

        • AZ

        • CACHE_ENGINE

        • DATABASE_ENGINE

        • DEPLOYMENT_OPTION

        • INSTANCE_TYPE

        • LINKED_ACCOUNT

        • OPERATING_SYSTEM

        • PLATFORM

        • REGION

        • SERVICE

        • TAG

        • TENANCY

        To determine valid values for a dimension, use the GetDimensionValues operation.


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

        Parameters:
        getReservationCoverageRequest - A Consumer that will call methods on GetReservationCoverageRequest.Builder to create a request. You can use the following request parameters to query for how much of your instance usage a reservation covered.
        Returns:
        A Java Future containing the result of the GetReservationCoverage 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.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getReservationPurchaseRecommendation

        default CompletableFuture<GetReservationPurchaseRecommendationResponse> getReservationPurchaseRecommendation​(GetReservationPurchaseRecommendationRequest getReservationPurchaseRecommendationRequest)

        Gets recommendations for reservation purchases. These recommendations might help you to reduce your costs. Reservations provide a discounted hourly rate (up to 75%) compared to On-Demand pricing.

        Amazon Web Services generates your recommendations by identifying your On-Demand usage during a specific time period and collecting your usage into categories that are eligible for a reservation. After Amazon Web Services has these categories, it simulates every combination of reservations in each category of usage to identify the best number of each type of Reserved Instance (RI) to purchase to maximize your estimated savings.

        For example, Amazon Web Services automatically aggregates your Amazon EC2 Linux, shared tenancy, and c4 family usage in the US West (Oregon) Region and recommends that you buy size-flexible regional reservations to apply to the c4 family usage. Amazon Web Services recommends the smallest size instance in an instance family. This makes it easier to purchase a size-flexible Reserved Instance (RI). Amazon Web Services also shows the equal number of normalized units. This way, you can purchase any instance size that you want. For this example, your RI recommendation is for c4.large because that is the smallest size instance in the c4 instance family.

        Parameters:
        getReservationPurchaseRecommendationRequest -
        Returns:
        A Java Future containing the result of the GetReservationPurchaseRecommendation 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.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getReservationPurchaseRecommendation

        default CompletableFuture<GetReservationPurchaseRecommendationResponse> getReservationPurchaseRecommendation​(Consumer<GetReservationPurchaseRecommendationRequest.Builder> getReservationPurchaseRecommendationRequest)

        Gets recommendations for reservation purchases. These recommendations might help you to reduce your costs. Reservations provide a discounted hourly rate (up to 75%) compared to On-Demand pricing.

        Amazon Web Services generates your recommendations by identifying your On-Demand usage during a specific time period and collecting your usage into categories that are eligible for a reservation. After Amazon Web Services has these categories, it simulates every combination of reservations in each category of usage to identify the best number of each type of Reserved Instance (RI) to purchase to maximize your estimated savings.

        For example, Amazon Web Services automatically aggregates your Amazon EC2 Linux, shared tenancy, and c4 family usage in the US West (Oregon) Region and recommends that you buy size-flexible regional reservations to apply to the c4 family usage. Amazon Web Services recommends the smallest size instance in an instance family. This makes it easier to purchase a size-flexible Reserved Instance (RI). Amazon Web Services also shows the equal number of normalized units. This way, you can purchase any instance size that you want. For this example, your RI recommendation is for c4.large because that is the smallest size instance in the c4 instance family.


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

        Parameters:
        getReservationPurchaseRecommendationRequest - A Consumer that will call methods on GetReservationPurchaseRecommendationRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the GetReservationPurchaseRecommendation 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.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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)

        Retrieves the reservation utilization for your account. Management account in an organization have access to 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.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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)

        Retrieves the reservation utilization for your account. Management account in an organization have access to 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.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getRightsizingRecommendation

        default CompletableFuture<GetRightsizingRecommendationResponse> getRightsizingRecommendation​(GetRightsizingRecommendationRequest getRightsizingRecommendationRequest)

        Creates recommendations that help you save cost by identifying idle and underutilized Amazon EC2 instances.

        Recommendations are generated to either downsize or terminate instances, along with providing savings detail and metrics. For more information about calculation and function, see Optimizing Your Cost with Rightsizing Recommendations in the Billing and Cost Management User Guide.

        Parameters:
        getRightsizingRecommendationRequest -
        Returns:
        A Java Future containing the result of the GetRightsizingRecommendation 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.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getRightsizingRecommendation

        default CompletableFuture<GetRightsizingRecommendationResponse> getRightsizingRecommendation​(Consumer<GetRightsizingRecommendationRequest.Builder> getRightsizingRecommendationRequest)

        Creates recommendations that help you save cost by identifying idle and underutilized Amazon EC2 instances.

        Recommendations are generated to either downsize or terminate instances, along with providing savings detail and metrics. For more information about calculation and function, see Optimizing Your Cost with Rightsizing Recommendations in the Billing and Cost Management User Guide.


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

        Parameters:
        getRightsizingRecommendationRequest - A Consumer that will call methods on GetRightsizingRecommendationRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the GetRightsizingRecommendation 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.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getSavingsPlanPurchaseRecommendationDetails

        default CompletableFuture<GetSavingsPlanPurchaseRecommendationDetailsResponse> getSavingsPlanPurchaseRecommendationDetails​(GetSavingsPlanPurchaseRecommendationDetailsRequest getSavingsPlanPurchaseRecommendationDetailsRequest)

        Retrieves the details for a Savings Plan recommendation. These details include the hourly data-points that construct the cost, coverage, and utilization charts.

        Parameters:
        getSavingsPlanPurchaseRecommendationDetailsRequest -
        Returns:
        A Java Future containing the result of the GetSavingsPlanPurchaseRecommendationDetails 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.
        • DataUnavailableException The requested data is unavailable.
        • 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

      • getSavingsPlansCoverage

        default CompletableFuture<GetSavingsPlansCoverageResponse> getSavingsPlansCoverage​(GetSavingsPlansCoverageRequest getSavingsPlansCoverageRequest)

        Retrieves the Savings Plans covered for your account. This enables you to see how much of your cost is covered by a Savings Plan. An organization’s management account can see the coverage of the associated member accounts. This supports dimensions, Cost Categories, and nested expressions. For any time period, you can filter data for Savings Plans usage with the following dimensions:

        • LINKED_ACCOUNT

        • REGION

        • SERVICE

        • INSTANCE_FAMILY

        To determine valid values for a dimension, use the GetDimensionValues operation.

        Parameters:
        getSavingsPlansCoverageRequest -
        Returns:
        A Java Future containing the result of the GetSavingsPlansCoverage 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.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getSavingsPlansCoverage

        default CompletableFuture<GetSavingsPlansCoverageResponse> getSavingsPlansCoverage​(Consumer<GetSavingsPlansCoverageRequest.Builder> getSavingsPlansCoverageRequest)

        Retrieves the Savings Plans covered for your account. This enables you to see how much of your cost is covered by a Savings Plan. An organization’s management account can see the coverage of the associated member accounts. This supports dimensions, Cost Categories, and nested expressions. For any time period, you can filter data for Savings Plans usage with the following dimensions:

        • LINKED_ACCOUNT

        • REGION

        • SERVICE

        • INSTANCE_FAMILY

        To determine valid values for a dimension, use the GetDimensionValues operation.


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

        Parameters:
        getSavingsPlansCoverageRequest - A Consumer that will call methods on GetSavingsPlansCoverageRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the GetSavingsPlansCoverage 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.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getSavingsPlansCoveragePaginator

        default GetSavingsPlansCoveragePublisher getSavingsPlansCoveragePaginator​(GetSavingsPlansCoverageRequest getSavingsPlansCoverageRequest)

        This is a variant of getSavingsPlansCoverage(software.amazon.awssdk.services.costexplorer.model.GetSavingsPlansCoverageRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

        When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

        The following are few ways to use the response class:

        1) Using the subscribe helper method 
         
 software.amazon.awssdk.services.costexplorer.paginators.GetSavingsPlansCoveragePublisher publisher = client.getSavingsPlansCoveragePaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
        2) Using a custom subscriber 
         
 software.amazon.awssdk.services.costexplorer.paginators.GetSavingsPlansCoveragePublisher publisher = client.getSavingsPlansCoveragePaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.costexplorer.model.GetSavingsPlansCoverageResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.costexplorer.model.GetSavingsPlansCoverageResponse response) { //... };
 });
        As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

        Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

        Note: If you prefer to have control on service calls, use the getSavingsPlansCoverage(software.amazon.awssdk.services.costexplorer.model.GetSavingsPlansCoverageRequest) operation.

        Parameters:
        getSavingsPlansCoverageRequest -
        Returns:
        A custom publisher that can be subscribed to request a stream of response pages.
        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.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getSavingsPlansCoveragePaginator

        default GetSavingsPlansCoveragePublisher getSavingsPlansCoveragePaginator​(Consumer<GetSavingsPlansCoverageRequest.Builder> getSavingsPlansCoverageRequest)

        This is a variant of getSavingsPlansCoverage(software.amazon.awssdk.services.costexplorer.model.GetSavingsPlansCoverageRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

        When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

        The following are few ways to use the response class:

        1) Using the subscribe helper method 
         
 software.amazon.awssdk.services.costexplorer.paginators.GetSavingsPlansCoveragePublisher publisher = client.getSavingsPlansCoveragePaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
        2) Using a custom subscriber 
         
 software.amazon.awssdk.services.costexplorer.paginators.GetSavingsPlansCoveragePublisher publisher = client.getSavingsPlansCoveragePaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.costexplorer.model.GetSavingsPlansCoverageResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.costexplorer.model.GetSavingsPlansCoverageResponse response) { //... };
 });
        As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

        Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

        Note: If you prefer to have control on service calls, use the getSavingsPlansCoverage(software.amazon.awssdk.services.costexplorer.model.GetSavingsPlansCoverageRequest) operation.


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

        Parameters:
        getSavingsPlansCoverageRequest - A Consumer that will call methods on GetSavingsPlansCoverageRequest.Builder to create a request.
        Returns:
        A custom publisher that can be subscribed to request a stream of response pages.
        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.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getSavingsPlansPurchaseRecommendation

        default CompletableFuture<GetSavingsPlansPurchaseRecommendationResponse> getSavingsPlansPurchaseRecommendation​(GetSavingsPlansPurchaseRecommendationRequest getSavingsPlansPurchaseRecommendationRequest)

        Retrieves the Savings Plans recommendations for your account. First use StartSavingsPlansPurchaseRecommendationGeneration to generate a new set of recommendations, and then use GetSavingsPlansPurchaseRecommendation to retrieve them.

        Parameters:
        getSavingsPlansPurchaseRecommendationRequest -
        Returns:
        A Java Future containing the result of the GetSavingsPlansPurchaseRecommendation 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.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getSavingsPlansPurchaseRecommendation

        default CompletableFuture<GetSavingsPlansPurchaseRecommendationResponse> getSavingsPlansPurchaseRecommendation​(Consumer<GetSavingsPlansPurchaseRecommendationRequest.Builder> getSavingsPlansPurchaseRecommendationRequest)

        Retrieves the Savings Plans recommendations for your account. First use StartSavingsPlansPurchaseRecommendationGeneration to generate a new set of recommendations, and then use GetSavingsPlansPurchaseRecommendation to retrieve them.


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

        Parameters:
        getSavingsPlansPurchaseRecommendationRequest - A Consumer that will call methods on GetSavingsPlansPurchaseRecommendationRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the GetSavingsPlansPurchaseRecommendation 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.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getSavingsPlansUtilization

        default CompletableFuture<GetSavingsPlansUtilizationResponse> getSavingsPlansUtilization​(GetSavingsPlansUtilizationRequest getSavingsPlansUtilizationRequest)

        Retrieves the Savings Plans utilization for your account across date ranges with daily or monthly granularity. Management account in an organization have access to member accounts. You can use GetDimensionValues in SAVINGS_PLANS to determine the possible dimension values.

        You can't group by any dimension values for GetSavingsPlansUtilization.

        Parameters:
        getSavingsPlansUtilizationRequest -
        Returns:
        A Java Future containing the result of the GetSavingsPlansUtilization 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.
        • DataUnavailableException The requested data is unavailable.
        • 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

      • getSavingsPlansUtilization

        default CompletableFuture<GetSavingsPlansUtilizationResponse> getSavingsPlansUtilization​(Consumer<GetSavingsPlansUtilizationRequest.Builder> getSavingsPlansUtilizationRequest)

        Retrieves the Savings Plans utilization for your account across date ranges with daily or monthly granularity. Management account in an organization have access to member accounts. You can use GetDimensionValues in SAVINGS_PLANS to determine the possible dimension values.

        You can't group by any dimension values for GetSavingsPlansUtilization.


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

        Parameters:
        getSavingsPlansUtilizationRequest - A Consumer that will call methods on GetSavingsPlansUtilizationRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the GetSavingsPlansUtilization 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.
        • DataUnavailableException The requested data is unavailable.
        • 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

      • getSavingsPlansUtilizationDetails

        default CompletableFuture<GetSavingsPlansUtilizationDetailsResponse> getSavingsPlansUtilizationDetails​(GetSavingsPlansUtilizationDetailsRequest getSavingsPlansUtilizationDetailsRequest)

        Retrieves attribute data along with aggregate utilization and savings data for a given time period. This doesn't support granular or grouped data (daily/monthly) in response. You can't retrieve data by dates in a single response similar to GetSavingsPlanUtilization, but you have the option to make multiple calls to GetSavingsPlanUtilizationDetails by providing individual dates. You can use GetDimensionValues in SAVINGS_PLANS to determine the possible dimension values.

        GetSavingsPlanUtilizationDetails internally groups data by SavingsPlansArn.

        Parameters:
        getSavingsPlansUtilizationDetailsRequest -
        Returns:
        A Java Future containing the result of the GetSavingsPlansUtilizationDetails 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.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getSavingsPlansUtilizationDetails

        default CompletableFuture<GetSavingsPlansUtilizationDetailsResponse> getSavingsPlansUtilizationDetails​(Consumer<GetSavingsPlansUtilizationDetailsRequest.Builder> getSavingsPlansUtilizationDetailsRequest)

        Retrieves attribute data along with aggregate utilization and savings data for a given time period. This doesn't support granular or grouped data (daily/monthly) in response. You can't retrieve data by dates in a single response similar to GetSavingsPlanUtilization, but you have the option to make multiple calls to GetSavingsPlanUtilizationDetails by providing individual dates. You can use GetDimensionValues in SAVINGS_PLANS to determine the possible dimension values.

        GetSavingsPlanUtilizationDetails internally groups data by SavingsPlansArn.


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

        Parameters:
        getSavingsPlansUtilizationDetailsRequest - A Consumer that will call methods on GetSavingsPlansUtilizationDetailsRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the GetSavingsPlansUtilizationDetails 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.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getSavingsPlansUtilizationDetailsPaginator

        default GetSavingsPlansUtilizationDetailsPublisher getSavingsPlansUtilizationDetailsPaginator​(GetSavingsPlansUtilizationDetailsRequest getSavingsPlansUtilizationDetailsRequest)

        This is a variant of getSavingsPlansUtilizationDetails(software.amazon.awssdk.services.costexplorer.model.GetSavingsPlansUtilizationDetailsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

        When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

        The following are few ways to use the response class:

        1) Using the subscribe helper method 
         
 software.amazon.awssdk.services.costexplorer.paginators.GetSavingsPlansUtilizationDetailsPublisher publisher = client.getSavingsPlansUtilizationDetailsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
        2) Using a custom subscriber 
         
 software.amazon.awssdk.services.costexplorer.paginators.GetSavingsPlansUtilizationDetailsPublisher publisher = client.getSavingsPlansUtilizationDetailsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.costexplorer.model.GetSavingsPlansUtilizationDetailsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.costexplorer.model.GetSavingsPlansUtilizationDetailsResponse response) { //... };
 });
        As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

        Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

        Note: If you prefer to have control on service calls, use the getSavingsPlansUtilizationDetails(software.amazon.awssdk.services.costexplorer.model.GetSavingsPlansUtilizationDetailsRequest) operation.

        Parameters:
        getSavingsPlansUtilizationDetailsRequest -
        Returns:
        A custom publisher that can be subscribed to request a stream of response pages.
        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.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • getSavingsPlansUtilizationDetailsPaginator

        default GetSavingsPlansUtilizationDetailsPublisher getSavingsPlansUtilizationDetailsPaginator​(Consumer<GetSavingsPlansUtilizationDetailsRequest.Builder> getSavingsPlansUtilizationDetailsRequest)

        This is a variant of getSavingsPlansUtilizationDetails(software.amazon.awssdk.services.costexplorer.model.GetSavingsPlansUtilizationDetailsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

        When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

        The following are few ways to use the response class:

        1) Using the subscribe helper method 
         
 software.amazon.awssdk.services.costexplorer.paginators.GetSavingsPlansUtilizationDetailsPublisher publisher = client.getSavingsPlansUtilizationDetailsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
        2) Using a custom subscriber 
         
 software.amazon.awssdk.services.costexplorer.paginators.GetSavingsPlansUtilizationDetailsPublisher publisher = client.getSavingsPlansUtilizationDetailsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.costexplorer.model.GetSavingsPlansUtilizationDetailsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.costexplorer.model.GetSavingsPlansUtilizationDetailsResponse response) { //... };
 });
        As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

        Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

        Note: If you prefer to have control on service calls, use the getSavingsPlansUtilizationDetails(software.amazon.awssdk.services.costexplorer.model.GetSavingsPlansUtilizationDetailsRequest) operation.


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

        Parameters:
        getSavingsPlansUtilizationDetailsRequest - A Consumer that will call methods on GetSavingsPlansUtilizationDetailsRequest.Builder to create a request.
        Returns:
        A custom publisher that can be subscribed to request a stream of response pages.
        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.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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)

        Queries 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.
        • BillExpirationException The requested report expired. Update the date interval and try again.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • RequestChangedException Your request parameters changed between pages. Try again with the old parameters or without a pagination token.
        • 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)

        Queries 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.
        • BillExpirationException The requested report expired. Update the date interval and try again.
        • DataUnavailableException The requested data is unavailable.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • RequestChangedException Your request parameters changed between pages. Try again with the old parameters or without a pagination token.
        • 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

      • getUsageForecast

        default CompletableFuture<GetUsageForecastResponse> getUsageForecast​(GetUsageForecastRequest getUsageForecastRequest)

        Retrieves a forecast for how much Amazon Web Services predicts that you will use over the forecast time period that you select, based on your past usage.

        Parameters:
        getUsageForecastRequest -
        Returns:
        A Java Future containing the result of the GetUsageForecast 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.
        • DataUnavailableException The requested data is unavailable.
        • UnresolvableUsageUnitException Cost Explorer was unable to identify the usage unit. Provide UsageType/UsageTypeGroup filter selections that contain matching units, for example: hours.
        • 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

      • getUsageForecast

        default CompletableFuture<GetUsageForecastResponse> getUsageForecast​(Consumer<GetUsageForecastRequest.Builder> getUsageForecastRequest)

        Retrieves a forecast for how much Amazon Web Services predicts that you will use over the forecast time period that you select, based on your past usage.


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

        Parameters:
        getUsageForecastRequest - A Consumer that will call methods on GetUsageForecastRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the GetUsageForecast 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.
        • DataUnavailableException The requested data is unavailable.
        • UnresolvableUsageUnitException Cost Explorer was unable to identify the usage unit. Provide UsageType/UsageTypeGroup filter selections that contain matching units, for example: hours.
        • 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

      • listCostAllocationTags

        default CompletableFuture<ListCostAllocationTagsResponse> listCostAllocationTags​(ListCostAllocationTagsRequest listCostAllocationTagsRequest)

        Get a list of cost allocation tags. All inputs in the API are optional and serve as filters. By default, all cost allocation tags are returned.

        Parameters:
        listCostAllocationTagsRequest -
        Returns:
        A Java Future containing the result of the ListCostAllocationTags 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.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • listCostAllocationTags

        default CompletableFuture<ListCostAllocationTagsResponse> listCostAllocationTags​(Consumer<ListCostAllocationTagsRequest.Builder> listCostAllocationTagsRequest)

        Get a list of cost allocation tags. All inputs in the API are optional and serve as filters. By default, all cost allocation tags are returned.


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

        Parameters:
        listCostAllocationTagsRequest - A Consumer that will call methods on ListCostAllocationTagsRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the ListCostAllocationTags 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.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • listCostAllocationTagsPaginator

        default ListCostAllocationTagsPublisher listCostAllocationTagsPaginator​(ListCostAllocationTagsRequest listCostAllocationTagsRequest)

        This is a variant of listCostAllocationTags(software.amazon.awssdk.services.costexplorer.model.ListCostAllocationTagsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

        When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

        The following are few ways to use the response class:

        1) Using the subscribe helper method 
         
 software.amazon.awssdk.services.costexplorer.paginators.ListCostAllocationTagsPublisher publisher = client.listCostAllocationTagsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
        2) Using a custom subscriber 
         
 software.amazon.awssdk.services.costexplorer.paginators.ListCostAllocationTagsPublisher publisher = client.listCostAllocationTagsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.costexplorer.model.ListCostAllocationTagsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.costexplorer.model.ListCostAllocationTagsResponse response) { //... };
 });
        As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

        Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

        Note: If you prefer to have control on service calls, use the listCostAllocationTags(software.amazon.awssdk.services.costexplorer.model.ListCostAllocationTagsRequest) operation.

        Parameters:
        listCostAllocationTagsRequest -
        Returns:
        A custom publisher that can be subscribed to request a stream of response pages.
        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.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • listCostAllocationTagsPaginator

        default ListCostAllocationTagsPublisher listCostAllocationTagsPaginator​(Consumer<ListCostAllocationTagsRequest.Builder> listCostAllocationTagsRequest)

        This is a variant of listCostAllocationTags(software.amazon.awssdk.services.costexplorer.model.ListCostAllocationTagsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

        When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

        The following are few ways to use the response class:

        1) Using the subscribe helper method 
         
 software.amazon.awssdk.services.costexplorer.paginators.ListCostAllocationTagsPublisher publisher = client.listCostAllocationTagsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
        2) Using a custom subscriber 
         
 software.amazon.awssdk.services.costexplorer.paginators.ListCostAllocationTagsPublisher publisher = client.listCostAllocationTagsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.costexplorer.model.ListCostAllocationTagsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.costexplorer.model.ListCostAllocationTagsResponse response) { //... };
 });
        As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

        Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

        Note: If you prefer to have control on service calls, use the listCostAllocationTags(software.amazon.awssdk.services.costexplorer.model.ListCostAllocationTagsRequest) operation.


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

        Parameters:
        listCostAllocationTagsRequest - A Consumer that will call methods on ListCostAllocationTagsRequest.Builder to create a request.
        Returns:
        A custom publisher that can be subscribed to request a stream of response pages.
        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.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • 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

      • listCostCategoryDefinitions

        default CompletableFuture<ListCostCategoryDefinitionsResponse> listCostCategoryDefinitions​(ListCostCategoryDefinitionsRequest listCostCategoryDefinitionsRequest)

        Returns the name, Amazon Resource Name (ARN), NumberOfRules and effective dates of all Cost Categories defined in the account. You have the option to use EffectiveOn to return a list of Cost Categories that were active on a specific date. If there is no EffectiveOn specified, you’ll see Cost Categories that are effective on the current date. If Cost Category is still effective, EffectiveEnd is omitted in the response. ListCostCategoryDefinitions supports pagination. The request can have a MaxResults range up to 100.

        Parameters:
        listCostCategoryDefinitionsRequest -
        Returns:
        A Java Future containing the result of the ListCostCategoryDefinitions 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

      • listCostCategoryDefinitions

        default CompletableFuture<ListCostCategoryDefinitionsResponse> listCostCategoryDefinitions​(Consumer<ListCostCategoryDefinitionsRequest.Builder> listCostCategoryDefinitionsRequest)

        Returns the name, Amazon Resource Name (ARN), NumberOfRules and effective dates of all Cost Categories defined in the account. You have the option to use EffectiveOn to return a list of Cost Categories that were active on a specific date. If there is no EffectiveOn specified, you’ll see Cost Categories that are effective on the current date. If Cost Category is still effective, EffectiveEnd is omitted in the response. ListCostCategoryDefinitions supports pagination. The request can have a MaxResults range up to 100.


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

        Parameters:
        listCostCategoryDefinitionsRequest - A Consumer that will call methods on ListCostCategoryDefinitionsRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the ListCostCategoryDefinitions 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

      • listCostCategoryDefinitionsPaginator

        default ListCostCategoryDefinitionsPublisher listCostCategoryDefinitionsPaginator​(ListCostCategoryDefinitionsRequest listCostCategoryDefinitionsRequest)

        This is a variant of listCostCategoryDefinitions(software.amazon.awssdk.services.costexplorer.model.ListCostCategoryDefinitionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

        When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

        The following are few ways to use the response class:

        1) Using the subscribe helper method 
         
 software.amazon.awssdk.services.costexplorer.paginators.ListCostCategoryDefinitionsPublisher publisher = client.listCostCategoryDefinitionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
        2) Using a custom subscriber 
         
 software.amazon.awssdk.services.costexplorer.paginators.ListCostCategoryDefinitionsPublisher publisher = client.listCostCategoryDefinitionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.costexplorer.model.ListCostCategoryDefinitionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.costexplorer.model.ListCostCategoryDefinitionsResponse response) { //... };
 });
        As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

        Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

        Note: If you prefer to have control on service calls, use the listCostCategoryDefinitions(software.amazon.awssdk.services.costexplorer.model.ListCostCategoryDefinitionsRequest) operation.

        Parameters:
        listCostCategoryDefinitionsRequest -
        Returns:
        A custom publisher that can be subscribed to request a stream of response pages.
        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

      • listCostCategoryDefinitionsPaginator

        default ListCostCategoryDefinitionsPublisher listCostCategoryDefinitionsPaginator​(Consumer<ListCostCategoryDefinitionsRequest.Builder> listCostCategoryDefinitionsRequest)

        This is a variant of listCostCategoryDefinitions(software.amazon.awssdk.services.costexplorer.model.ListCostCategoryDefinitionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

        When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

        The following are few ways to use the response class:

        1) Using the subscribe helper method 
         
 software.amazon.awssdk.services.costexplorer.paginators.ListCostCategoryDefinitionsPublisher publisher = client.listCostCategoryDefinitionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
        2) Using a custom subscriber 
         
 software.amazon.awssdk.services.costexplorer.paginators.ListCostCategoryDefinitionsPublisher publisher = client.listCostCategoryDefinitionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.costexplorer.model.ListCostCategoryDefinitionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.costexplorer.model.ListCostCategoryDefinitionsResponse response) { //... };
 });
        As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

        Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

        Note: If you prefer to have control on service calls, use the listCostCategoryDefinitions(software.amazon.awssdk.services.costexplorer.model.ListCostCategoryDefinitionsRequest) operation.


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

        Parameters:
        listCostCategoryDefinitionsRequest - A Consumer that will call methods on ListCostCategoryDefinitionsRequest.Builder to create a request.
        Returns:
        A custom publisher that can be subscribed to request a stream of response pages.
        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

      • listSavingsPlansPurchaseRecommendationGeneration

        default CompletableFuture<ListSavingsPlansPurchaseRecommendationGenerationResponse> listSavingsPlansPurchaseRecommendationGeneration​(ListSavingsPlansPurchaseRecommendationGenerationRequest listSavingsPlansPurchaseRecommendationGenerationRequest)

        Retrieves a list of your historical recommendation generations within the past 30 days.

        Parameters:
        listSavingsPlansPurchaseRecommendationGenerationRequest -
        Returns:
        A Java Future containing the result of the ListSavingsPlansPurchaseRecommendationGeneration 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.
        • InvalidNextTokenException The pagination token is invalid. Try again without a pagination token.
        • DataUnavailableException The requested data is unavailable.
        • 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

      • listTagsForResource

        default CompletableFuture<ListTagsForResourceResponse> listTagsForResource​(ListTagsForResourceRequest listTagsForResourceRequest)

        Returns a list of resource tags associated with the resource specified by the Amazon Resource Name (ARN).

        Parameters:
        listTagsForResourceRequest -
        Returns:
        A Java Future containing the result of the ListTagsForResource operation returned by the service.
        The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
        • ResourceNotFoundException The specified ARN in the request doesn't exist.
        • 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

      • listTagsForResource

        default CompletableFuture<ListTagsForResourceResponse> listTagsForResource​(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest)

        Returns a list of resource tags associated with the resource specified by the Amazon Resource Name (ARN).


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

        Parameters:
        listTagsForResourceRequest - A Consumer that will call methods on ListTagsForResourceRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the ListTagsForResource operation returned by the service.
        The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
        • ResourceNotFoundException The specified ARN in the request doesn't exist.
        • 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

      • provideAnomalyFeedback

        default CompletableFuture<ProvideAnomalyFeedbackResponse> provideAnomalyFeedback​(ProvideAnomalyFeedbackRequest provideAnomalyFeedbackRequest)

        Modifies the feedback property of a given cost anomaly.

        Parameters:
        provideAnomalyFeedbackRequest -
        Returns:
        A Java Future containing the result of the ProvideAnomalyFeedback 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

      • provideAnomalyFeedback

        default CompletableFuture<ProvideAnomalyFeedbackResponse> provideAnomalyFeedback​(Consumer<ProvideAnomalyFeedbackRequest.Builder> provideAnomalyFeedbackRequest)

        Modifies the feedback property of a given cost anomaly.


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

        Parameters:
        provideAnomalyFeedbackRequest - A Consumer that will call methods on ProvideAnomalyFeedbackRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the ProvideAnomalyFeedback 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

      • startSavingsPlansPurchaseRecommendationGeneration

        default CompletableFuture<StartSavingsPlansPurchaseRecommendationGenerationResponse> startSavingsPlansPurchaseRecommendationGeneration​(StartSavingsPlansPurchaseRecommendationGenerationRequest startSavingsPlansPurchaseRecommendationGenerationRequest)

        Requests a Savings Plans recommendation generation. This enables you to calculate a fresh set of Savings Plans recommendations that takes your latest usage data and current Savings Plans inventory into account. You can refresh Savings Plans recommendations up to three times daily for a consolidated billing family.

        StartSavingsPlansPurchaseRecommendationGeneration has no request syntax because no input parameters are needed to support this operation.

        Parameters:
        startSavingsPlansPurchaseRecommendationGenerationRequest -
        Returns:
        A Java Future containing the result of the StartSavingsPlansPurchaseRecommendationGeneration 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.
        • ServiceQuotaExceededException You've reached the limit on the number of resources you can create, or exceeded the size of an individual resource.
        • GenerationExistsException A request to generate a recommendation is already in progress.
        • DataUnavailableException The requested data is unavailable.
        • 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

      • startSavingsPlansPurchaseRecommendationGeneration

        default CompletableFuture<StartSavingsPlansPurchaseRecommendationGenerationResponse> startSavingsPlansPurchaseRecommendationGeneration​(Consumer<StartSavingsPlansPurchaseRecommendationGenerationRequest.Builder> startSavingsPlansPurchaseRecommendationGenerationRequest)

        Requests a Savings Plans recommendation generation. This enables you to calculate a fresh set of Savings Plans recommendations that takes your latest usage data and current Savings Plans inventory into account. You can refresh Savings Plans recommendations up to three times daily for a consolidated billing family.

        StartSavingsPlansPurchaseRecommendationGeneration has no request syntax because no input parameters are needed to support this operation.


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

        Parameters:
        startSavingsPlansPurchaseRecommendationGenerationRequest - A Consumer that will call methods on StartSavingsPlansPurchaseRecommendationGenerationRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the StartSavingsPlansPurchaseRecommendationGeneration 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.
        • ServiceQuotaExceededException You've reached the limit on the number of resources you can create, or exceeded the size of an individual resource.
        • GenerationExistsException A request to generate a recommendation is already in progress.
        • DataUnavailableException The requested data is unavailable.
        • 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

      • tagResource

        default CompletableFuture<TagResourceResponse> tagResource​(TagResourceRequest tagResourceRequest)

        An API operation for adding one or more tags (key-value pairs) to a resource.

        You can use the TagResource operation with a resource that already has tags. If you specify a new tag key for the resource, this tag is appended to the list of tags associated with the resource. If you specify a tag key that is already associated with the resource, the new tag value you specify replaces the previous value for that tag.

        Although the maximum number of array members is 200, user-tag maximum is 50. The remaining are reserved for Amazon Web Services use.

        Parameters:
        tagResourceRequest -
        Returns:
        A Java Future containing the result of the TagResource operation returned by the service.
        The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
        • ResourceNotFoundException The specified ARN in the request doesn't exist.
        • TooManyTagsException Can occur if you specify a number of tags for a resource greater than the maximum 50 user tags per resource.
        • 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

      • tagResource

        default CompletableFuture<TagResourceResponse> tagResource​(Consumer<TagResourceRequest.Builder> tagResourceRequest)

        An API operation for adding one or more tags (key-value pairs) to a resource.

        You can use the TagResource operation with a resource that already has tags. If you specify a new tag key for the resource, this tag is appended to the list of tags associated with the resource. If you specify a tag key that is already associated with the resource, the new tag value you specify replaces the previous value for that tag.

        Although the maximum number of array members is 200, user-tag maximum is 50. The remaining are reserved for Amazon Web Services use.


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

        Parameters:
        tagResourceRequest - A Consumer that will call methods on TagResourceRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the TagResource operation returned by the service.
        The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
        • ResourceNotFoundException The specified ARN in the request doesn't exist.
        • TooManyTagsException Can occur if you specify a number of tags for a resource greater than the maximum 50 user tags per resource.
        • 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

      • untagResource

        default CompletableFuture<UntagResourceResponse> untagResource​(UntagResourceRequest untagResourceRequest)

        Removes one or more tags from a resource. Specify only tag keys in your request. Don't specify the value.

        Parameters:
        untagResourceRequest -
        Returns:
        A Java Future containing the result of the UntagResource operation returned by the service.
        The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
        • ResourceNotFoundException The specified ARN in the request doesn't exist.
        • 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

      • untagResource

        default CompletableFuture<UntagResourceResponse> untagResource​(Consumer<UntagResourceRequest.Builder> untagResourceRequest)

        Removes one or more tags from a resource. Specify only tag keys in your request. Don't specify the value.


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

        Parameters:
        untagResourceRequest - A Consumer that will call methods on UntagResourceRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the UntagResource operation returned by the service.
        The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
        • ResourceNotFoundException The specified ARN in the request doesn't exist.
        • 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

      • updateAnomalyMonitor

        default CompletableFuture<UpdateAnomalyMonitorResponse> updateAnomalyMonitor​(UpdateAnomalyMonitorRequest updateAnomalyMonitorRequest)

        Updates an existing cost anomaly monitor. The changes made are applied going forward, and doesn't change anomalies detected in the past.

        Parameters:
        updateAnomalyMonitorRequest -
        Returns:
        A Java Future containing the result of the UpdateAnomalyMonitor 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.
        • UnknownMonitorException The cost anomaly monitor does not exist for the account.
        • 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

      • updateAnomalyMonitor

        default CompletableFuture<UpdateAnomalyMonitorResponse> updateAnomalyMonitor​(Consumer<UpdateAnomalyMonitorRequest.Builder> updateAnomalyMonitorRequest)

        Updates an existing cost anomaly monitor. The changes made are applied going forward, and doesn't change anomalies detected in the past.


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

        Parameters:
        updateAnomalyMonitorRequest - A Consumer that will call methods on UpdateAnomalyMonitorRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the UpdateAnomalyMonitor 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.
        • UnknownMonitorException The cost anomaly monitor does not exist for the account.
        • 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

      • updateAnomalySubscription

        default CompletableFuture<UpdateAnomalySubscriptionResponse> updateAnomalySubscription​(UpdateAnomalySubscriptionRequest updateAnomalySubscriptionRequest)

        Updates an existing cost anomaly subscription. Specify the fields that you want to update. Omitted fields are unchanged.

        The JSON below describes the generic construct for each type. See Request Parameters for possible values as they apply to AnomalySubscription.

        Parameters:
        updateAnomalySubscriptionRequest -
        Returns:
        A Java Future containing the result of the UpdateAnomalySubscription 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.
        • UnknownMonitorException The cost anomaly monitor does not exist for the account.
        • UnknownSubscriptionException The cost anomaly subscription does not exist for the account.
        • 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

      • updateAnomalySubscription

        default CompletableFuture<UpdateAnomalySubscriptionResponse> updateAnomalySubscription​(Consumer<UpdateAnomalySubscriptionRequest.Builder> updateAnomalySubscriptionRequest)

        Updates an existing cost anomaly subscription. Specify the fields that you want to update. Omitted fields are unchanged.

        The JSON below describes the generic construct for each type. See Request Parameters for possible values as they apply to AnomalySubscription.


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

        Parameters:
        updateAnomalySubscriptionRequest - A Consumer that will call methods on UpdateAnomalySubscriptionRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the UpdateAnomalySubscription 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.
        • UnknownMonitorException The cost anomaly monitor does not exist for the account.
        • UnknownSubscriptionException The cost anomaly subscription does not exist for the account.
        • 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

      • updateCostAllocationTagsStatus

        default CompletableFuture<UpdateCostAllocationTagsStatusResponse> updateCostAllocationTagsStatus​(UpdateCostAllocationTagsStatusRequest updateCostAllocationTagsStatusRequest)

        Updates status for cost allocation tags in bulk, with maximum batch size of 20. If the tag status that's updated is the same as the existing tag status, the request doesn't fail. Instead, it doesn't have any effect on the tag status (for example, activating the active tag).

        Parameters:
        updateCostAllocationTagsStatusRequest -
        Returns:
        A Java Future containing the result of the UpdateCostAllocationTagsStatus 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

      • updateCostAllocationTagsStatus

        default CompletableFuture<UpdateCostAllocationTagsStatusResponse> updateCostAllocationTagsStatus​(Consumer<UpdateCostAllocationTagsStatusRequest.Builder> updateCostAllocationTagsStatusRequest)

        Updates status for cost allocation tags in bulk, with maximum batch size of 20. If the tag status that's updated is the same as the existing tag status, the request doesn't fail. Instead, it doesn't have any effect on the tag status (for example, activating the active tag).


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

        Parameters:
        updateCostAllocationTagsStatusRequest - A Consumer that will call methods on UpdateCostAllocationTagsStatusRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the UpdateCostAllocationTagsStatus 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

      • updateCostCategoryDefinition

        default CompletableFuture<UpdateCostCategoryDefinitionResponse> updateCostCategoryDefinition​(UpdateCostCategoryDefinitionRequest updateCostCategoryDefinitionRequest)

        Updates an existing Cost Category. Changes made to the Cost Category rules will be used to categorize the current month’s expenses and future expenses. This won’t change categorization for the previous months.

        Parameters:
        updateCostCategoryDefinitionRequest -
        Returns:
        A Java Future containing the result of the UpdateCostCategoryDefinition operation returned by the service.
        The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
        • ResourceNotFoundException The specified ARN in the request doesn't exist.
        • ServiceQuotaExceededException You've reached the limit on the number of resources you can create, or exceeded the size of an individual resource.
        • 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

      • updateCostCategoryDefinition

        default CompletableFuture<UpdateCostCategoryDefinitionResponse> updateCostCategoryDefinition​(Consumer<UpdateCostCategoryDefinitionRequest.Builder> updateCostCategoryDefinitionRequest)

        Updates an existing Cost Category. Changes made to the Cost Category rules will be used to categorize the current month’s expenses and future expenses. This won’t change categorization for the previous months.


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

        Parameters:
        updateCostCategoryDefinitionRequest - A Consumer that will call methods on UpdateCostCategoryDefinitionRequest.Builder to create a request.
        Returns:
        A Java Future containing the result of the UpdateCostCategoryDefinition operation returned by the service.
        The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
        • ResourceNotFoundException The specified ARN in the request doesn't exist.
        • ServiceQuotaExceededException You've reached the limit on the number of resources you can create, or exceeded the size of an individual resource.
        • 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