Package software.amazon.awssdk.services.keyspaces

Interface KeyspacesClient

All Superinterfaces:

AutoCloseable, AwsClient, SdkAutoCloseable, SdkClient

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

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

Amazon Keyspaces (for Apache Cassandra) is a scalable, highly available, and managed Apache Cassandra-compatible database service. Amazon Keyspaces makes it easy to migrate, run, and scale Cassandra workloads in the Amazon Web Services Cloud. With just a few clicks on the Amazon Web Services Management Console or a few lines of code, you can create keyspaces and tables in Amazon Keyspaces, without deploying any infrastructure or installing software.

In addition to supporting Cassandra Query Language (CQL) requests via open-source Cassandra drivers, Amazon Keyspaces supports data definition language (DDL) operations to manage keyspaces and tables using the Amazon Web Services SDK and CLI, as well as infrastructure as code (IaC) services and tools such as CloudFormation and Terraform. This API reference describes the supported DDL operations in detail.

For the list of all supported CQL APIs, see Supported Cassandra APIs, operations, and data types in Amazon Keyspaces in the Amazon Keyspaces Developer Guide.

To learn how Amazon Keyspaces API actions are recorded with CloudTrail, see Amazon Keyspaces information in CloudTrail in the Amazon Keyspaces Developer Guide.

For more information about Amazon Web Services APIs, for example how to implement retry logic or how to sign Amazon Web Services API requests, see Amazon Web Services APIs in the General Reference.

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 KeyspacesClientBuilder	builder()	Create a builder that can be used to configure and create a KeyspacesClient.
static KeyspacesClient	create()	Create a KeyspacesClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.
default CreateKeyspaceResponse	createKeyspace(Consumer<CreateKeyspaceRequest.Builder> createKeyspaceRequest)	The CreateKeyspace operation adds a new keyspace to your account.
default CreateKeyspaceResponse	createKeyspace(CreateKeyspaceRequest createKeyspaceRequest)	The CreateKeyspace operation adds a new keyspace to your account.
default CreateTableResponse	createTable(Consumer<CreateTableRequest.Builder> createTableRequest)	The CreateTable operation adds a new table to the specified keyspace.
default CreateTableResponse	createTable(CreateTableRequest createTableRequest)	The CreateTable operation adds a new table to the specified keyspace.
default DeleteKeyspaceResponse	deleteKeyspace(Consumer<DeleteKeyspaceRequest.Builder> deleteKeyspaceRequest)	The DeleteKeyspace operation deletes a keyspace and all of its tables.
default DeleteKeyspaceResponse	deleteKeyspace(DeleteKeyspaceRequest deleteKeyspaceRequest)	The DeleteKeyspace operation deletes a keyspace and all of its tables.
default DeleteTableResponse	deleteTable(Consumer<DeleteTableRequest.Builder> deleteTableRequest)	The DeleteTable operation deletes a table and all of its data.
default DeleteTableResponse	deleteTable(DeleteTableRequest deleteTableRequest)	The DeleteTable operation deletes a table and all of its data.
default GetKeyspaceResponse	getKeyspace(Consumer<GetKeyspaceRequest.Builder> getKeyspaceRequest)	Returns the name and the Amazon Resource Name (ARN) of the specified table.
default GetKeyspaceResponse	getKeyspace(GetKeyspaceRequest getKeyspaceRequest)	Returns the name and the Amazon Resource Name (ARN) of the specified table.
default GetTableResponse	getTable(Consumer<GetTableRequest.Builder> getTableRequest)	Returns information about the table, including the table's name and current status, the keyspace name, configuration settings, and metadata.
default GetTableResponse	getTable(GetTableRequest getTableRequest)	Returns information about the table, including the table's name and current status, the keyspace name, configuration settings, and metadata.
default ListKeyspacesResponse	listKeyspaces(Consumer<ListKeyspacesRequest.Builder> listKeyspacesRequest)	Returns a list of keyspaces.
default ListKeyspacesResponse	listKeyspaces(ListKeyspacesRequest listKeyspacesRequest)	Returns a list of keyspaces.
default ListKeyspacesIterable	listKeyspacesPaginator(Consumer<ListKeyspacesRequest.Builder> listKeyspacesRequest)	Returns a list of keyspaces.
default ListKeyspacesIterable	listKeyspacesPaginator(ListKeyspacesRequest listKeyspacesRequest)	Returns a list of keyspaces.
default ListTablesResponse	listTables(Consumer<ListTablesRequest.Builder> listTablesRequest)	Returns a list of tables for a specified keyspace.
default ListTablesResponse	listTables(ListTablesRequest listTablesRequest)	Returns a list of tables for a specified keyspace.
default ListTablesIterable	listTablesPaginator(Consumer<ListTablesRequest.Builder> listTablesRequest)	Returns a list of tables for a specified keyspace.
default ListTablesIterable	listTablesPaginator(ListTablesRequest listTablesRequest)	Returns a list of tables for a specified keyspace.
default ListTagsForResourceResponse	listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest)	Returns a list of all tags associated with the specified Amazon Keyspaces resource.
default ListTagsForResourceResponse	listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)	Returns a list of all tags associated with the specified Amazon Keyspaces resource.
default ListTagsForResourceIterable	listTagsForResourcePaginator(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest)	Returns a list of all tags associated with the specified Amazon Keyspaces resource.
default ListTagsForResourceIterable	listTagsForResourcePaginator(ListTagsForResourceRequest listTagsForResourceRequest)	Returns a list of all tags associated with the specified Amazon Keyspaces resource.
default RestoreTableResponse	restoreTable(Consumer<RestoreTableRequest.Builder> restoreTableRequest)	Restores the specified table to the specified point in time within the earliest_restorable_timestamp and the current time.
default RestoreTableResponse	restoreTable(RestoreTableRequest restoreTableRequest)	Restores the specified table to the specified point in time within the earliest_restorable_timestamp and the current time.
default KeyspacesServiceClientConfiguration	serviceClientConfiguration()	The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration
static ServiceMetadata	serviceMetadata()
default TagResourceResponse	tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest)	Associates a set of tags with a Amazon Keyspaces resource.
default TagResourceResponse	tagResource(TagResourceRequest tagResourceRequest)	Associates a set of tags with a Amazon Keyspaces resource.
default UntagResourceResponse	untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest)	Removes the association of tags from a Amazon Keyspaces resource.
default UntagResourceResponse	untagResource(UntagResourceRequest untagResourceRequest)	Removes the association of tags from a Amazon Keyspaces resource.
default UpdateTableResponse	updateTable(Consumer<UpdateTableRequest.Builder> updateTableRequest)	Adds new columns to the table or updates one of the table's settings, for example capacity mode, encryption, point-in-time recovery, or ttl settings.
default UpdateTableResponse	updateTable(UpdateTableRequest updateTableRequest)	Adds new columns to the table or updates one of the table's settings, for example capacity mode, encryption, point-in-time recovery, or ttl settings.

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

createKeyspace

default CreateKeyspaceResponse createKeyspace(CreateKeyspaceRequest createKeyspaceRequest)
                                       throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
ConflictException,
AccessDeniedException,
AwsServiceException,
SdkClientException,
KeyspacesException

The CreateKeyspace operation adds a new keyspace to your account. In an Amazon Web Services account, keyspace names must be unique within each Region.

CreateKeyspace is an asynchronous operation. You can monitor the creation status of the new keyspace by using the GetKeyspace operation.

For more information, see Creating keyspaces in the Amazon Keyspaces Developer Guide.

Parameters:

createKeyspaceRequest -

Returns:

Result of the CreateKeyspace operation returned by the service.

See Also:

• AWS API Documentation

createKeyspace

default CreateKeyspaceResponse createKeyspace(Consumer<CreateKeyspaceRequest.Builder> createKeyspaceRequest)
                                       throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
ConflictException,
AccessDeniedException,
AwsServiceException,
SdkClientException,
KeyspacesException

The CreateKeyspace operation adds a new keyspace to your account. In an Amazon Web Services account, keyspace names must be unique within each Region.

CreateKeyspace is an asynchronous operation. You can monitor the creation status of the new keyspace by using the GetKeyspace operation.

For more information, see Creating keyspaces in the Amazon Keyspaces Developer Guide.

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

Parameters:

createKeyspaceRequest - A Consumer that will call methods on CreateKeyspaceRequest.Builder to create a request.

Returns:

Result of the CreateKeyspace operation returned by the service.

See Also:

• AWS API Documentation

createTable

default CreateTableResponse createTable(CreateTableRequest createTableRequest)
                                 throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
ConflictException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

The CreateTable operation adds a new table to the specified keyspace. Within a keyspace, table names must be unique.

CreateTable is an asynchronous operation. When the request is received, the status of the table is set to CREATING. You can monitor the creation status of the new table by using the GetTable operation, which returns the current status of the table. You can start using a table when the status is ACTIVE.

For more information, see Creating tables in the Amazon Keyspaces Developer Guide.

Parameters:

createTableRequest -

Returns:

Result of the CreateTable operation returned by the service.

See Also:

• AWS API Documentation

createTable

default CreateTableResponse createTable(Consumer<CreateTableRequest.Builder> createTableRequest)
                                 throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
ConflictException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

The CreateTable operation adds a new table to the specified keyspace. Within a keyspace, table names must be unique.

CreateTable is an asynchronous operation. When the request is received, the status of the table is set to CREATING. You can monitor the creation status of the new table by using the GetTable operation, which returns the current status of the table. You can start using a table when the status is ACTIVE.

For more information, see Creating tables in the Amazon Keyspaces Developer Guide.

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

Parameters:

createTableRequest - A Consumer that will call methods on CreateTableRequest.Builder to create a request.

Returns:

Result of the CreateTable operation returned by the service.

See Also:

• AWS API Documentation

deleteKeyspace

default DeleteKeyspaceResponse deleteKeyspace(DeleteKeyspaceRequest deleteKeyspaceRequest)
                                       throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
ConflictException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

The DeleteKeyspace operation deletes a keyspace and all of its tables.

Parameters:

deleteKeyspaceRequest -

Returns:

Result of the DeleteKeyspace operation returned by the service.

See Also:

• AWS API Documentation

deleteKeyspace

default DeleteKeyspaceResponse deleteKeyspace(Consumer<DeleteKeyspaceRequest.Builder> deleteKeyspaceRequest)
                                       throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
ConflictException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

The DeleteKeyspace operation deletes a keyspace and all of its tables.

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

Parameters:

deleteKeyspaceRequest - A Consumer that will call methods on DeleteKeyspaceRequest.Builder to create a request.

Returns:

Result of the DeleteKeyspace operation returned by the service.

See Also:

• AWS API Documentation

deleteTable

default DeleteTableResponse deleteTable(DeleteTableRequest deleteTableRequest)
                                 throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
ConflictException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

The DeleteTable operation deletes a table and all of its data. After a DeleteTable request is received, the specified table is in the DELETING state until Amazon Keyspaces completes the deletion. If the table is in the ACTIVE state, you can delete it. If a table is either in the CREATING or UPDATING states, then Amazon Keyspaces returns a ResourceInUseException. If the specified table does not exist, Amazon Keyspaces returns a ResourceNotFoundException. If the table is already in the DELETING state, no error is returned.

Parameters:

deleteTableRequest -

Returns:

Result of the DeleteTable operation returned by the service.

See Also:

• AWS API Documentation

deleteTable

default DeleteTableResponse deleteTable(Consumer<DeleteTableRequest.Builder> deleteTableRequest)
                                 throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
ConflictException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

The DeleteTable operation deletes a table and all of its data. After a DeleteTable request is received, the specified table is in the DELETING state until Amazon Keyspaces completes the deletion. If the table is in the ACTIVE state, you can delete it. If a table is either in the CREATING or UPDATING states, then Amazon Keyspaces returns a ResourceInUseException. If the specified table does not exist, Amazon Keyspaces returns a ResourceNotFoundException. If the table is already in the DELETING state, no error is returned.

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

Parameters:

deleteTableRequest - A Consumer that will call methods on DeleteTableRequest.Builder to create a request.

Returns:

Result of the DeleteTable operation returned by the service.

See Also:

• AWS API Documentation

getKeyspace

default GetKeyspaceResponse getKeyspace(GetKeyspaceRequest getKeyspaceRequest)
                                 throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Returns the name and the Amazon Resource Name (ARN) of the specified table.

Parameters:

getKeyspaceRequest -

Returns:

Result of the GetKeyspace operation returned by the service.

See Also:

• AWS API Documentation

getKeyspace

default GetKeyspaceResponse getKeyspace(Consumer<GetKeyspaceRequest.Builder> getKeyspaceRequest)
                                 throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Returns the name and the Amazon Resource Name (ARN) of the specified table.

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

Parameters:

getKeyspaceRequest - A Consumer that will call methods on GetKeyspaceRequest.Builder to create a request.

Returns:

Result of the GetKeyspace operation returned by the service.

See Also:

• AWS API Documentation

getTable

default GetTableResponse getTable(GetTableRequest getTableRequest)
                           throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Returns information about the table, including the table's name and current status, the keyspace name, configuration settings, and metadata.

To read table metadata using GetTable, Select action permissions for the table and system tables are required to complete the operation.

Parameters:

getTableRequest -

Returns:

Result of the GetTable operation returned by the service.

See Also:

• AWS API Documentation

getTable

default GetTableResponse getTable(Consumer<GetTableRequest.Builder> getTableRequest)
                           throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Returns information about the table, including the table's name and current status, the keyspace name, configuration settings, and metadata.

To read table metadata using GetTable, Select action permissions for the table and system tables are required to complete the operation.

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

Parameters:

getTableRequest - A Consumer that will call methods on GetTableRequest.Builder to create a request.

Returns:

Result of the GetTable operation returned by the service.

See Also:

• AWS API Documentation

listKeyspaces

default ListKeyspacesResponse listKeyspaces(ListKeyspacesRequest listKeyspacesRequest)
                                     throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Returns a list of keyspaces.

Parameters:

listKeyspacesRequest -

Returns:

Result of the ListKeyspaces operation returned by the service.

See Also:

• AWS API Documentation

listKeyspaces

default ListKeyspacesResponse listKeyspaces(Consumer<ListKeyspacesRequest.Builder> listKeyspacesRequest)
                                     throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Returns a list of keyspaces.

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

Parameters:

listKeyspacesRequest - A Consumer that will call methods on ListKeyspacesRequest.Builder to create a request.

Returns:

Result of the ListKeyspaces operation returned by the service.

See Also:

• AWS API Documentation

listKeyspacesPaginator

default ListKeyspacesIterable listKeyspacesPaginator(ListKeyspacesRequest listKeyspacesRequest)
                                              throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Returns a list of keyspaces.

This is a variant of listKeyspaces(software.amazon.awssdk.services.keyspaces.model.ListKeyspacesRequest) 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.keyspaces.paginators.ListKeyspacesIterable responses = client.listKeyspacesPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.keyspaces.paginators.ListKeyspacesIterable responses = client.listKeyspacesPaginator(request);
     for (software.amazon.awssdk.services.keyspaces.model.ListKeyspacesResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.keyspaces.paginators.ListKeyspacesIterable responses = client.listKeyspacesPaginator(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 listKeyspaces(software.amazon.awssdk.services.keyspaces.model.ListKeyspacesRequest) operation.

Parameters:

listKeyspacesRequest -

Returns:

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

See Also:

• AWS API Documentation

listKeyspacesPaginator

default ListKeyspacesIterable listKeyspacesPaginator(Consumer<ListKeyspacesRequest.Builder> listKeyspacesRequest)
                                              throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Returns a list of keyspaces.

This is a variant of listKeyspaces(software.amazon.awssdk.services.keyspaces.model.ListKeyspacesRequest) 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.keyspaces.paginators.ListKeyspacesIterable responses = client.listKeyspacesPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.keyspaces.paginators.ListKeyspacesIterable responses = client.listKeyspacesPaginator(request);
     for (software.amazon.awssdk.services.keyspaces.model.ListKeyspacesResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.keyspaces.paginators.ListKeyspacesIterable responses = client.listKeyspacesPaginator(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 listKeyspaces(software.amazon.awssdk.services.keyspaces.model.ListKeyspacesRequest) operation.

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

Parameters:

listKeyspacesRequest - A Consumer that will call methods on ListKeyspacesRequest.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

listTables

default ListTablesResponse listTables(ListTablesRequest listTablesRequest)
                               throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Returns a list of tables for a specified keyspace.

Parameters:

listTablesRequest -

Returns:

Result of the ListTables operation returned by the service.

See Also:

• AWS API Documentation

listTables

default ListTablesResponse listTables(Consumer<ListTablesRequest.Builder> listTablesRequest)
                               throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Returns a list of tables for a specified keyspace.

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

Parameters:

listTablesRequest - A Consumer that will call methods on ListTablesRequest.Builder to create a request.

Returns:

Result of the ListTables operation returned by the service.

See Also:

• AWS API Documentation

listTablesPaginator

default ListTablesIterable listTablesPaginator(ListTablesRequest listTablesRequest)
                                        throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Returns a list of tables for a specified keyspace.

This is a variant of listTables(software.amazon.awssdk.services.keyspaces.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

 
 software.amazon.awssdk.services.keyspaces.paginators.ListTablesIterable responses = client.listTablesPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.keyspaces.paginators.ListTablesIterable responses = client.listTablesPaginator(request);
     for (software.amazon.awssdk.services.keyspaces.model.ListTablesResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.keyspaces.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.keyspaces.model.ListTablesRequest) operation.

Parameters:

listTablesRequest -

Returns:

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

See Also:

• AWS API Documentation

listTablesPaginator

default ListTablesIterable listTablesPaginator(Consumer<ListTablesRequest.Builder> listTablesRequest)
                                        throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Returns a list of tables for a specified keyspace.

This is a variant of listTables(software.amazon.awssdk.services.keyspaces.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

 
 software.amazon.awssdk.services.keyspaces.paginators.ListTablesIterable responses = client.listTablesPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.keyspaces.paginators.ListTablesIterable responses = client.listTablesPaginator(request);
     for (software.amazon.awssdk.services.keyspaces.model.ListTablesResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.keyspaces.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.keyspaces.model.ListTablesRequest) operation.

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

Parameters:

listTablesRequest - A Consumer that will call methods on ListTablesRequest.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

listTagsForResource

default ListTagsForResourceResponse listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
                                                 throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Returns a list of all tags associated with the specified Amazon Keyspaces resource.

Parameters:

listTagsForResourceRequest -

Returns:

Result of the ListTagsForResource operation returned by the service.

See Also:

• AWS API Documentation

listTagsForResource

default ListTagsForResourceResponse listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest)
                                                 throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Returns a list of all tags associated with the specified Amazon Keyspaces resource.

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:

Result of the ListTagsForResource operation returned by the service.

See Also:

• AWS API Documentation

listTagsForResourcePaginator

default ListTagsForResourceIterable listTagsForResourcePaginator(ListTagsForResourceRequest listTagsForResourceRequest)
                                                          throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Returns a list of all tags associated with the specified Amazon Keyspaces resource.

This is a variant of listTagsForResource(software.amazon.awssdk.services.keyspaces.model.ListTagsForResourceRequest) 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.keyspaces.paginators.ListTagsForResourceIterable responses = client.listTagsForResourcePaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.keyspaces.paginators.ListTagsForResourceIterable responses = client
             .listTagsForResourcePaginator(request);
     for (software.amazon.awssdk.services.keyspaces.model.ListTagsForResourceResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.keyspaces.paginators.ListTagsForResourceIterable responses = client.listTagsForResourcePaginator(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 listTagsForResource(software.amazon.awssdk.services.keyspaces.model.ListTagsForResourceRequest) operation.

Parameters:

listTagsForResourceRequest -

Returns:

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

See Also:

• AWS API Documentation

listTagsForResourcePaginator

default ListTagsForResourceIterable listTagsForResourcePaginator(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest)
                                                          throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Returns a list of all tags associated with the specified Amazon Keyspaces resource.

This is a variant of listTagsForResource(software.amazon.awssdk.services.keyspaces.model.ListTagsForResourceRequest) 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.keyspaces.paginators.ListTagsForResourceIterable responses = client.listTagsForResourcePaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.keyspaces.paginators.ListTagsForResourceIterable responses = client
             .listTagsForResourcePaginator(request);
     for (software.amazon.awssdk.services.keyspaces.model.ListTagsForResourceResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.keyspaces.paginators.ListTagsForResourceIterable responses = client.listTagsForResourcePaginator(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 listTagsForResource(software.amazon.awssdk.services.keyspaces.model.ListTagsForResourceRequest) operation.

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 custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

restoreTable

default RestoreTableResponse restoreTable(RestoreTableRequest restoreTableRequest)
                                   throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
ConflictException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Restores the specified table to the specified point in time within the earliest_restorable_timestamp and the current time. For more information about restore points, see Time window for PITR continuous backups in the Amazon Keyspaces Developer Guide.

Any number of users can execute up to 4 concurrent restores (any type of restore) in a given account.

When you restore using point in time recovery, Amazon Keyspaces restores your source table's schema and data to the state based on the selected timestamp (day:hour:minute:second) to a new table. The Time to Live (TTL) settings are also restored to the state based on the selected timestamp.

In addition to the table's schema, data, and TTL settings, RestoreTable restores the capacity mode, encryption, and point-in-time recovery settings from the source table. Unlike the table's schema data and TTL settings, which are restored based on the selected timestamp, these settings are always restored based on the table's settings as of the current time or when the table was deleted.

You can also overwrite these settings during restore:

• Read/write capacity mode

• Provisioned throughput capacity settings

• Point-in-time (PITR) settings

• Tags

For more information, see PITR restore settings in the Amazon Keyspaces Developer Guide.

Note that the following settings are not restored, and you must configure them manually for the new table:

• Automatic scaling policies (for tables that use provisioned capacity mode)

• Identity and Access Management (IAM) policies

• Amazon CloudWatch metrics and alarms

Parameters:

restoreTableRequest -

Returns:

Result of the RestoreTable operation returned by the service.

See Also:

• AWS API Documentation

restoreTable

default RestoreTableResponse restoreTable(Consumer<RestoreTableRequest.Builder> restoreTableRequest)
                                   throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
ConflictException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Restores the specified table to the specified point in time within the earliest_restorable_timestamp and the current time. For more information about restore points, see Time window for PITR continuous backups in the Amazon Keyspaces Developer Guide.

Any number of users can execute up to 4 concurrent restores (any type of restore) in a given account.

When you restore using point in time recovery, Amazon Keyspaces restores your source table's schema and data to the state based on the selected timestamp (day:hour:minute:second) to a new table. The Time to Live (TTL) settings are also restored to the state based on the selected timestamp.

In addition to the table's schema, data, and TTL settings, RestoreTable restores the capacity mode, encryption, and point-in-time recovery settings from the source table. Unlike the table's schema data and TTL settings, which are restored based on the selected timestamp, these settings are always restored based on the table's settings as of the current time or when the table was deleted.

You can also overwrite these settings during restore:

• Read/write capacity mode

• Provisioned throughput capacity settings

• Point-in-time (PITR) settings

• Tags

For more information, see PITR restore settings in the Amazon Keyspaces Developer Guide.

Note that the following settings are not restored, and you must configure them manually for the new table:

• Automatic scaling policies (for tables that use provisioned capacity mode)

• Identity and Access Management (IAM) policies

• Amazon CloudWatch metrics and alarms

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

Parameters:

restoreTableRequest - A Consumer that will call methods on RestoreTableRequest.Builder to create a request.

Returns:

Result of the RestoreTable operation returned by the service.

See Also:

• AWS API Documentation

tagResource

default TagResourceResponse tagResource(TagResourceRequest tagResourceRequest)
                                 throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Associates a set of tags with a Amazon Keyspaces resource. You can then activate these user-defined tags so that they appear on the Cost Management Console for cost allocation tracking. For more information, see Adding tags and labels to Amazon Keyspaces resources in the Amazon Keyspaces Developer Guide.

For IAM policy examples that show how to control access to Amazon Keyspaces resources based on tags, see Amazon Keyspaces resource access based on tags in the Amazon Keyspaces Developer Guide.

Parameters:

tagResourceRequest -

Returns:

Result of the TagResource operation returned by the service.

See Also:

• AWS API Documentation

tagResource

default TagResourceResponse tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest)
                                 throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Associates a set of tags with a Amazon Keyspaces resource. You can then activate these user-defined tags so that they appear on the Cost Management Console for cost allocation tracking. For more information, see Adding tags and labels to Amazon Keyspaces resources in the Amazon Keyspaces Developer Guide.

For IAM policy examples that show how to control access to Amazon Keyspaces resources based on tags, see Amazon Keyspaces resource access based on tags in the Amazon Keyspaces Developer Guide.

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:

Result of the TagResource operation returned by the service.

See Also:

• AWS API Documentation

untagResource

default UntagResourceResponse untagResource(UntagResourceRequest untagResourceRequest)
                                     throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
ConflictException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Removes the association of tags from a Amazon Keyspaces resource.

Parameters:

untagResourceRequest -

Returns:

Result of the UntagResource operation returned by the service.

See Also:

• AWS API Documentation

untagResource

default UntagResourceResponse untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest)
                                     throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
ConflictException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Removes the association of tags from a Amazon Keyspaces resource.

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:

Result of the UntagResource operation returned by the service.

See Also:

• AWS API Documentation

updateTable

default UpdateTableResponse updateTable(UpdateTableRequest updateTableRequest)
                                 throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
ConflictException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Adds new columns to the table or updates one of the table's settings, for example capacity mode, encryption, point-in-time recovery, or ttl settings. Note that you can only update one specific table setting per update operation.

Parameters:

updateTableRequest -

Returns:

Result of the UpdateTable operation returned by the service.

See Also:

• AWS API Documentation

updateTable

default UpdateTableResponse updateTable(Consumer<UpdateTableRequest.Builder> updateTableRequest)
                                 throws ValidationException,
ServiceQuotaExceededException,
InternalServerException,
ConflictException,
AccessDeniedException,
ResourceNotFoundException,
AwsServiceException,
SdkClientException,
KeyspacesException

Adds new columns to the table or updates one of the table's settings, for example capacity mode, encryption, point-in-time recovery, or ttl settings. Note that you can only update one specific table setting per update operation.

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

Parameters:

updateTableRequest - A Consumer that will call methods on UpdateTableRequest.Builder to create a request.

Returns:

Result of the UpdateTable operation returned by the service.

See Also:

• AWS API Documentation

create

static KeyspacesClient create()

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

builder

static KeyspacesClientBuilder builder()

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

serviceMetadata

static ServiceMetadata serviceMetadata()

serviceClientConfiguration

default KeyspacesServiceClientConfiguration 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