Interface S3TablesAsyncClient

All Superinterfaces:
AutoCloseable, AwsClient, SdkAutoCloseable, SdkClient
@Generated("software.amazon.awssdk:codegen") @SdkPublicApi @ThreadSafe public interface S3TablesAsyncClient extends AwsClient
Service client for accessing Amazon S3 Tables asynchronously. This can be created using the static builder() method.The asynchronous client performs non-blocking I/O when configured with any SdkAsyncHttpClient supported in the SDK. However, full non-blocking is not guaranteed as the async client may perform blocking calls in some cases such as credentials retrieval and endpoint discovery as part of the async API call.

An Amazon S3 table represents a structured dataset consisting of tabular data in Apache Parquet format and related metadata. This data is stored inside an S3 table as a subresource. All tables in a table bucket are stored in the Apache Iceberg table format. Through integration with the Amazon Web Services Glue Data Catalog you can interact with your tables using Amazon Web Services analytics services, such as Amazon Athena and Amazon Redshift. Amazon S3 manages maintenance of your tables through automatic file compaction and snapshot management. For more information, see Amazon S3 table buckets.

  • Field Details

  • Method Details

    • createNamespace

      default CompletableFuture<CreateNamespaceResponse> createNamespace(CreateNamespaceRequest createNamespaceRequest)

      Creates a namespace. A namespace is a logical grouping of tables within your table bucket, which you can use to organize tables. For more information, see Create a namespace in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:CreateNamespace permission to use this operation.

      Parameters:
      createNamespaceRequest -
      Returns:
      A Java Future containing the result of the CreateNamespace operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createNamespace

      default CompletableFuture<CreateNamespaceResponse> createNamespace(Consumer<CreateNamespaceRequest.Builder> createNamespaceRequest)

      Creates a namespace. A namespace is a logical grouping of tables within your table bucket, which you can use to organize tables. For more information, see Create a namespace in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:CreateNamespace permission to use this operation.


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

      Parameters:
      createNamespaceRequest - A Consumer that will call methods on CreateNamespaceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreateNamespace operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createTable

      default CompletableFuture<CreateTableResponse> createTable(CreateTableRequest createTableRequest)

      Creates a new table associated with the given namespace in a table bucket. For more information, see Creating an Amazon S3 table in the Amazon Simple Storage Service User Guide.

      Permissions

      • You must have the s3tables:CreateTable permission to use this operation.

      • If you use this operation with the optional metadata request parameter you must have the s3tables:PutTableData permission.

      • If you use this operation with the optional encryptionConfiguration request parameter you must have the s3tables:PutTableEncryption permission.

      Additionally, If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see Permissions requirements for S3 Tables SSE-KMS encryption.

      Parameters:
      createTableRequest -
      Returns:
      A Java Future containing the result of the CreateTable operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createTable

      default CompletableFuture<CreateTableResponse> createTable(Consumer<CreateTableRequest.Builder> createTableRequest)

      Creates a new table associated with the given namespace in a table bucket. For more information, see Creating an Amazon S3 table in the Amazon Simple Storage Service User Guide.

      Permissions

      • You must have the s3tables:CreateTable permission to use this operation.

      • If you use this operation with the optional metadata request parameter you must have the s3tables:PutTableData permission.

      • If you use this operation with the optional encryptionConfiguration request parameter you must have the s3tables:PutTableEncryption permission.

      Additionally, If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see Permissions requirements for S3 Tables SSE-KMS encryption.


      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:
      A Java Future containing the result of the CreateTable operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createTableBucket

      default CompletableFuture<CreateTableBucketResponse> createTableBucket(CreateTableBucketRequest createTableBucketRequest)

      Creates a table bucket. For more information, see Creating a table bucket in the Amazon Simple Storage Service User Guide.

      Permissions

      • You must have the s3tables:CreateTableBucket permission to use this operation.

      • If you use this operation with the optional encryptionConfiguration parameter you must have the s3tables:PutTableBucketEncryption permission.

      Parameters:
      createTableBucketRequest -
      Returns:
      A Java Future containing the result of the CreateTableBucket operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createTableBucket

      default CompletableFuture<CreateTableBucketResponse> createTableBucket(Consumer<CreateTableBucketRequest.Builder> createTableBucketRequest)

      Creates a table bucket. For more information, see Creating a table bucket in the Amazon Simple Storage Service User Guide.

      Permissions

      • You must have the s3tables:CreateTableBucket permission to use this operation.

      • If you use this operation with the optional encryptionConfiguration parameter you must have the s3tables:PutTableBucketEncryption permission.


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

      Parameters:
      createTableBucketRequest - A Consumer that will call methods on CreateTableBucketRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreateTableBucket operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteNamespace

      default CompletableFuture<DeleteNamespaceResponse> deleteNamespace(DeleteNamespaceRequest deleteNamespaceRequest)

      Deletes a namespace. For more information, see Delete a namespace in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:DeleteNamespace permission to use this operation.

      Parameters:
      deleteNamespaceRequest -
      Returns:
      A Java Future containing the result of the DeleteNamespace operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteNamespace

      default CompletableFuture<DeleteNamespaceResponse> deleteNamespace(Consumer<DeleteNamespaceRequest.Builder> deleteNamespaceRequest)

      Deletes a namespace. For more information, see Delete a namespace in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:DeleteNamespace permission to use this operation.


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

      Parameters:
      deleteNamespaceRequest - A Consumer that will call methods on DeleteNamespaceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteNamespace operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteTable

      default CompletableFuture<DeleteTableResponse> deleteTable(DeleteTableRequest deleteTableRequest)

      Deletes a table. For more information, see Deleting an Amazon S3 table in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:DeleteTable permission to use this operation.

      Parameters:
      deleteTableRequest -
      Returns:
      A Java Future containing the result of the DeleteTable operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteTable

      default CompletableFuture<DeleteTableResponse> deleteTable(Consumer<DeleteTableRequest.Builder> deleteTableRequest)

      Deletes a table. For more information, see Deleting an Amazon S3 table in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:DeleteTable permission to use this operation.


      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:
      A Java Future containing the result of the DeleteTable operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteTableBucket

      default CompletableFuture<DeleteTableBucketResponse> deleteTableBucket(DeleteTableBucketRequest deleteTableBucketRequest)

      Deletes a table bucket. For more information, see Deleting a table bucket in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:DeleteTableBucket permission to use this operation.

      Parameters:
      deleteTableBucketRequest -
      Returns:
      A Java Future containing the result of the DeleteTableBucket operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteTableBucket

      default CompletableFuture<DeleteTableBucketResponse> deleteTableBucket(Consumer<DeleteTableBucketRequest.Builder> deleteTableBucketRequest)

      Deletes a table bucket. For more information, see Deleting a table bucket in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:DeleteTableBucket permission to use this operation.


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

      Parameters:
      deleteTableBucketRequest - A Consumer that will call methods on DeleteTableBucketRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteTableBucket operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteTableBucketEncryption

      default CompletableFuture<DeleteTableBucketEncryptionResponse> deleteTableBucketEncryption(DeleteTableBucketEncryptionRequest deleteTableBucketEncryptionRequest)

      Deletes the encryption configuration for a table bucket.

      Permissions

      You must have the s3tables:DeleteTableBucketEncryption permission to use this operation.

      Parameters:
      deleteTableBucketEncryptionRequest -
      Returns:
      A Java Future containing the result of the DeleteTableBucketEncryption operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteTableBucketEncryption

      default CompletableFuture<DeleteTableBucketEncryptionResponse> deleteTableBucketEncryption(Consumer<DeleteTableBucketEncryptionRequest.Builder> deleteTableBucketEncryptionRequest)

      Deletes the encryption configuration for a table bucket.

      Permissions

      You must have the s3tables:DeleteTableBucketEncryption permission to use this operation.


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

      Parameters:
      deleteTableBucketEncryptionRequest - A Consumer that will call methods on DeleteTableBucketEncryptionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteTableBucketEncryption operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteTableBucketPolicy

      default CompletableFuture<DeleteTableBucketPolicyResponse> deleteTableBucketPolicy(DeleteTableBucketPolicyRequest deleteTableBucketPolicyRequest)

      Deletes a table bucket policy. For more information, see Deleting a table bucket policy in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:DeleteTableBucketPolicy permission to use this operation.

      Parameters:
      deleteTableBucketPolicyRequest -
      Returns:
      A Java Future containing the result of the DeleteTableBucketPolicy operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteTableBucketPolicy

      default CompletableFuture<DeleteTableBucketPolicyResponse> deleteTableBucketPolicy(Consumer<DeleteTableBucketPolicyRequest.Builder> deleteTableBucketPolicyRequest)

      Deletes a table bucket policy. For more information, see Deleting a table bucket policy in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:DeleteTableBucketPolicy permission to use this operation.


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

      Parameters:
      deleteTableBucketPolicyRequest - A Consumer that will call methods on DeleteTableBucketPolicyRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteTableBucketPolicy operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteTablePolicy

      default CompletableFuture<DeleteTablePolicyResponse> deleteTablePolicy(DeleteTablePolicyRequest deleteTablePolicyRequest)

      Deletes a table policy. For more information, see Deleting a table policy in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:DeleteTablePolicy permission to use this operation.

      Parameters:
      deleteTablePolicyRequest -
      Returns:
      A Java Future containing the result of the DeleteTablePolicy operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteTablePolicy

      default CompletableFuture<DeleteTablePolicyResponse> deleteTablePolicy(Consumer<DeleteTablePolicyRequest.Builder> deleteTablePolicyRequest)

      Deletes a table policy. For more information, see Deleting a table policy in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:DeleteTablePolicy permission to use this operation.


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

      Parameters:
      deleteTablePolicyRequest - A Consumer that will call methods on DeleteTablePolicyRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteTablePolicy operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getNamespace

      default CompletableFuture<GetNamespaceResponse> getNamespace(GetNamespaceRequest getNamespaceRequest)

      Gets details about a namespace. For more information, see Table namespaces in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:GetNamespace permission to use this operation.

      Parameters:
      getNamespaceRequest -
      Returns:
      A Java Future containing the result of the GetNamespace operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • AccessDeniedException The action cannot be performed because you do not have the required permission.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getNamespace

      default CompletableFuture<GetNamespaceResponse> getNamespace(Consumer<GetNamespaceRequest.Builder> getNamespaceRequest)

      Gets details about a namespace. For more information, see Table namespaces in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:GetNamespace permission to use this operation.


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

      Parameters:
      getNamespaceRequest - A Consumer that will call methods on GetNamespaceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetNamespace operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • AccessDeniedException The action cannot be performed because you do not have the required permission.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTable

      default CompletableFuture<GetTableResponse> getTable(GetTableRequest getTableRequest)

      Gets details about a table. For more information, see S3 Tables in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:GetTable permission to use this operation.

      Parameters:
      getTableRequest -
      Returns:
      A Java Future containing the result of the GetTable operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • AccessDeniedException The action cannot be performed because you do not have the required permission.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTable

      default CompletableFuture<GetTableResponse> getTable(Consumer<GetTableRequest.Builder> getTableRequest)

      Gets details about a table. For more information, see S3 Tables in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:GetTable permission to use this 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:
      A Java Future containing the result of the GetTable operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • AccessDeniedException The action cannot be performed because you do not have the required permission.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTableBucket

      default CompletableFuture<GetTableBucketResponse> getTableBucket(GetTableBucketRequest getTableBucketRequest)

      Gets details on a table bucket. For more information, see Viewing details about an Amazon S3 table bucket in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:GetTableBucket permission to use this operation.

      Parameters:
      getTableBucketRequest -
      Returns:
      A Java Future containing the result of the GetTableBucket operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • AccessDeniedException The action cannot be performed because you do not have the required permission.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTableBucket

      default CompletableFuture<GetTableBucketResponse> getTableBucket(Consumer<GetTableBucketRequest.Builder> getTableBucketRequest)

      Gets details on a table bucket. For more information, see Viewing details about an Amazon S3 table bucket in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:GetTableBucket permission to use this operation.


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

      Parameters:
      getTableBucketRequest - A Consumer that will call methods on GetTableBucketRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetTableBucket operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • AccessDeniedException The action cannot be performed because you do not have the required permission.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTableBucketEncryption

      default CompletableFuture<GetTableBucketEncryptionResponse> getTableBucketEncryption(GetTableBucketEncryptionRequest getTableBucketEncryptionRequest)

      Gets the encryption configuration for a table bucket.

      Permissions

      You must have the s3tables:GetTableBucketEncryption permission to use this operation.

      Parameters:
      getTableBucketEncryptionRequest -
      Returns:
      A Java Future containing the result of the GetTableBucketEncryption operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • AccessDeniedException The action cannot be performed because you do not have the required permission.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTableBucketEncryption

      default CompletableFuture<GetTableBucketEncryptionResponse> getTableBucketEncryption(Consumer<GetTableBucketEncryptionRequest.Builder> getTableBucketEncryptionRequest)

      Gets the encryption configuration for a table bucket.

      Permissions

      You must have the s3tables:GetTableBucketEncryption permission to use this operation.


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

      Parameters:
      getTableBucketEncryptionRequest - A Consumer that will call methods on GetTableBucketEncryptionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetTableBucketEncryption operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • AccessDeniedException The action cannot be performed because you do not have the required permission.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTableBucketMaintenanceConfiguration

      default CompletableFuture<GetTableBucketMaintenanceConfigurationResponse> getTableBucketMaintenanceConfiguration(GetTableBucketMaintenanceConfigurationRequest getTableBucketMaintenanceConfigurationRequest)

      Gets details about a maintenance configuration for a given table bucket. For more information, see Amazon S3 table bucket maintenance in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:GetTableBucketMaintenanceConfiguration permission to use this operation.

      Parameters:
      getTableBucketMaintenanceConfigurationRequest -
      Returns:
      A Java Future containing the result of the GetTableBucketMaintenanceConfiguration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTableBucketMaintenanceConfiguration

      default CompletableFuture<GetTableBucketMaintenanceConfigurationResponse> getTableBucketMaintenanceConfiguration(Consumer<GetTableBucketMaintenanceConfigurationRequest.Builder> getTableBucketMaintenanceConfigurationRequest)

      Gets details about a maintenance configuration for a given table bucket. For more information, see Amazon S3 table bucket maintenance in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:GetTableBucketMaintenanceConfiguration permission to use this operation.


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

      Parameters:
      getTableBucketMaintenanceConfigurationRequest - A Consumer that will call methods on GetTableBucketMaintenanceConfigurationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetTableBucketMaintenanceConfiguration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTableBucketPolicy

      default CompletableFuture<GetTableBucketPolicyResponse> getTableBucketPolicy(GetTableBucketPolicyRequest getTableBucketPolicyRequest)

      Gets details about a table bucket policy. For more information, see Viewing a table bucket policy in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:GetTableBucketPolicy permission to use this operation.

      Parameters:
      getTableBucketPolicyRequest -
      Returns:
      A Java Future containing the result of the GetTableBucketPolicy operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTableBucketPolicy

      default CompletableFuture<GetTableBucketPolicyResponse> getTableBucketPolicy(Consumer<GetTableBucketPolicyRequest.Builder> getTableBucketPolicyRequest)

      Gets details about a table bucket policy. For more information, see Viewing a table bucket policy in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:GetTableBucketPolicy permission to use this operation.


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

      Parameters:
      getTableBucketPolicyRequest - A Consumer that will call methods on GetTableBucketPolicyRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetTableBucketPolicy operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTableEncryption

      default CompletableFuture<GetTableEncryptionResponse> getTableEncryption(GetTableEncryptionRequest getTableEncryptionRequest)

      Gets the encryption configuration for a table.

      Permissions

      You must have the s3tables:GetTableEncryption permission to use this operation.

      Parameters:
      getTableEncryptionRequest -
      Returns:
      A Java Future containing the result of the GetTableEncryption operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • AccessDeniedException The action cannot be performed because you do not have the required permission.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTableEncryption

      default CompletableFuture<GetTableEncryptionResponse> getTableEncryption(Consumer<GetTableEncryptionRequest.Builder> getTableEncryptionRequest)

      Gets the encryption configuration for a table.

      Permissions

      You must have the s3tables:GetTableEncryption permission to use this operation.


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

      Parameters:
      getTableEncryptionRequest - A Consumer that will call methods on GetTableEncryptionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetTableEncryption operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • AccessDeniedException The action cannot be performed because you do not have the required permission.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTableMaintenanceConfiguration

      default CompletableFuture<GetTableMaintenanceConfigurationResponse> getTableMaintenanceConfiguration(GetTableMaintenanceConfigurationRequest getTableMaintenanceConfigurationRequest)

      Gets details about the maintenance configuration of a table. For more information, see S3 Tables maintenance in the Amazon Simple Storage Service User Guide.

      Permissions

      • You must have the s3tables:GetTableMaintenanceConfiguration permission to use this operation.

      • You must have the s3tables:GetTableData permission to use set the compaction strategy to sort or zorder.

      Parameters:
      getTableMaintenanceConfigurationRequest -
      Returns:
      A Java Future containing the result of the GetTableMaintenanceConfiguration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTableMaintenanceConfiguration

      default CompletableFuture<GetTableMaintenanceConfigurationResponse> getTableMaintenanceConfiguration(Consumer<GetTableMaintenanceConfigurationRequest.Builder> getTableMaintenanceConfigurationRequest)

      Gets details about the maintenance configuration of a table. For more information, see S3 Tables maintenance in the Amazon Simple Storage Service User Guide.

      Permissions

      • You must have the s3tables:GetTableMaintenanceConfiguration permission to use this operation.

      • You must have the s3tables:GetTableData permission to use set the compaction strategy to sort or zorder.


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

      Parameters:
      getTableMaintenanceConfigurationRequest - A Consumer that will call methods on GetTableMaintenanceConfigurationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetTableMaintenanceConfiguration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTableMaintenanceJobStatus

      default CompletableFuture<GetTableMaintenanceJobStatusResponse> getTableMaintenanceJobStatus(GetTableMaintenanceJobStatusRequest getTableMaintenanceJobStatusRequest)

      Gets the status of a maintenance job for a table. For more information, see S3 Tables maintenance in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:GetTableMaintenanceJobStatus permission to use this operation.

      Parameters:
      getTableMaintenanceJobStatusRequest -
      Returns:
      A Java Future containing the result of the GetTableMaintenanceJobStatus operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTableMaintenanceJobStatus

      default CompletableFuture<GetTableMaintenanceJobStatusResponse> getTableMaintenanceJobStatus(Consumer<GetTableMaintenanceJobStatusRequest.Builder> getTableMaintenanceJobStatusRequest)

      Gets the status of a maintenance job for a table. For more information, see S3 Tables maintenance in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:GetTableMaintenanceJobStatus permission to use this operation.


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

      Parameters:
      getTableMaintenanceJobStatusRequest - A Consumer that will call methods on GetTableMaintenanceJobStatusRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetTableMaintenanceJobStatus operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTableMetadataLocation

      default CompletableFuture<GetTableMetadataLocationResponse> getTableMetadataLocation(GetTableMetadataLocationRequest getTableMetadataLocationRequest)

      Gets the location of the table metadata.

      Permissions

      You must have the s3tables:GetTableMetadataLocation permission to use this operation.

      Parameters:
      getTableMetadataLocationRequest -
      Returns:
      A Java Future containing the result of the GetTableMetadataLocation operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTableMetadataLocation

      default CompletableFuture<GetTableMetadataLocationResponse> getTableMetadataLocation(Consumer<GetTableMetadataLocationRequest.Builder> getTableMetadataLocationRequest)

      Gets the location of the table metadata.

      Permissions

      You must have the s3tables:GetTableMetadataLocation permission to use this operation.


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

      Parameters:
      getTableMetadataLocationRequest - A Consumer that will call methods on GetTableMetadataLocationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetTableMetadataLocation operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTablePolicy

      default CompletableFuture<GetTablePolicyResponse> getTablePolicy(GetTablePolicyRequest getTablePolicyRequest)

      Gets details about a table policy. For more information, see Viewing a table policy in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:GetTablePolicy permission to use this operation.

      Parameters:
      getTablePolicyRequest -
      Returns:
      A Java Future containing the result of the GetTablePolicy operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getTablePolicy

      default CompletableFuture<GetTablePolicyResponse> getTablePolicy(Consumer<GetTablePolicyRequest.Builder> getTablePolicyRequest)

      Gets details about a table policy. For more information, see Viewing a table policy in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:GetTablePolicy permission to use this operation.


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

      Parameters:
      getTablePolicyRequest - A Consumer that will call methods on GetTablePolicyRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetTablePolicy operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listNamespaces

      default CompletableFuture<ListNamespacesResponse> listNamespaces(ListNamespacesRequest listNamespacesRequest)

      Lists the namespaces within a table bucket. For more information, see Table namespaces in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:ListNamespaces permission to use this operation.

      Parameters:
      listNamespacesRequest -
      Returns:
      A Java Future containing the result of the ListNamespaces operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • AccessDeniedException The action cannot be performed because you do not have the required permission.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listNamespaces

      default CompletableFuture<ListNamespacesResponse> listNamespaces(Consumer<ListNamespacesRequest.Builder> listNamespacesRequest)

      Lists the namespaces within a table bucket. For more information, see Table namespaces in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:ListNamespaces permission to use this operation.


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

      Parameters:
      listNamespacesRequest - A Consumer that will call methods on ListNamespacesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListNamespaces operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • AccessDeniedException The action cannot be performed because you do not have the required permission.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listNamespacesPaginator

      default ListNamespacesPublisher listNamespacesPaginator(ListNamespacesRequest listNamespacesRequest)

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

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

      The following are few ways to use the response class:

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

      Please notice that the configuration of maxNamespaces 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 listNamespaces(software.amazon.awssdk.services.s3tables.model.ListNamespacesRequest) operation.

      Parameters:
      listNamespacesRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • AccessDeniedException The action cannot be performed because you do not have the required permission.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listNamespacesPaginator

      default ListNamespacesPublisher listNamespacesPaginator(Consumer<ListNamespacesRequest.Builder> listNamespacesRequest)

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

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

      The following are few ways to use the response class:

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

      Please notice that the configuration of maxNamespaces 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 listNamespaces(software.amazon.awssdk.services.s3tables.model.ListNamespacesRequest) operation.


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

      Parameters:
      listNamespacesRequest - A Consumer that will call methods on ListNamespacesRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • AccessDeniedException The action cannot be performed because you do not have the required permission.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTableBuckets

      default CompletableFuture<ListTableBucketsResponse> listTableBuckets(ListTableBucketsRequest listTableBucketsRequest)

      Lists table buckets for your account. For more information, see S3 Table buckets in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:ListTableBuckets permission to use this operation.

      Parameters:
      listTableBucketsRequest -
      Returns:
      A Java Future containing the result of the ListTableBuckets operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • AccessDeniedException The action cannot be performed because you do not have the required permission.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTableBuckets

      default CompletableFuture<ListTableBucketsResponse> listTableBuckets(Consumer<ListTableBucketsRequest.Builder> listTableBucketsRequest)

      Lists table buckets for your account. For more information, see S3 Table buckets in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:ListTableBuckets permission to use this operation.


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

      Parameters:
      listTableBucketsRequest - A Consumer that will call methods on ListTableBucketsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListTableBuckets operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • AccessDeniedException The action cannot be performed because you do not have the required permission.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTableBucketsPaginator

      default ListTableBucketsPublisher listTableBucketsPaginator(ListTableBucketsRequest listTableBucketsRequest)

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

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

      The following are few ways to use the response class:

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

      Please notice that the configuration of maxBuckets 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 listTableBuckets(software.amazon.awssdk.services.s3tables.model.ListTableBucketsRequest) operation.

      Parameters:
      listTableBucketsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • AccessDeniedException The action cannot be performed because you do not have the required permission.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTableBucketsPaginator

      default ListTableBucketsPublisher listTableBucketsPaginator(Consumer<ListTableBucketsRequest.Builder> listTableBucketsRequest)

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

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

      The following are few ways to use the response class:

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

      Please notice that the configuration of maxBuckets 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 listTableBuckets(software.amazon.awssdk.services.s3tables.model.ListTableBucketsRequest) operation.


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

      Parameters:
      listTableBucketsRequest - A Consumer that will call methods on ListTableBucketsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • AccessDeniedException The action cannot be performed because you do not have the required permission.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTables

      default CompletableFuture<ListTablesResponse> listTables(ListTablesRequest listTablesRequest)

      List tables in the given table bucket. For more information, see S3 Tables in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:ListTables permission to use this operation.

      Parameters:
      listTablesRequest -
      Returns:
      A Java Future containing the result of the ListTables operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTables

      default CompletableFuture<ListTablesResponse> listTables(Consumer<ListTablesRequest.Builder> listTablesRequest)

      List tables in the given table bucket. For more information, see S3 Tables in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:ListTables permission to use this 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 Java Future containing the result of the ListTables operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTablesPaginator

      default ListTablesPublisher listTablesPaginator(ListTablesRequest listTablesRequest)

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

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

      The following are few ways to use the response class:

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

      Please notice that the configuration of maxTables 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.s3tables.model.ListTablesRequest) operation.

      Parameters:
      listTablesRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTablesPaginator

      default ListTablesPublisher listTablesPaginator(Consumer<ListTablesRequest.Builder> listTablesRequest)

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

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

      The following are few ways to use the response class:

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

      Please notice that the configuration of maxTables 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.s3tables.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 publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putTableBucketEncryption

      default CompletableFuture<PutTableBucketEncryptionResponse> putTableBucketEncryption(PutTableBucketEncryptionRequest putTableBucketEncryptionRequest)

      Sets the encryption configuration for a table bucket.

      Permissions

      You must have the s3tables:PutTableBucketEncryption permission to use this operation.

      If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see Permissions requirements for S3 Tables SSE-KMS encryption in the Amazon Simple Storage Service User Guide.

      Parameters:
      putTableBucketEncryptionRequest -
      Returns:
      A Java Future containing the result of the PutTableBucketEncryption operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putTableBucketEncryption

      default CompletableFuture<PutTableBucketEncryptionResponse> putTableBucketEncryption(Consumer<PutTableBucketEncryptionRequest.Builder> putTableBucketEncryptionRequest)

      Sets the encryption configuration for a table bucket.

      Permissions

      You must have the s3tables:PutTableBucketEncryption permission to use this operation.

      If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see Permissions requirements for S3 Tables SSE-KMS encryption in the Amazon Simple Storage Service User Guide.


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

      Parameters:
      putTableBucketEncryptionRequest - A Consumer that will call methods on PutTableBucketEncryptionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the PutTableBucketEncryption operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putTableBucketMaintenanceConfiguration

      default CompletableFuture<PutTableBucketMaintenanceConfigurationResponse> putTableBucketMaintenanceConfiguration(PutTableBucketMaintenanceConfigurationRequest putTableBucketMaintenanceConfigurationRequest)

      Creates a new maintenance configuration or replaces an existing maintenance configuration for a table bucket. For more information, see Amazon S3 table bucket maintenance in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:PutTableBucketMaintenanceConfiguration permission to use this operation.

      Parameters:
      putTableBucketMaintenanceConfigurationRequest -
      Returns:
      A Java Future containing the result of the PutTableBucketMaintenanceConfiguration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putTableBucketMaintenanceConfiguration

      default CompletableFuture<PutTableBucketMaintenanceConfigurationResponse> putTableBucketMaintenanceConfiguration(Consumer<PutTableBucketMaintenanceConfigurationRequest.Builder> putTableBucketMaintenanceConfigurationRequest)

      Creates a new maintenance configuration or replaces an existing maintenance configuration for a table bucket. For more information, see Amazon S3 table bucket maintenance in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:PutTableBucketMaintenanceConfiguration permission to use this operation.


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

      Parameters:
      putTableBucketMaintenanceConfigurationRequest - A Consumer that will call methods on PutTableBucketMaintenanceConfigurationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the PutTableBucketMaintenanceConfiguration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putTableBucketPolicy

      default CompletableFuture<PutTableBucketPolicyResponse> putTableBucketPolicy(PutTableBucketPolicyRequest putTableBucketPolicyRequest)

      Creates a new maintenance configuration or replaces an existing table bucket policy for a table bucket. For more information, see Adding a table bucket policy in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:PutTableBucketPolicy permission to use this operation.

      Parameters:
      putTableBucketPolicyRequest -
      Returns:
      A Java Future containing the result of the PutTableBucketPolicy operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putTableBucketPolicy

      default CompletableFuture<PutTableBucketPolicyResponse> putTableBucketPolicy(Consumer<PutTableBucketPolicyRequest.Builder> putTableBucketPolicyRequest)

      Creates a new maintenance configuration or replaces an existing table bucket policy for a table bucket. For more information, see Adding a table bucket policy in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:PutTableBucketPolicy permission to use this operation.


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

      Parameters:
      putTableBucketPolicyRequest - A Consumer that will call methods on PutTableBucketPolicyRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the PutTableBucketPolicy operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putTableMaintenanceConfiguration

      default CompletableFuture<PutTableMaintenanceConfigurationResponse> putTableMaintenanceConfiguration(PutTableMaintenanceConfigurationRequest putTableMaintenanceConfigurationRequest)

      Creates a new maintenance configuration or replaces an existing maintenance configuration for a table. For more information, see S3 Tables maintenance in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:PutTableMaintenanceConfiguration permission to use this operation.

      Parameters:
      putTableMaintenanceConfigurationRequest -
      Returns:
      A Java Future containing the result of the PutTableMaintenanceConfiguration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putTableMaintenanceConfiguration

      default CompletableFuture<PutTableMaintenanceConfigurationResponse> putTableMaintenanceConfiguration(Consumer<PutTableMaintenanceConfigurationRequest.Builder> putTableMaintenanceConfigurationRequest)

      Creates a new maintenance configuration or replaces an existing maintenance configuration for a table. For more information, see S3 Tables maintenance in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:PutTableMaintenanceConfiguration permission to use this operation.


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

      Parameters:
      putTableMaintenanceConfigurationRequest - A Consumer that will call methods on PutTableMaintenanceConfigurationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the PutTableMaintenanceConfiguration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putTablePolicy

      default CompletableFuture<PutTablePolicyResponse> putTablePolicy(PutTablePolicyRequest putTablePolicyRequest)

      Creates a new maintenance configuration or replaces an existing table policy for a table. For more information, see Adding a table policy in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:PutTablePolicy permission to use this operation.

      Parameters:
      putTablePolicyRequest -
      Returns:
      A Java Future containing the result of the PutTablePolicy operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • putTablePolicy

      default CompletableFuture<PutTablePolicyResponse> putTablePolicy(Consumer<PutTablePolicyRequest.Builder> putTablePolicyRequest)

      Creates a new maintenance configuration or replaces an existing table policy for a table. For more information, see Adding a table policy in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:PutTablePolicy permission to use this operation.


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

      Parameters:
      putTablePolicyRequest - A Consumer that will call methods on PutTablePolicyRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the PutTablePolicy operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • renameTable

      default CompletableFuture<RenameTableResponse> renameTable(RenameTableRequest renameTableRequest)

      Renames a table or a namespace. For more information, see S3 Tables in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:RenameTable permission to use this operation.

      Parameters:
      renameTableRequest -
      Returns:
      A Java Future containing the result of the RenameTable operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • renameTable

      default CompletableFuture<RenameTableResponse> renameTable(Consumer<RenameTableRequest.Builder> renameTableRequest)

      Renames a table or a namespace. For more information, see S3 Tables in the Amazon Simple Storage Service User Guide.

      Permissions

      You must have the s3tables:RenameTable permission to use this operation.


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

      Parameters:
      renameTableRequest - A Consumer that will call methods on RenameTableRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the RenameTable operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateTableMetadataLocation

      default CompletableFuture<UpdateTableMetadataLocationResponse> updateTableMetadataLocation(UpdateTableMetadataLocationRequest updateTableMetadataLocationRequest)

      Updates the metadata location for a table. The metadata location of a table must be an S3 URI that begins with the table's warehouse location. The metadata location for an Apache Iceberg table must end with .metadata.json, or if the metadata file is Gzip-compressed, .metadata.json.gz.

      Permissions

      You must have the s3tables:UpdateTableMetadataLocation permission to use this operation.

      Parameters:
      updateTableMetadataLocationRequest -
      Returns:
      A Java Future containing the result of the UpdateTableMetadataLocation operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateTableMetadataLocation

      default CompletableFuture<UpdateTableMetadataLocationResponse> updateTableMetadataLocation(Consumer<UpdateTableMetadataLocationRequest.Builder> updateTableMetadataLocationRequest)

      Updates the metadata location for a table. The metadata location of a table must be an S3 URI that begins with the table's warehouse location. The metadata location for an Apache Iceberg table must end with .metadata.json, or if the metadata file is Gzip-compressed, .metadata.json.gz.

      Permissions

      You must have the s3tables:UpdateTableMetadataLocation permission to use this operation.


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

      Parameters:
      updateTableMetadataLocationRequest - A Consumer that will call methods on UpdateTableMetadataLocationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UpdateTableMetadataLocation operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • InternalServerErrorException The request failed due to an internal server error.
      • ForbiddenException The caller isn't authorized to make the request.
      • NotFoundException The request was rejected because the specified resource could not be found.
      • TooManyRequestsException The limit on the number of requests per second was exceeded.
      • ConflictException The request failed because there is a conflict with a previous write. You can retry the request.
      • BadRequestException The request is invalid or malformed.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • S3TablesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • serviceClientConfiguration

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

    • create

      static S3TablesAsyncClient create()
      Create a S3TablesAsyncClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.

    • builder

      static S3TablesAsyncClientBuilder builder()
      Create a builder that can be used to configure and create a S3TablesAsyncClient.