Interface BcmDataExportsClient
- All Superinterfaces:
AutoCloseable,AwsClient,SdkAutoCloseable,SdkClient
builder() method.
You can use the Data Exports API to create customized exports from multiple Amazon Web Services cost management and billing datasets, such as cost and usage data and cost optimization recommendations.
The Data Exports API provides the following endpoint:
-
https://bcm-data-exports.us-east-1.api.aws
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringValue for looking up the service's metadata from theServiceMetadataProvider.static final String -
Method Summary
Modifier and TypeMethodDescriptionstatic BcmDataExportsClientBuilderbuilder()Create a builder that can be used to configure and create aBcmDataExportsClient.static BcmDataExportsClientcreate()Create aBcmDataExportsClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider.default CreateExportResponsecreateExport(Consumer<CreateExportRequest.Builder> createExportRequest) Creates a data export and specifies the data query, the delivery preference, and any optional resource tags.default CreateExportResponsecreateExport(CreateExportRequest createExportRequest) Creates a data export and specifies the data query, the delivery preference, and any optional resource tags.default DeleteExportResponsedeleteExport(Consumer<DeleteExportRequest.Builder> deleteExportRequest) Deletes an existing data export.default DeleteExportResponsedeleteExport(DeleteExportRequest deleteExportRequest) Deletes an existing data export.default GetExecutionResponsegetExecution(Consumer<GetExecutionRequest.Builder> getExecutionRequest) Exports data based on the source data update.default GetExecutionResponsegetExecution(GetExecutionRequest getExecutionRequest) Exports data based on the source data update.default GetExportResponsegetExport(Consumer<GetExportRequest.Builder> getExportRequest) Views the definition of an existing data export.default GetExportResponsegetExport(GetExportRequest getExportRequest) Views the definition of an existing data export.default GetTableResponsegetTable(Consumer<GetTableRequest.Builder> getTableRequest) Returns the metadata for the specified table and table properties.default GetTableResponsegetTable(GetTableRequest getTableRequest) Returns the metadata for the specified table and table properties.default ListExecutionsResponselistExecutions(Consumer<ListExecutionsRequest.Builder> listExecutionsRequest) Lists the historical executions for the export.default ListExecutionsResponselistExecutions(ListExecutionsRequest listExecutionsRequest) Lists the historical executions for the export.default ListExecutionsIterablelistExecutionsPaginator(Consumer<ListExecutionsRequest.Builder> listExecutionsRequest) This is a variant oflistExecutions(software.amazon.awssdk.services.bcmdataexports.model.ListExecutionsRequest)operation.default ListExecutionsIterablelistExecutionsPaginator(ListExecutionsRequest listExecutionsRequest) This is a variant oflistExecutions(software.amazon.awssdk.services.bcmdataexports.model.ListExecutionsRequest)operation.default ListExportsResponselistExports(Consumer<ListExportsRequest.Builder> listExportsRequest) Lists all data export definitions.default ListExportsResponselistExports(ListExportsRequest listExportsRequest) Lists all data export definitions.default ListExportsIterablelistExportsPaginator(Consumer<ListExportsRequest.Builder> listExportsRequest) This is a variant oflistExports(software.amazon.awssdk.services.bcmdataexports.model.ListExportsRequest)operation.default ListExportsIterablelistExportsPaginator(ListExportsRequest listExportsRequest) This is a variant oflistExports(software.amazon.awssdk.services.bcmdataexports.model.ListExportsRequest)operation.default ListTablesResponselistTables(Consumer<ListTablesRequest.Builder> listTablesRequest) Lists all available tables in data exports.default ListTablesResponselistTables(ListTablesRequest listTablesRequest) Lists all available tables in data exports.default ListTablesIterablelistTablesPaginator(Consumer<ListTablesRequest.Builder> listTablesRequest) This is a variant oflistTables(software.amazon.awssdk.services.bcmdataexports.model.ListTablesRequest)operation.default ListTablesIterablelistTablesPaginator(ListTablesRequest listTablesRequest) This is a variant oflistTables(software.amazon.awssdk.services.bcmdataexports.model.ListTablesRequest)operation.default ListTagsForResourceResponselistTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) List tags associated with an existing data export.default ListTagsForResourceResponselistTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) List tags associated with an existing data export.The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationstatic ServiceMetadatadefault TagResourceResponsetagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) Adds tags for an existing data export definition.default TagResourceResponsetagResource(TagResourceRequest tagResourceRequest) Adds tags for an existing data export definition.default UntagResourceResponseuntagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Deletes tags associated with an existing data export definition.default UntagResourceResponseuntagResource(UntagResourceRequest untagResourceRequest) Deletes tags associated with an existing data export definition.default UpdateExportResponseupdateExport(Consumer<UpdateExportRequest.Builder> updateExportRequest) Updates an existing data export by overwriting all export parameters.default UpdateExportResponseupdateExport(UpdateExportRequest updateExportRequest) Updates an existing data export by overwriting all export parameters.Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
closeMethods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
Field Details
-
SERVICE_NAME
- See Also:
-
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider.- See Also:
-
-
Method Details
-
createExport
default CreateExportResponse createExport(CreateExportRequest createExportRequest) throws ServiceQuotaExceededException, InternalServerException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Creates a data export and specifies the data query, the delivery preference, and any optional resource tags.
A
DataQueryconsists of both aQueryStatementandTableConfigurations.The
QueryStatementis an SQL statement. Data Exports only supports a limited subset of the SQL syntax. For more information on the SQL syntax that is supported, see Data query. To view the available tables and columns, see the Data Exports table dictionary.The
TableConfigurationsis a collection of specifiedTablePropertiesfor the table being queried in theQueryStatement. TableProperties are additional configurations you can provide to change the data and schema of a table. Each table can have different TableProperties. However, tables are not required to have any TableProperties. Each table property has a default value that it assumes if not specified. For more information on table configurations, see Data query. To view the table properties available for each table, see the Data Exports table dictionary or use theListTablesAPI to get a response of all tables and their available properties.- Parameters:
createExportRequest-- Returns:
- Result of the CreateExport operation returned by the service.
- See Also:
-
createExport
default CreateExportResponse createExport(Consumer<CreateExportRequest.Builder> createExportRequest) throws ServiceQuotaExceededException, InternalServerException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Creates a data export and specifies the data query, the delivery preference, and any optional resource tags.
A
DataQueryconsists of both aQueryStatementandTableConfigurations.The
QueryStatementis an SQL statement. Data Exports only supports a limited subset of the SQL syntax. For more information on the SQL syntax that is supported, see Data query. To view the available tables and columns, see the Data Exports table dictionary.The
TableConfigurationsis a collection of specifiedTablePropertiesfor the table being queried in theQueryStatement. TableProperties are additional configurations you can provide to change the data and schema of a table. Each table can have different TableProperties. However, tables are not required to have any TableProperties. Each table property has a default value that it assumes if not specified. For more information on table configurations, see Data query. To view the table properties available for each table, see the Data Exports table dictionary or use theListTablesAPI to get a response of all tables and their available properties.
This is a convenience which creates an instance of the
CreateExportRequest.Builderavoiding the need to create one manually viaCreateExportRequest.builder()- Parameters:
createExportRequest- AConsumerthat will call methods onCreateExportRequest.Builderto create a request.- Returns:
- Result of the CreateExport operation returned by the service.
- See Also:
-
deleteExport
default DeleteExportResponse deleteExport(DeleteExportRequest deleteExportRequest) throws InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Deletes an existing data export.
- Parameters:
deleteExportRequest-- Returns:
- Result of the DeleteExport operation returned by the service.
- See Also:
-
deleteExport
default DeleteExportResponse deleteExport(Consumer<DeleteExportRequest.Builder> deleteExportRequest) throws InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Deletes an existing data export.
This is a convenience which creates an instance of the
DeleteExportRequest.Builderavoiding the need to create one manually viaDeleteExportRequest.builder()- Parameters:
deleteExportRequest- AConsumerthat will call methods onDeleteExportRequest.Builderto create a request.- Returns:
- Result of the DeleteExport operation returned by the service.
- See Also:
-
getExecution
default GetExecutionResponse getExecution(GetExecutionRequest getExecutionRequest) throws InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Exports data based on the source data update.
- Parameters:
getExecutionRequest-- Returns:
- Result of the GetExecution operation returned by the service.
- See Also:
-
getExecution
default GetExecutionResponse getExecution(Consumer<GetExecutionRequest.Builder> getExecutionRequest) throws InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Exports data based on the source data update.
This is a convenience which creates an instance of the
GetExecutionRequest.Builderavoiding the need to create one manually viaGetExecutionRequest.builder()- Parameters:
getExecutionRequest- AConsumerthat will call methods onGetExecutionRequest.Builderto create a request.- Returns:
- Result of the GetExecution operation returned by the service.
- See Also:
-
getExport
default GetExportResponse getExport(GetExportRequest getExportRequest) throws InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Views the definition of an existing data export.
- Parameters:
getExportRequest-- Returns:
- Result of the GetExport operation returned by the service.
- See Also:
-
getExport
default GetExportResponse getExport(Consumer<GetExportRequest.Builder> getExportRequest) throws InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Views the definition of an existing data export.
This is a convenience which creates an instance of the
GetExportRequest.Builderavoiding the need to create one manually viaGetExportRequest.builder()- Parameters:
getExportRequest- AConsumerthat will call methods onGetExportRequest.Builderto create a request.- Returns:
- Result of the GetExport operation returned by the service.
- See Also:
-
getTable
default GetTableResponse getTable(GetTableRequest getTableRequest) throws InternalServerException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Returns the metadata for the specified table and table properties. This includes the list of columns in the table schema, their data types, and column descriptions.
- Parameters:
getTableRequest-- Returns:
- Result of the GetTable operation returned by the service.
- See Also:
-
getTable
default GetTableResponse getTable(Consumer<GetTableRequest.Builder> getTableRequest) throws InternalServerException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Returns the metadata for the specified table and table properties. This includes the list of columns in the table schema, their data types, and column descriptions.
This is a convenience which creates an instance of the
GetTableRequest.Builderavoiding the need to create one manually viaGetTableRequest.builder()- Parameters:
getTableRequest- AConsumerthat will call methods onGetTableRequest.Builderto create a request.- Returns:
- Result of the GetTable operation returned by the service.
- See Also:
-
listExecutions
default ListExecutionsResponse listExecutions(ListExecutionsRequest listExecutionsRequest) throws InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Lists the historical executions for the export.
- Parameters:
listExecutionsRequest-- Returns:
- Result of the ListExecutions operation returned by the service.
- See Also:
-
listExecutions
default ListExecutionsResponse listExecutions(Consumer<ListExecutionsRequest.Builder> listExecutionsRequest) throws InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Lists the historical executions for the export.
This is a convenience which creates an instance of the
ListExecutionsRequest.Builderavoiding the need to create one manually viaListExecutionsRequest.builder()- Parameters:
listExecutionsRequest- AConsumerthat will call methods onListExecutionsRequest.Builderto create a request.- Returns:
- Result of the ListExecutions operation returned by the service.
- See Also:
-
listExecutionsPaginator
default ListExecutionsIterable listExecutionsPaginator(ListExecutionsRequest listExecutionsRequest) throws InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException This is a variant of
listExecutions(software.amazon.awssdk.services.bcmdataexports.model.ListExecutionsRequest)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
2) Using For loopsoftware.amazon.awssdk.services.bcmdataexports.paginators.ListExecutionsIterable responses = client.listExecutionsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.bcmdataexports.paginators.ListExecutionsIterable responses = client .listExecutionsPaginator(request); for (software.amazon.awssdk.services.bcmdataexports.model.ListExecutionsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.bcmdataexports.paginators.ListExecutionsIterable responses = client.listExecutionsPaginator(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
listExecutions(software.amazon.awssdk.services.bcmdataexports.model.ListExecutionsRequest)operation.- Parameters:
listExecutionsRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listExecutionsPaginator
default ListExecutionsIterable listExecutionsPaginator(Consumer<ListExecutionsRequest.Builder> listExecutionsRequest) throws InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException This is a variant of
listExecutions(software.amazon.awssdk.services.bcmdataexports.model.ListExecutionsRequest)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
2) Using For loopsoftware.amazon.awssdk.services.bcmdataexports.paginators.ListExecutionsIterable responses = client.listExecutionsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.bcmdataexports.paginators.ListExecutionsIterable responses = client .listExecutionsPaginator(request); for (software.amazon.awssdk.services.bcmdataexports.model.ListExecutionsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.bcmdataexports.paginators.ListExecutionsIterable responses = client.listExecutionsPaginator(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
listExecutions(software.amazon.awssdk.services.bcmdataexports.model.ListExecutionsRequest)operation.
This is a convenience which creates an instance of the
ListExecutionsRequest.Builderavoiding the need to create one manually viaListExecutionsRequest.builder()- Parameters:
listExecutionsRequest- AConsumerthat will call methods onListExecutionsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listExports
default ListExportsResponse listExports(ListExportsRequest listExportsRequest) throws InternalServerException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Lists all data export definitions.
- Parameters:
listExportsRequest-- Returns:
- Result of the ListExports operation returned by the service.
- See Also:
-
listExports
default ListExportsResponse listExports(Consumer<ListExportsRequest.Builder> listExportsRequest) throws InternalServerException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Lists all data export definitions.
This is a convenience which creates an instance of the
ListExportsRequest.Builderavoiding the need to create one manually viaListExportsRequest.builder()- Parameters:
listExportsRequest- AConsumerthat will call methods onListExportsRequest.Builderto create a request.- Returns:
- Result of the ListExports operation returned by the service.
- See Also:
-
listExportsPaginator
default ListExportsIterable listExportsPaginator(ListExportsRequest listExportsRequest) throws InternalServerException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException This is a variant of
listExports(software.amazon.awssdk.services.bcmdataexports.model.ListExportsRequest)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
2) Using For loopsoftware.amazon.awssdk.services.bcmdataexports.paginators.ListExportsIterable responses = client.listExportsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.bcmdataexports.paginators.ListExportsIterable responses = client .listExportsPaginator(request); for (software.amazon.awssdk.services.bcmdataexports.model.ListExportsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.bcmdataexports.paginators.ListExportsIterable responses = client.listExportsPaginator(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
listExports(software.amazon.awssdk.services.bcmdataexports.model.ListExportsRequest)operation.- Parameters:
listExportsRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listExportsPaginator
default ListExportsIterable listExportsPaginator(Consumer<ListExportsRequest.Builder> listExportsRequest) throws InternalServerException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException This is a variant of
listExports(software.amazon.awssdk.services.bcmdataexports.model.ListExportsRequest)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
2) Using For loopsoftware.amazon.awssdk.services.bcmdataexports.paginators.ListExportsIterable responses = client.listExportsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.bcmdataexports.paginators.ListExportsIterable responses = client .listExportsPaginator(request); for (software.amazon.awssdk.services.bcmdataexports.model.ListExportsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.bcmdataexports.paginators.ListExportsIterable responses = client.listExportsPaginator(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
listExports(software.amazon.awssdk.services.bcmdataexports.model.ListExportsRequest)operation.
This is a convenience which creates an instance of the
ListExportsRequest.Builderavoiding the need to create one manually viaListExportsRequest.builder()- Parameters:
listExportsRequest- AConsumerthat will call methods onListExportsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listTables
default ListTablesResponse listTables(ListTablesRequest listTablesRequest) throws InternalServerException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Lists all available tables in data exports.
- Parameters:
listTablesRequest-- Returns:
- Result of the ListTables operation returned by the service.
- See Also:
-
listTables
default ListTablesResponse listTables(Consumer<ListTablesRequest.Builder> listTablesRequest) throws InternalServerException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Lists all available tables in data exports.
This is a convenience which creates an instance of the
ListTablesRequest.Builderavoiding the need to create one manually viaListTablesRequest.builder()- Parameters:
listTablesRequest- AConsumerthat will call methods onListTablesRequest.Builderto create a request.- Returns:
- Result of the ListTables operation returned by the service.
- See Also:
-
listTablesPaginator
default ListTablesIterable listTablesPaginator(ListTablesRequest listTablesRequest) throws InternalServerException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException This is a variant of
listTables(software.amazon.awssdk.services.bcmdataexports.model.ListTablesRequest)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
2) Using For loopsoftware.amazon.awssdk.services.bcmdataexports.paginators.ListTablesIterable responses = client.listTablesPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.bcmdataexports.paginators.ListTablesIterable responses = client.listTablesPaginator(request); for (software.amazon.awssdk.services.bcmdataexports.model.ListTablesResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.bcmdataexports.paginators.ListTablesIterable responses = client.listTablesPaginator(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
listTables(software.amazon.awssdk.services.bcmdataexports.model.ListTablesRequest)operation.- Parameters:
listTablesRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listTablesPaginator
default ListTablesIterable listTablesPaginator(Consumer<ListTablesRequest.Builder> listTablesRequest) throws InternalServerException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException This is a variant of
listTables(software.amazon.awssdk.services.bcmdataexports.model.ListTablesRequest)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
2) Using For loopsoftware.amazon.awssdk.services.bcmdataexports.paginators.ListTablesIterable responses = client.listTablesPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.bcmdataexports.paginators.ListTablesIterable responses = client.listTablesPaginator(request); for (software.amazon.awssdk.services.bcmdataexports.model.ListTablesResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.bcmdataexports.paginators.ListTablesIterable responses = client.listTablesPaginator(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
listTables(software.amazon.awssdk.services.bcmdataexports.model.ListTablesRequest)operation.
This is a convenience which creates an instance of the
ListTablesRequest.Builderavoiding the need to create one manually viaListTablesRequest.builder()- Parameters:
listTablesRequest- AConsumerthat will call methods onListTablesRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listTagsForResource
default ListTagsForResourceResponse listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) throws InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException List tags associated with an existing data export.
- Parameters:
listTagsForResourceRequest-- Returns:
- Result of the ListTagsForResource operation returned by the service.
- See Also:
-
listTagsForResource
default ListTagsForResourceResponse listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) throws InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException List tags associated with an existing data export.
This is a convenience which creates an instance of the
ListTagsForResourceRequest.Builderavoiding the need to create one manually viaListTagsForResourceRequest.builder()- Parameters:
listTagsForResourceRequest- AConsumerthat will call methods onListTagsForResourceRequest.Builderto create a request.- Returns:
- Result of the ListTagsForResource operation returned by the service.
- See Also:
-
tagResource
default TagResourceResponse tagResource(TagResourceRequest tagResourceRequest) throws InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Adds tags for an existing data export definition.
- Parameters:
tagResourceRequest-- Returns:
- Result of the TagResource operation returned by the service.
- See Also:
-
tagResource
default TagResourceResponse tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) throws InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Adds tags for an existing data export definition.
This is a convenience which creates an instance of the
TagResourceRequest.Builderavoiding the need to create one manually viaTagResourceRequest.builder()- Parameters:
tagResourceRequest- AConsumerthat will call methods onTagResourceRequest.Builderto create a request.- Returns:
- Result of the TagResource operation returned by the service.
- See Also:
-
untagResource
default UntagResourceResponse untagResource(UntagResourceRequest untagResourceRequest) throws InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Deletes tags associated with an existing data export definition.
- Parameters:
untagResourceRequest-- Returns:
- Result of the UntagResource operation returned by the service.
- See Also:
-
untagResource
default UntagResourceResponse untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) throws InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Deletes tags associated with an existing data export definition.
This is a convenience which creates an instance of the
UntagResourceRequest.Builderavoiding the need to create one manually viaUntagResourceRequest.builder()- Parameters:
untagResourceRequest- AConsumerthat will call methods onUntagResourceRequest.Builderto create a request.- Returns:
- Result of the UntagResource operation returned by the service.
- See Also:
-
updateExport
default UpdateExportResponse updateExport(UpdateExportRequest updateExportRequest) throws InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Updates an existing data export by overwriting all export parameters. All export parameters must be provided in the UpdateExport request.
- Parameters:
updateExportRequest-- Returns:
- Result of the UpdateExport operation returned by the service.
- See Also:
-
updateExport
default UpdateExportResponse updateExport(Consumer<UpdateExportRequest.Builder> updateExportRequest) throws InternalServerException, ResourceNotFoundException, ThrottlingException, ValidationException, AwsServiceException, SdkClientException, BcmDataExportsException Updates an existing data export by overwriting all export parameters. All export parameters must be provided in the UpdateExport request.
This is a convenience which creates an instance of the
UpdateExportRequest.Builderavoiding the need to create one manually viaUpdateExportRequest.builder()- Parameters:
updateExportRequest- AConsumerthat will call methods onUpdateExportRequest.Builderto create a request.- Returns:
- Result of the UpdateExport operation returned by the service.
- See Also:
-
create
Create aBcmDataExportsClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider. -
builder
Create a builder that can be used to configure and create aBcmDataExportsClient. -
serviceMetadata
-
serviceClientConfiguration
Description copied from interface:SdkClientThe SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfigurationin interfaceAwsClient- Specified by:
serviceClientConfigurationin interfaceSdkClient- Returns:
- SdkServiceClientConfiguration
-