Interface SustainabilityClient

All Superinterfaces:

AutoCloseable, AwsClient, SdkAutoCloseable, SdkClient

@Generated("software.amazon.awssdk:codegen")
@SdkPublicApi
@ThreadSafe
public interface SustainabilityClient
extends AwsClient

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

The AWS Sustainability service provides programmatic access to estimated environmental impact data for your Amazon Web Services usage. Use the AWS Sustainability service to retrieve, analyze, and track the environmental impact of your cloud infrastructure over time.

With the AWS Sustainability service, you can:

• Retrieve estimated carbon emissions and water allocation for your Amazon Web Services usage across different time periods

• Group environmental impact data by dimensions such as account, region, and service

• Filter environmental impact data to focus on specific accounts, regions, or services

• Access multiple carbon emissions calculation methodologies including Location-based Method (LBM) and Market-based Method (MBM)

• Aggregate environmental impact data at various time granularities including monthly, quarterly, and yearly periods

The API supports pagination for efficient data retrieval and provides dimension values to help you understand the available grouping and filtering options for your account.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	SERVICE_METADATA_ID	Value for looking up the service's metadata from the ServiceMetadataProvider.
static final String	SERVICE_NAME

Method Summary

Modifier and Type	Method	Description
static SustainabilityClientBuilder	builder()	Create a builder that can be used to configure and create a SustainabilityClient.
static SustainabilityClient	create()	Create a SustainabilityClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.
default GetEstimatedCarbonEmissionsResponse	getEstimatedCarbonEmissions(Consumer<GetEstimatedCarbonEmissionsRequest.Builder> getEstimatedCarbonEmissionsRequest)	Returns estimated carbon emission values based on customer grouping and filtering parameters.
default GetEstimatedCarbonEmissionsResponse	getEstimatedCarbonEmissions(GetEstimatedCarbonEmissionsRequest getEstimatedCarbonEmissionsRequest)	Returns estimated carbon emission values based on customer grouping and filtering parameters.
default GetEstimatedCarbonEmissionsDimensionValuesResponse	getEstimatedCarbonEmissionsDimensionValues(Consumer<GetEstimatedCarbonEmissionsDimensionValuesRequest.Builder> getEstimatedCarbonEmissionsDimensionValuesRequest)	Returns the possible dimension values available for a customer's account.
default GetEstimatedCarbonEmissionsDimensionValuesResponse	getEstimatedCarbonEmissionsDimensionValues(GetEstimatedCarbonEmissionsDimensionValuesRequest getEstimatedCarbonEmissionsDimensionValuesRequest)	Returns the possible dimension values available for a customer's account.
default GetEstimatedCarbonEmissionsDimensionValuesIterable	getEstimatedCarbonEmissionsDimensionValuesPaginator(Consumer<GetEstimatedCarbonEmissionsDimensionValuesRequest.Builder> getEstimatedCarbonEmissionsDimensionValuesRequest)	This is a variant of getEstimatedCarbonEmissionsDimensionValues(software.amazon.awssdk.services.sustainability.model.GetEstimatedCarbonEmissionsDimensionValuesRequest) operation.
default GetEstimatedCarbonEmissionsDimensionValuesIterable	getEstimatedCarbonEmissionsDimensionValuesPaginator(GetEstimatedCarbonEmissionsDimensionValuesRequest getEstimatedCarbonEmissionsDimensionValuesRequest)	This is a variant of getEstimatedCarbonEmissionsDimensionValues(software.amazon.awssdk.services.sustainability.model.GetEstimatedCarbonEmissionsDimensionValuesRequest) operation.
default GetEstimatedCarbonEmissionsIterable	getEstimatedCarbonEmissionsPaginator(Consumer<GetEstimatedCarbonEmissionsRequest.Builder> getEstimatedCarbonEmissionsRequest)	This is a variant of getEstimatedCarbonEmissions(software.amazon.awssdk.services.sustainability.model.GetEstimatedCarbonEmissionsRequest) operation.
default GetEstimatedCarbonEmissionsIterable	getEstimatedCarbonEmissionsPaginator(GetEstimatedCarbonEmissionsRequest getEstimatedCarbonEmissionsRequest)	This is a variant of getEstimatedCarbonEmissions(software.amazon.awssdk.services.sustainability.model.GetEstimatedCarbonEmissionsRequest) operation.
default GetEstimatedWaterAllocationResponse	getEstimatedWaterAllocation(Consumer<GetEstimatedWaterAllocationRequest.Builder> getEstimatedWaterAllocationRequest)	Returns estimated water allocation values based on customer grouping and filtering parameters.
default GetEstimatedWaterAllocationResponse	getEstimatedWaterAllocation(GetEstimatedWaterAllocationRequest getEstimatedWaterAllocationRequest)	Returns estimated water allocation values based on customer grouping and filtering parameters.
default GetEstimatedWaterAllocationDimensionValuesResponse	getEstimatedWaterAllocationDimensionValues(Consumer<GetEstimatedWaterAllocationDimensionValuesRequest.Builder> getEstimatedWaterAllocationDimensionValuesRequest)	Returns the possible dimension values available for a customer's account.
default GetEstimatedWaterAllocationDimensionValuesResponse	getEstimatedWaterAllocationDimensionValues(GetEstimatedWaterAllocationDimensionValuesRequest getEstimatedWaterAllocationDimensionValuesRequest)	Returns the possible dimension values available for a customer's account.
default GetEstimatedWaterAllocationDimensionValuesIterable	getEstimatedWaterAllocationDimensionValuesPaginator(Consumer<GetEstimatedWaterAllocationDimensionValuesRequest.Builder> getEstimatedWaterAllocationDimensionValuesRequest)	This is a variant of getEstimatedWaterAllocationDimensionValues(software.amazon.awssdk.services.sustainability.model.GetEstimatedWaterAllocationDimensionValuesRequest) operation.
default GetEstimatedWaterAllocationDimensionValuesIterable	getEstimatedWaterAllocationDimensionValuesPaginator(GetEstimatedWaterAllocationDimensionValuesRequest getEstimatedWaterAllocationDimensionValuesRequest)	This is a variant of getEstimatedWaterAllocationDimensionValues(software.amazon.awssdk.services.sustainability.model.GetEstimatedWaterAllocationDimensionValuesRequest) operation.
default GetEstimatedWaterAllocationIterable	getEstimatedWaterAllocationPaginator(Consumer<GetEstimatedWaterAllocationRequest.Builder> getEstimatedWaterAllocationRequest)	This is a variant of getEstimatedWaterAllocation(software.amazon.awssdk.services.sustainability.model.GetEstimatedWaterAllocationRequest) operation.
default GetEstimatedWaterAllocationIterable	getEstimatedWaterAllocationPaginator(GetEstimatedWaterAllocationRequest getEstimatedWaterAllocationRequest)	This is a variant of getEstimatedWaterAllocation(software.amazon.awssdk.services.sustainability.model.GetEstimatedWaterAllocationRequest) operation.
default SustainabilityServiceClientConfiguration	serviceClientConfiguration()	The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration
static ServiceMetadata	serviceMetadata()

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

close

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

serviceName

Field Details

SERVICE_NAME

static final String SERVICE_NAME

See Also:

• Constant Field Values

SERVICE_METADATA_ID

static final String SERVICE_METADATA_ID

Value for looking up the service's metadata from the ServiceMetadataProvider.

See Also:

• Constant Field Values

Method Details

getEstimatedCarbonEmissions

default GetEstimatedCarbonEmissionsResponse getEstimatedCarbonEmissions(GetEstimatedCarbonEmissionsRequest getEstimatedCarbonEmissionsRequest)
                                                                 throws ValidationException,
InternalServerException,
AccessDeniedException,
ThrottlingException,
AwsServiceException,
SdkClientException,
SustainabilityException

Returns estimated carbon emission values based on customer grouping and filtering parameters. We recommend using pagination to ensure that the operation returns quickly and successfully.

Parameters:

getEstimatedCarbonEmissionsRequest -

Returns:

Result of the GetEstimatedCarbonEmissions operation returned by the service.

See Also:

• AWS API Documentation

getEstimatedCarbonEmissions

default GetEstimatedCarbonEmissionsResponse getEstimatedCarbonEmissions(Consumer<GetEstimatedCarbonEmissionsRequest.Builder> getEstimatedCarbonEmissionsRequest)
                                                                 throws ValidationException,
InternalServerException,
AccessDeniedException,
ThrottlingException,
AwsServiceException,
SdkClientException,
SustainabilityException

Returns estimated carbon emission values based on customer grouping and filtering parameters. We recommend using pagination to ensure that the operation returns quickly and successfully.

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

Parameters:

getEstimatedCarbonEmissionsRequest - A Consumer that will call methods on GetEstimatedCarbonEmissionsRequest.Builder to create a request.

Returns:

Result of the GetEstimatedCarbonEmissions operation returned by the service.

See Also:

• AWS API Documentation

getEstimatedCarbonEmissionsPaginator

default GetEstimatedCarbonEmissionsIterable getEstimatedCarbonEmissionsPaginator(GetEstimatedCarbonEmissionsRequest getEstimatedCarbonEmissionsRequest)
                                                                          throws ValidationException,
InternalServerException,
AccessDeniedException,
ThrottlingException,
AwsServiceException,
SdkClientException,
SustainabilityException

This is a variant of getEstimatedCarbonEmissions(software.amazon.awssdk.services.sustainability.model.GetEstimatedCarbonEmissionsRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.sustainability.paginators.GetEstimatedCarbonEmissionsIterable responses = client.getEstimatedCarbonEmissionsPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.sustainability.paginators.GetEstimatedCarbonEmissionsIterable responses = client
             .getEstimatedCarbonEmissionsPaginator(request);
     for (software.amazon.awssdk.services.sustainability.model.GetEstimatedCarbonEmissionsResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.sustainability.paginators.GetEstimatedCarbonEmissionsIterable responses = client.getEstimatedCarbonEmissionsPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

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 getEstimatedCarbonEmissions(software.amazon.awssdk.services.sustainability.model.GetEstimatedCarbonEmissionsRequest) operation.

Parameters:

getEstimatedCarbonEmissionsRequest -

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

getEstimatedCarbonEmissionsPaginator

default GetEstimatedCarbonEmissionsIterable getEstimatedCarbonEmissionsPaginator(Consumer<GetEstimatedCarbonEmissionsRequest.Builder> getEstimatedCarbonEmissionsRequest)
                                                                          throws ValidationException,
InternalServerException,
AccessDeniedException,
ThrottlingException,
AwsServiceException,
SdkClientException,
SustainabilityException

This is a variant of getEstimatedCarbonEmissions(software.amazon.awssdk.services.sustainability.model.GetEstimatedCarbonEmissionsRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.sustainability.paginators.GetEstimatedCarbonEmissionsIterable responses = client.getEstimatedCarbonEmissionsPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.sustainability.paginators.GetEstimatedCarbonEmissionsIterable responses = client
             .getEstimatedCarbonEmissionsPaginator(request);
     for (software.amazon.awssdk.services.sustainability.model.GetEstimatedCarbonEmissionsResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.sustainability.paginators.GetEstimatedCarbonEmissionsIterable responses = client.getEstimatedCarbonEmissionsPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

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 getEstimatedCarbonEmissions(software.amazon.awssdk.services.sustainability.model.GetEstimatedCarbonEmissionsRequest) operation.

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

Parameters:

getEstimatedCarbonEmissionsRequest - A Consumer that will call methods on GetEstimatedCarbonEmissionsRequest.Builder to create a request.

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

getEstimatedCarbonEmissionsDimensionValues

default GetEstimatedCarbonEmissionsDimensionValuesResponse getEstimatedCarbonEmissionsDimensionValues(GetEstimatedCarbonEmissionsDimensionValuesRequest getEstimatedCarbonEmissionsDimensionValuesRequest)
                                                                                               throws ValidationException,
InternalServerException,
AccessDeniedException,
ThrottlingException,
AwsServiceException,
SdkClientException,
SustainabilityException

Returns the possible dimension values available for a customer's account. We recommend using pagination to ensure that the operation returns quickly and successfully.

Parameters:

getEstimatedCarbonEmissionsDimensionValuesRequest -

Returns:

Result of the GetEstimatedCarbonEmissionsDimensionValues operation returned by the service.

See Also:

• AWS API Documentation

getEstimatedCarbonEmissionsDimensionValues

default GetEstimatedCarbonEmissionsDimensionValuesResponse getEstimatedCarbonEmissionsDimensionValues(Consumer<GetEstimatedCarbonEmissionsDimensionValuesRequest.Builder> getEstimatedCarbonEmissionsDimensionValuesRequest)
                                                                                               throws ValidationException,
InternalServerException,
AccessDeniedException,
ThrottlingException,
AwsServiceException,
SdkClientException,
SustainabilityException

Returns the possible dimension values available for a customer's account. We recommend using pagination to ensure that the operation returns quickly and successfully.

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

Parameters:

getEstimatedCarbonEmissionsDimensionValuesRequest - A Consumer that will call methods on GetEstimatedCarbonEmissionsDimensionValuesRequest.Builder to create a request.

Returns:

Result of the GetEstimatedCarbonEmissionsDimensionValues operation returned by the service.

See Also:

• AWS API Documentation

getEstimatedCarbonEmissionsDimensionValuesPaginator

default GetEstimatedCarbonEmissionsDimensionValuesIterable getEstimatedCarbonEmissionsDimensionValuesPaginator(GetEstimatedCarbonEmissionsDimensionValuesRequest getEstimatedCarbonEmissionsDimensionValuesRequest)
                                                                                                        throws ValidationException,
InternalServerException,
AccessDeniedException,
ThrottlingException,
AwsServiceException,
SdkClientException,
SustainabilityException

This is a variant of getEstimatedCarbonEmissionsDimensionValues(software.amazon.awssdk.services.sustainability.model.GetEstimatedCarbonEmissionsDimensionValuesRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.sustainability.paginators.GetEstimatedCarbonEmissionsDimensionValuesIterable responses = client.getEstimatedCarbonEmissionsDimensionValuesPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.sustainability.paginators.GetEstimatedCarbonEmissionsDimensionValuesIterable responses = client
             .getEstimatedCarbonEmissionsDimensionValuesPaginator(request);
     for (software.amazon.awssdk.services.sustainability.model.GetEstimatedCarbonEmissionsDimensionValuesResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.sustainability.paginators.GetEstimatedCarbonEmissionsDimensionValuesIterable responses = client.getEstimatedCarbonEmissionsDimensionValuesPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

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 getEstimatedCarbonEmissionsDimensionValues(software.amazon.awssdk.services.sustainability.model.GetEstimatedCarbonEmissionsDimensionValuesRequest) operation.

Parameters:

getEstimatedCarbonEmissionsDimensionValuesRequest -

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

getEstimatedCarbonEmissionsDimensionValuesPaginator

default GetEstimatedCarbonEmissionsDimensionValuesIterable getEstimatedCarbonEmissionsDimensionValuesPaginator(Consumer<GetEstimatedCarbonEmissionsDimensionValuesRequest.Builder> getEstimatedCarbonEmissionsDimensionValuesRequest)
                                                                                                        throws ValidationException,
InternalServerException,
AccessDeniedException,
ThrottlingException,
AwsServiceException,
SdkClientException,
SustainabilityException

This is a variant of getEstimatedCarbonEmissionsDimensionValues(software.amazon.awssdk.services.sustainability.model.GetEstimatedCarbonEmissionsDimensionValuesRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.sustainability.paginators.GetEstimatedCarbonEmissionsDimensionValuesIterable responses = client.getEstimatedCarbonEmissionsDimensionValuesPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.sustainability.paginators.GetEstimatedCarbonEmissionsDimensionValuesIterable responses = client
             .getEstimatedCarbonEmissionsDimensionValuesPaginator(request);
     for (software.amazon.awssdk.services.sustainability.model.GetEstimatedCarbonEmissionsDimensionValuesResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.sustainability.paginators.GetEstimatedCarbonEmissionsDimensionValuesIterable responses = client.getEstimatedCarbonEmissionsDimensionValuesPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

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 getEstimatedCarbonEmissionsDimensionValues(software.amazon.awssdk.services.sustainability.model.GetEstimatedCarbonEmissionsDimensionValuesRequest) operation.

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

Parameters:

getEstimatedCarbonEmissionsDimensionValuesRequest - A Consumer that will call methods on GetEstimatedCarbonEmissionsDimensionValuesRequest.Builder to create a request.

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

getEstimatedWaterAllocation

default GetEstimatedWaterAllocationResponse getEstimatedWaterAllocation(GetEstimatedWaterAllocationRequest getEstimatedWaterAllocationRequest)
                                                                 throws ValidationException,
InternalServerException,
AccessDeniedException,
ThrottlingException,
AwsServiceException,
SdkClientException,
SustainabilityException

Returns estimated water allocation values based on customer grouping and filtering parameters. We recommend using pagination to ensure that the operation returns quickly and successfully.

Parameters:

getEstimatedWaterAllocationRequest -

Returns:

Result of the GetEstimatedWaterAllocation operation returned by the service.

See Also:

• AWS API Documentation

getEstimatedWaterAllocation

default GetEstimatedWaterAllocationResponse getEstimatedWaterAllocation(Consumer<GetEstimatedWaterAllocationRequest.Builder> getEstimatedWaterAllocationRequest)
                                                                 throws ValidationException,
InternalServerException,
AccessDeniedException,
ThrottlingException,
AwsServiceException,
SdkClientException,
SustainabilityException

Returns estimated water allocation values based on customer grouping and filtering parameters. We recommend using pagination to ensure that the operation returns quickly and successfully.

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

Parameters:

getEstimatedWaterAllocationRequest - A Consumer that will call methods on GetEstimatedWaterAllocationRequest.Builder to create a request.

Returns:

Result of the GetEstimatedWaterAllocation operation returned by the service.

See Also:

• AWS API Documentation

getEstimatedWaterAllocationPaginator

default GetEstimatedWaterAllocationIterable getEstimatedWaterAllocationPaginator(GetEstimatedWaterAllocationRequest getEstimatedWaterAllocationRequest)
                                                                          throws ValidationException,
InternalServerException,
AccessDeniedException,
ThrottlingException,
AwsServiceException,
SdkClientException,
SustainabilityException

This is a variant of getEstimatedWaterAllocation(software.amazon.awssdk.services.sustainability.model.GetEstimatedWaterAllocationRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.sustainability.paginators.GetEstimatedWaterAllocationIterable responses = client.getEstimatedWaterAllocationPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.sustainability.paginators.GetEstimatedWaterAllocationIterable responses = client
             .getEstimatedWaterAllocationPaginator(request);
     for (software.amazon.awssdk.services.sustainability.model.GetEstimatedWaterAllocationResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.sustainability.paginators.GetEstimatedWaterAllocationIterable responses = client.getEstimatedWaterAllocationPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

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 getEstimatedWaterAllocation(software.amazon.awssdk.services.sustainability.model.GetEstimatedWaterAllocationRequest) operation.

Parameters:

getEstimatedWaterAllocationRequest -

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

getEstimatedWaterAllocationPaginator

default GetEstimatedWaterAllocationIterable getEstimatedWaterAllocationPaginator(Consumer<GetEstimatedWaterAllocationRequest.Builder> getEstimatedWaterAllocationRequest)
                                                                          throws ValidationException,
InternalServerException,
AccessDeniedException,
ThrottlingException,
AwsServiceException,
SdkClientException,
SustainabilityException

This is a variant of getEstimatedWaterAllocation(software.amazon.awssdk.services.sustainability.model.GetEstimatedWaterAllocationRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.sustainability.paginators.GetEstimatedWaterAllocationIterable responses = client.getEstimatedWaterAllocationPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.sustainability.paginators.GetEstimatedWaterAllocationIterable responses = client
             .getEstimatedWaterAllocationPaginator(request);
     for (software.amazon.awssdk.services.sustainability.model.GetEstimatedWaterAllocationResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.sustainability.paginators.GetEstimatedWaterAllocationIterable responses = client.getEstimatedWaterAllocationPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

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 getEstimatedWaterAllocation(software.amazon.awssdk.services.sustainability.model.GetEstimatedWaterAllocationRequest) operation.

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

Parameters:

getEstimatedWaterAllocationRequest - A Consumer that will call methods on GetEstimatedWaterAllocationRequest.Builder to create a request.

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

getEstimatedWaterAllocationDimensionValues

default GetEstimatedWaterAllocationDimensionValuesResponse getEstimatedWaterAllocationDimensionValues(GetEstimatedWaterAllocationDimensionValuesRequest getEstimatedWaterAllocationDimensionValuesRequest)
                                                                                               throws ValidationException,
InternalServerException,
AccessDeniedException,
ThrottlingException,
AwsServiceException,
SdkClientException,
SustainabilityException

Returns the possible dimension values available for a customer's account. We recommend using pagination to ensure that the operation returns quickly and successfully.

Parameters:

getEstimatedWaterAllocationDimensionValuesRequest -

Returns:

Result of the GetEstimatedWaterAllocationDimensionValues operation returned by the service.

See Also:

• AWS API Documentation

getEstimatedWaterAllocationDimensionValues

default GetEstimatedWaterAllocationDimensionValuesResponse getEstimatedWaterAllocationDimensionValues(Consumer<GetEstimatedWaterAllocationDimensionValuesRequest.Builder> getEstimatedWaterAllocationDimensionValuesRequest)
                                                                                               throws ValidationException,
InternalServerException,
AccessDeniedException,
ThrottlingException,
AwsServiceException,
SdkClientException,
SustainabilityException

Returns the possible dimension values available for a customer's account. We recommend using pagination to ensure that the operation returns quickly and successfully.

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

Parameters:

getEstimatedWaterAllocationDimensionValuesRequest - A Consumer that will call methods on GetEstimatedWaterAllocationDimensionValuesRequest.Builder to create a request.

Returns:

Result of the GetEstimatedWaterAllocationDimensionValues operation returned by the service.

See Also:

• AWS API Documentation

getEstimatedWaterAllocationDimensionValuesPaginator

default GetEstimatedWaterAllocationDimensionValuesIterable getEstimatedWaterAllocationDimensionValuesPaginator(GetEstimatedWaterAllocationDimensionValuesRequest getEstimatedWaterAllocationDimensionValuesRequest)
                                                                                                        throws ValidationException,
InternalServerException,
AccessDeniedException,
ThrottlingException,
AwsServiceException,
SdkClientException,
SustainabilityException

This is a variant of getEstimatedWaterAllocationDimensionValues(software.amazon.awssdk.services.sustainability.model.GetEstimatedWaterAllocationDimensionValuesRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.sustainability.paginators.GetEstimatedWaterAllocationDimensionValuesIterable responses = client.getEstimatedWaterAllocationDimensionValuesPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.sustainability.paginators.GetEstimatedWaterAllocationDimensionValuesIterable responses = client
             .getEstimatedWaterAllocationDimensionValuesPaginator(request);
     for (software.amazon.awssdk.services.sustainability.model.GetEstimatedWaterAllocationDimensionValuesResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.sustainability.paginators.GetEstimatedWaterAllocationDimensionValuesIterable responses = client.getEstimatedWaterAllocationDimensionValuesPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

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 getEstimatedWaterAllocationDimensionValues(software.amazon.awssdk.services.sustainability.model.GetEstimatedWaterAllocationDimensionValuesRequest) operation.

Parameters:

getEstimatedWaterAllocationDimensionValuesRequest -

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

getEstimatedWaterAllocationDimensionValuesPaginator

default GetEstimatedWaterAllocationDimensionValuesIterable getEstimatedWaterAllocationDimensionValuesPaginator(Consumer<GetEstimatedWaterAllocationDimensionValuesRequest.Builder> getEstimatedWaterAllocationDimensionValuesRequest)
                                                                                                        throws ValidationException,
InternalServerException,
AccessDeniedException,
ThrottlingException,
AwsServiceException,
SdkClientException,
SustainabilityException

This is a variant of getEstimatedWaterAllocationDimensionValues(software.amazon.awssdk.services.sustainability.model.GetEstimatedWaterAllocationDimensionValuesRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.sustainability.paginators.GetEstimatedWaterAllocationDimensionValuesIterable responses = client.getEstimatedWaterAllocationDimensionValuesPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.sustainability.paginators.GetEstimatedWaterAllocationDimensionValuesIterable responses = client
             .getEstimatedWaterAllocationDimensionValuesPaginator(request);
     for (software.amazon.awssdk.services.sustainability.model.GetEstimatedWaterAllocationDimensionValuesResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.sustainability.paginators.GetEstimatedWaterAllocationDimensionValuesIterable responses = client.getEstimatedWaterAllocationDimensionValuesPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

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 getEstimatedWaterAllocationDimensionValues(software.amazon.awssdk.services.sustainability.model.GetEstimatedWaterAllocationDimensionValuesRequest) operation.

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

Parameters:

getEstimatedWaterAllocationDimensionValuesRequest - A Consumer that will call methods on GetEstimatedWaterAllocationDimensionValuesRequest.Builder to create a request.

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

create

static SustainabilityClient create()

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

builder

static SustainabilityClientBuilder builder()

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

serviceMetadata

static ServiceMetadata serviceMetadata()

serviceClientConfiguration

default SustainabilityServiceClientConfiguration serviceClientConfiguration()

Description copied from interface: SdkClient

The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration

Specified by:

serviceClientConfiguration in interface AwsClient

Specified by:

serviceClientConfiguration in interface SdkClient

Returns:

SdkServiceClientConfiguration