Interface S3TablesClient
-
- All Superinterfaces:
AutoCloseable,AwsClient,SdkAutoCloseable,SdkClient
@Generated("software.amazon.awssdk:codegen") @ThreadSafe public interface S3TablesClient extends AwsClient
Service client for accessing Amazon S3 Tables. This can be created using the staticbuilder()method.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 AWS Glue Data Catalog you can interact with your tables using AWS 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 Summary
Fields Modifier and Type Field Description static StringSERVICE_METADATA_IDValue for looking up the service's metadata from theServiceMetadataProvider.static StringSERVICE_NAME
-
Method Summary
-
Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
close
-
Methods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
-
-
-
Field Detail
-
SERVICE_NAME
static final String SERVICE_NAME
- See Also:
- Constant Field Values
-
SERVICE_METADATA_ID
static final String SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider.- See Also:
- Constant Field Values
-
-
Method Detail
-
createNamespace
default CreateNamespaceResponse createNamespace(CreateNamespaceRequest createNamespaceRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:CreateNamespacepermission to use this operation.
- Parameters:
createNamespaceRequest-- Returns:
- Result of the CreateNamespace operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
createNamespace
default CreateNamespaceResponse createNamespace(Consumer<CreateNamespaceRequest.Builder> createNamespaceRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:CreateNamespacepermission to use this operation.
This is a convenience which creates an instance of the
CreateNamespaceRequest.Builderavoiding the need to create one manually viaCreateNamespaceRequest.builder()- Parameters:
createNamespaceRequest- AConsumerthat will call methods onCreateNamespaceRequest.Builderto create a request.- Returns:
- Result of the CreateNamespace operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
createTable
default CreateTableResponse createTable(CreateTableRequest createTableRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:CreateTablepermission to use this operation.Additionally, you must have the
s3tables:PutTableDatapermission to use this operation with the optionalmetadatarequest parameter.
- Parameters:
createTableRequest-- Returns:
- Result of the CreateTable operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
createTable
default CreateTableResponse createTable(Consumer<CreateTableRequest.Builder> createTableRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:CreateTablepermission to use this operation.Additionally, you must have the
s3tables:PutTableDatapermission to use this operation with the optionalmetadatarequest parameter.
This is a convenience which creates an instance of the
CreateTableRequest.Builderavoiding the need to create one manually viaCreateTableRequest.builder()- Parameters:
createTableRequest- AConsumerthat will call methods onCreateTableRequest.Builderto create a request.- Returns:
- Result of the CreateTable operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
createTableBucket
default CreateTableBucketResponse createTableBucket(CreateTableBucketRequest createTableBucketRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:CreateTableBucketpermission to use this operation.
- Parameters:
createTableBucketRequest-- Returns:
- Result of the CreateTableBucket operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
createTableBucket
default CreateTableBucketResponse createTableBucket(Consumer<CreateTableBucketRequest.Builder> createTableBucketRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:CreateTableBucketpermission to use this operation.
This is a convenience which creates an instance of the
CreateTableBucketRequest.Builderavoiding the need to create one manually viaCreateTableBucketRequest.builder()- Parameters:
createTableBucketRequest- AConsumerthat will call methods onCreateTableBucketRequest.Builderto create a request.- Returns:
- Result of the CreateTableBucket operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
deleteNamespace
default DeleteNamespaceResponse deleteNamespace(DeleteNamespaceRequest deleteNamespaceRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
Deletes a namespace. For more information, see Delete a namespace in the Amazon Simple Storage Service User Guide.
- Permissions
-
You must have the
s3tables:DeleteNamespacepermission to use this operation.
- Parameters:
deleteNamespaceRequest-- Returns:
- Result of the DeleteNamespace operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
deleteNamespace
default DeleteNamespaceResponse deleteNamespace(Consumer<DeleteNamespaceRequest.Builder> deleteNamespaceRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
Deletes a namespace. For more information, see Delete a namespace in the Amazon Simple Storage Service User Guide.
- Permissions
-
You must have the
s3tables:DeleteNamespacepermission to use this operation.
This is a convenience which creates an instance of the
DeleteNamespaceRequest.Builderavoiding the need to create one manually viaDeleteNamespaceRequest.builder()- Parameters:
deleteNamespaceRequest- AConsumerthat will call methods onDeleteNamespaceRequest.Builderto create a request.- Returns:
- Result of the DeleteNamespace operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
deleteTable
default DeleteTableResponse deleteTable(DeleteTableRequest deleteTableRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:DeleteTablepermission to use this operation.
- Parameters:
deleteTableRequest-- Returns:
- Result of the DeleteTable operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
deleteTable
default DeleteTableResponse deleteTable(Consumer<DeleteTableRequest.Builder> deleteTableRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:DeleteTablepermission to use this operation.
This is a convenience which creates an instance of the
DeleteTableRequest.Builderavoiding the need to create one manually viaDeleteTableRequest.builder()- Parameters:
deleteTableRequest- AConsumerthat will call methods onDeleteTableRequest.Builderto create a request.- Returns:
- Result of the DeleteTable operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
deleteTableBucket
default DeleteTableBucketResponse deleteTableBucket(DeleteTableBucketRequest deleteTableBucketRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:DeleteTableBucketpermission to use this operation.
- Parameters:
deleteTableBucketRequest-- Returns:
- Result of the DeleteTableBucket operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
deleteTableBucket
default DeleteTableBucketResponse deleteTableBucket(Consumer<DeleteTableBucketRequest.Builder> deleteTableBucketRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:DeleteTableBucketpermission to use this operation.
This is a convenience which creates an instance of the
DeleteTableBucketRequest.Builderavoiding the need to create one manually viaDeleteTableBucketRequest.builder()- Parameters:
deleteTableBucketRequest- AConsumerthat will call methods onDeleteTableBucketRequest.Builderto create a request.- Returns:
- Result of the DeleteTableBucket operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
deleteTableBucketPolicy
default DeleteTableBucketPolicyResponse deleteTableBucketPolicy(DeleteTableBucketPolicyRequest deleteTableBucketPolicyRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:DeleteTableBucketPolicypermission to use this operation.
- Parameters:
deleteTableBucketPolicyRequest-- Returns:
- Result of the DeleteTableBucketPolicy operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
deleteTableBucketPolicy
default DeleteTableBucketPolicyResponse deleteTableBucketPolicy(Consumer<DeleteTableBucketPolicyRequest.Builder> deleteTableBucketPolicyRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:DeleteTableBucketPolicypermission to use this operation.
This is a convenience which creates an instance of the
DeleteTableBucketPolicyRequest.Builderavoiding the need to create one manually viaDeleteTableBucketPolicyRequest.builder()- Parameters:
deleteTableBucketPolicyRequest- AConsumerthat will call methods onDeleteTableBucketPolicyRequest.Builderto create a request.- Returns:
- Result of the DeleteTableBucketPolicy operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
deleteTablePolicy
default DeleteTablePolicyResponse deleteTablePolicy(DeleteTablePolicyRequest deleteTablePolicyRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:DeleteTablePolicypermission to use this operation.
- Parameters:
deleteTablePolicyRequest-- Returns:
- Result of the DeleteTablePolicy operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
deleteTablePolicy
default DeleteTablePolicyResponse deleteTablePolicy(Consumer<DeleteTablePolicyRequest.Builder> deleteTablePolicyRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:DeleteTablePolicypermission to use this operation.
This is a convenience which creates an instance of the
DeleteTablePolicyRequest.Builderavoiding the need to create one manually viaDeleteTablePolicyRequest.builder()- Parameters:
deleteTablePolicyRequest- AConsumerthat will call methods onDeleteTablePolicyRequest.Builderto create a request.- Returns:
- Result of the DeleteTablePolicy operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
getNamespace
default GetNamespaceResponse getNamespace(GetNamespaceRequest getNamespaceRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, AccessDeniedException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:GetNamespacepermission to use this operation.
- Parameters:
getNamespaceRequest-- Returns:
- Result of the GetNamespace operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
getNamespace
default GetNamespaceResponse getNamespace(Consumer<GetNamespaceRequest.Builder> getNamespaceRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, AccessDeniedException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:GetNamespacepermission to use this operation.
This is a convenience which creates an instance of the
GetNamespaceRequest.Builderavoiding the need to create one manually viaGetNamespaceRequest.builder()- Parameters:
getNamespaceRequest- AConsumerthat will call methods onGetNamespaceRequest.Builderto create a request.- Returns:
- Result of the GetNamespace operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
getTable
default GetTableResponse getTable(GetTableRequest getTableRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, AccessDeniedException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:GetTablepermission to use this operation.
- Parameters:
getTableRequest-- Returns:
- Result of the GetTable operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
getTable
default GetTableResponse getTable(Consumer<GetTableRequest.Builder> getTableRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, AccessDeniedException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:GetTablepermission to use this operation.
This is a convenience which creates an instance of the
GetTableRequest.Builderavoiding the need to create one manually viaGetTableRequest.builder()- Parameters:
getTableRequest- AConsumerthat will call methods onGetTableRequest.Builderto create a request.- Returns:
- Result of the GetTable operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
getTableBucket
default GetTableBucketResponse getTableBucket(GetTableBucketRequest getTableBucketRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, AccessDeniedException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:GetTableBucketpermission to use this operation.
- Parameters:
getTableBucketRequest-- Returns:
- Result of the GetTableBucket operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
getTableBucket
default GetTableBucketResponse getTableBucket(Consumer<GetTableBucketRequest.Builder> getTableBucketRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, AccessDeniedException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:GetTableBucketpermission to use this operation.
This is a convenience which creates an instance of the
GetTableBucketRequest.Builderavoiding the need to create one manually viaGetTableBucketRequest.builder()- Parameters:
getTableBucketRequest- AConsumerthat will call methods onGetTableBucketRequest.Builderto create a request.- Returns:
- Result of the GetTableBucket operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
getTableBucketMaintenanceConfiguration
default GetTableBucketMaintenanceConfigurationResponse getTableBucketMaintenanceConfiguration(GetTableBucketMaintenanceConfigurationRequest getTableBucketMaintenanceConfigurationRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:GetTableBucketMaintenanceConfigurationpermission to use this operation.
- Parameters:
getTableBucketMaintenanceConfigurationRequest-- Returns:
- Result of the GetTableBucketMaintenanceConfiguration operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
getTableBucketMaintenanceConfiguration
default GetTableBucketMaintenanceConfigurationResponse getTableBucketMaintenanceConfiguration(Consumer<GetTableBucketMaintenanceConfigurationRequest.Builder> getTableBucketMaintenanceConfigurationRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:GetTableBucketMaintenanceConfigurationpermission to use this operation.
This is a convenience which creates an instance of the
GetTableBucketMaintenanceConfigurationRequest.Builderavoiding the need to create one manually viaGetTableBucketMaintenanceConfigurationRequest.builder()- Parameters:
getTableBucketMaintenanceConfigurationRequest- AConsumerthat will call methods onGetTableBucketMaintenanceConfigurationRequest.Builderto create a request.- Returns:
- Result of the GetTableBucketMaintenanceConfiguration operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
getTableBucketPolicy
default GetTableBucketPolicyResponse getTableBucketPolicy(GetTableBucketPolicyRequest getTableBucketPolicyRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:GetTableBucketPolicypermission to use this operation.
- Parameters:
getTableBucketPolicyRequest-- Returns:
- Result of the GetTableBucketPolicy operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
getTableBucketPolicy
default GetTableBucketPolicyResponse getTableBucketPolicy(Consumer<GetTableBucketPolicyRequest.Builder> getTableBucketPolicyRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:GetTableBucketPolicypermission to use this operation.
This is a convenience which creates an instance of the
GetTableBucketPolicyRequest.Builderavoiding the need to create one manually viaGetTableBucketPolicyRequest.builder()- Parameters:
getTableBucketPolicyRequest- AConsumerthat will call methods onGetTableBucketPolicyRequest.Builderto create a request.- Returns:
- Result of the GetTableBucketPolicy operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
getTableMaintenanceConfiguration
default GetTableMaintenanceConfigurationResponse getTableMaintenanceConfiguration(GetTableMaintenanceConfigurationRequest getTableMaintenanceConfigurationRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:GetTableMaintenanceConfigurationpermission to use this operation.
- Parameters:
getTableMaintenanceConfigurationRequest-- Returns:
- Result of the GetTableMaintenanceConfiguration operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
getTableMaintenanceConfiguration
default GetTableMaintenanceConfigurationResponse getTableMaintenanceConfiguration(Consumer<GetTableMaintenanceConfigurationRequest.Builder> getTableMaintenanceConfigurationRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:GetTableMaintenanceConfigurationpermission to use this operation.
This is a convenience which creates an instance of the
GetTableMaintenanceConfigurationRequest.Builderavoiding the need to create one manually viaGetTableMaintenanceConfigurationRequest.builder()- Parameters:
getTableMaintenanceConfigurationRequest- AConsumerthat will call methods onGetTableMaintenanceConfigurationRequest.Builderto create a request.- Returns:
- Result of the GetTableMaintenanceConfiguration operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
getTableMaintenanceJobStatus
default GetTableMaintenanceJobStatusResponse getTableMaintenanceJobStatus(GetTableMaintenanceJobStatusRequest getTableMaintenanceJobStatusRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:GetTableMaintenanceJobStatuspermission to use this operation.
- Parameters:
getTableMaintenanceJobStatusRequest-- Returns:
- Result of the GetTableMaintenanceJobStatus operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
getTableMaintenanceJobStatus
default GetTableMaintenanceJobStatusResponse getTableMaintenanceJobStatus(Consumer<GetTableMaintenanceJobStatusRequest.Builder> getTableMaintenanceJobStatusRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:GetTableMaintenanceJobStatuspermission to use this operation.
This is a convenience which creates an instance of the
GetTableMaintenanceJobStatusRequest.Builderavoiding the need to create one manually viaGetTableMaintenanceJobStatusRequest.builder()- Parameters:
getTableMaintenanceJobStatusRequest- AConsumerthat will call methods onGetTableMaintenanceJobStatusRequest.Builderto create a request.- Returns:
- Result of the GetTableMaintenanceJobStatus operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
getTableMetadataLocation
default GetTableMetadataLocationResponse getTableMetadataLocation(GetTableMetadataLocationRequest getTableMetadataLocationRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
Gets the location of the table metadata.
- Permissions
-
You must have the
s3tables:GetTableMetadataLocationpermission to use this operation.
- Parameters:
getTableMetadataLocationRequest-- Returns:
- Result of the GetTableMetadataLocation operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
getTableMetadataLocation
default GetTableMetadataLocationResponse getTableMetadataLocation(Consumer<GetTableMetadataLocationRequest.Builder> getTableMetadataLocationRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
Gets the location of the table metadata.
- Permissions
-
You must have the
s3tables:GetTableMetadataLocationpermission to use this operation.
This is a convenience which creates an instance of the
GetTableMetadataLocationRequest.Builderavoiding the need to create one manually viaGetTableMetadataLocationRequest.builder()- Parameters:
getTableMetadataLocationRequest- AConsumerthat will call methods onGetTableMetadataLocationRequest.Builderto create a request.- Returns:
- Result of the GetTableMetadataLocation operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
getTablePolicy
default GetTablePolicyResponse getTablePolicy(GetTablePolicyRequest getTablePolicyRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:GetTablePolicypermission to use this operation.
- Parameters:
getTablePolicyRequest-- Returns:
- Result of the GetTablePolicy operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
getTablePolicy
default GetTablePolicyResponse getTablePolicy(Consumer<GetTablePolicyRequest.Builder> getTablePolicyRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:GetTablePolicypermission to use this operation.
This is a convenience which creates an instance of the
GetTablePolicyRequest.Builderavoiding the need to create one manually viaGetTablePolicyRequest.builder()- Parameters:
getTablePolicyRequest- AConsumerthat will call methods onGetTablePolicyRequest.Builderto create a request.- Returns:
- Result of the GetTablePolicy operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
listNamespaces
default ListNamespacesResponse listNamespaces(ListNamespacesRequest listNamespacesRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, AccessDeniedException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:ListNamespacespermission to use this operation.
- Parameters:
listNamespacesRequest-- Returns:
- Result of the ListNamespaces operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
listNamespaces
default ListNamespacesResponse listNamespaces(Consumer<ListNamespacesRequest.Builder> listNamespacesRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, AccessDeniedException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:ListNamespacespermission to use this operation.
This is a convenience which creates an instance of the
ListNamespacesRequest.Builderavoiding the need to create one manually viaListNamespacesRequest.builder()- Parameters:
listNamespacesRequest- AConsumerthat will call methods onListNamespacesRequest.Builderto create a request.- Returns:
- Result of the ListNamespaces operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
listNamespacesPaginator
default ListNamespacesIterable listNamespacesPaginator(ListNamespacesRequest listNamespacesRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, AccessDeniedException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
This is a variant of
listNamespaces(software.amazon.awssdk.services.s3tables.model.ListNamespacesRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.s3tables.paginators.ListNamespacesIterable responses = client.listNamespacesPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.s3tables.paginators.ListNamespacesIterable responses = client .listNamespacesPaginator(request); for (software.amazon.awssdk.services.s3tables.model.ListNamespacesResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.s3tables.paginators.ListNamespacesIterable responses = client.listNamespacesPaginator(request); responses.iterator().forEachRemaining(....);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 iterable that can be used to iterate through all the response pages.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
listNamespacesPaginator
default ListNamespacesIterable listNamespacesPaginator(Consumer<ListNamespacesRequest.Builder> listNamespacesRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, AccessDeniedException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
This is a variant of
listNamespaces(software.amazon.awssdk.services.s3tables.model.ListNamespacesRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.s3tables.paginators.ListNamespacesIterable responses = client.listNamespacesPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.s3tables.paginators.ListNamespacesIterable responses = client .listNamespacesPaginator(request); for (software.amazon.awssdk.services.s3tables.model.ListNamespacesResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.s3tables.paginators.ListNamespacesIterable responses = client.listNamespacesPaginator(request); responses.iterator().forEachRemaining(....);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.Builderavoiding the need to create one manually viaListNamespacesRequest.builder()- Parameters:
listNamespacesRequest- AConsumerthat will call methods onListNamespacesRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
listTableBuckets
default ListTableBucketsResponse listTableBuckets(ListTableBucketsRequest listTableBucketsRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, AccessDeniedException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:ListTableBucketspermission to use this operation.
- Parameters:
listTableBucketsRequest-- Returns:
- Result of the ListTableBuckets operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
listTableBuckets
default ListTableBucketsResponse listTableBuckets(Consumer<ListTableBucketsRequest.Builder> listTableBucketsRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, AccessDeniedException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:ListTableBucketspermission to use this operation.
This is a convenience which creates an instance of the
ListTableBucketsRequest.Builderavoiding the need to create one manually viaListTableBucketsRequest.builder()- Parameters:
listTableBucketsRequest- AConsumerthat will call methods onListTableBucketsRequest.Builderto create a request.- Returns:
- Result of the ListTableBuckets operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
listTableBucketsPaginator
default ListTableBucketsIterable listTableBucketsPaginator(ListTableBucketsRequest listTableBucketsRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, AccessDeniedException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
This is a variant of
listTableBuckets(software.amazon.awssdk.services.s3tables.model.ListTableBucketsRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.s3tables.paginators.ListTableBucketsIterable responses = client.listTableBucketsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.s3tables.paginators.ListTableBucketsIterable responses = client .listTableBucketsPaginator(request); for (software.amazon.awssdk.services.s3tables.model.ListTableBucketsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.s3tables.paginators.ListTableBucketsIterable responses = client.listTableBucketsPaginator(request); responses.iterator().forEachRemaining(....);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 iterable that can be used to iterate through all the response pages.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
listTableBucketsPaginator
default ListTableBucketsIterable listTableBucketsPaginator(Consumer<ListTableBucketsRequest.Builder> listTableBucketsRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, AccessDeniedException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
This is a variant of
listTableBuckets(software.amazon.awssdk.services.s3tables.model.ListTableBucketsRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.s3tables.paginators.ListTableBucketsIterable responses = client.listTableBucketsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.s3tables.paginators.ListTableBucketsIterable responses = client .listTableBucketsPaginator(request); for (software.amazon.awssdk.services.s3tables.model.ListTableBucketsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.s3tables.paginators.ListTableBucketsIterable responses = client.listTableBucketsPaginator(request); responses.iterator().forEachRemaining(....);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.Builderavoiding the need to create one manually viaListTableBucketsRequest.builder()- Parameters:
listTableBucketsRequest- AConsumerthat will call methods onListTableBucketsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
listTables
default ListTablesResponse listTables(ListTablesRequest listTablesRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:ListTablespermission to use this operation.
- Parameters:
listTablesRequest-- Returns:
- Result of the ListTables operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
listTables
default ListTablesResponse listTables(Consumer<ListTablesRequest.Builder> listTablesRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:ListTablespermission to use this operation.
This is a convenience which creates an instance of the
ListTablesRequest.Builderavoiding the need to create one manually viaListTablesRequest.builder()- Parameters:
listTablesRequest- AConsumerthat will call methods onListTablesRequest.Builderto create a request.- Returns:
- Result of the ListTables operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
listTablesPaginator
default ListTablesIterable listTablesPaginator(ListTablesRequest listTablesRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
This is a variant of
listTables(software.amazon.awssdk.services.s3tables.model.ListTablesRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.s3tables.paginators.ListTablesIterable responses = client.listTablesPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.s3tables.paginators.ListTablesIterable responses = client.listTablesPaginator(request); for (software.amazon.awssdk.services.s3tables.model.ListTablesResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.s3tables.paginators.ListTablesIterable responses = client.listTablesPaginator(request); responses.iterator().forEachRemaining(....);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 iterable that can be used to iterate through all the response pages.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
listTablesPaginator
default ListTablesIterable listTablesPaginator(Consumer<ListTablesRequest.Builder> listTablesRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
This is a variant of
listTables(software.amazon.awssdk.services.s3tables.model.ListTablesRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.s3tables.paginators.ListTablesIterable responses = client.listTablesPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.s3tables.paginators.ListTablesIterable responses = client.listTablesPaginator(request); for (software.amazon.awssdk.services.s3tables.model.ListTablesResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.s3tables.paginators.ListTablesIterable responses = client.listTablesPaginator(request); responses.iterator().forEachRemaining(....);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.Builderavoiding the need to create one manually viaListTablesRequest.builder()- Parameters:
listTablesRequest- AConsumerthat will call methods onListTablesRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
putTableBucketMaintenanceConfiguration
default PutTableBucketMaintenanceConfigurationResponse putTableBucketMaintenanceConfiguration(PutTableBucketMaintenanceConfigurationRequest putTableBucketMaintenanceConfigurationRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:PutTableBucketMaintenanceConfigurationpermission to use this operation.
- Parameters:
putTableBucketMaintenanceConfigurationRequest-- Returns:
- Result of the PutTableBucketMaintenanceConfiguration operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
putTableBucketMaintenanceConfiguration
default PutTableBucketMaintenanceConfigurationResponse putTableBucketMaintenanceConfiguration(Consumer<PutTableBucketMaintenanceConfigurationRequest.Builder> putTableBucketMaintenanceConfigurationRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:PutTableBucketMaintenanceConfigurationpermission to use this operation.
This is a convenience which creates an instance of the
PutTableBucketMaintenanceConfigurationRequest.Builderavoiding the need to create one manually viaPutTableBucketMaintenanceConfigurationRequest.builder()- Parameters:
putTableBucketMaintenanceConfigurationRequest- AConsumerthat will call methods onPutTableBucketMaintenanceConfigurationRequest.Builderto create a request.- Returns:
- Result of the PutTableBucketMaintenanceConfiguration operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
putTableBucketPolicy
default PutTableBucketPolicyResponse putTableBucketPolicy(PutTableBucketPolicyRequest putTableBucketPolicyRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:PutTableBucketPolicypermission to use this operation.
- Parameters:
putTableBucketPolicyRequest-- Returns:
- Result of the PutTableBucketPolicy operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
putTableBucketPolicy
default PutTableBucketPolicyResponse putTableBucketPolicy(Consumer<PutTableBucketPolicyRequest.Builder> putTableBucketPolicyRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:PutTableBucketPolicypermission to use this operation.
This is a convenience which creates an instance of the
PutTableBucketPolicyRequest.Builderavoiding the need to create one manually viaPutTableBucketPolicyRequest.builder()- Parameters:
putTableBucketPolicyRequest- AConsumerthat will call methods onPutTableBucketPolicyRequest.Builderto create a request.- Returns:
- Result of the PutTableBucketPolicy operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
putTableMaintenanceConfiguration
default PutTableMaintenanceConfigurationResponse putTableMaintenanceConfiguration(PutTableMaintenanceConfigurationRequest putTableMaintenanceConfigurationRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:PutTableMaintenanceConfigurationpermission to use this operation.
- Parameters:
putTableMaintenanceConfigurationRequest-- Returns:
- Result of the PutTableMaintenanceConfiguration operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
putTableMaintenanceConfiguration
default PutTableMaintenanceConfigurationResponse putTableMaintenanceConfiguration(Consumer<PutTableMaintenanceConfigurationRequest.Builder> putTableMaintenanceConfigurationRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:PutTableMaintenanceConfigurationpermission to use this operation.
This is a convenience which creates an instance of the
PutTableMaintenanceConfigurationRequest.Builderavoiding the need to create one manually viaPutTableMaintenanceConfigurationRequest.builder()- Parameters:
putTableMaintenanceConfigurationRequest- AConsumerthat will call methods onPutTableMaintenanceConfigurationRequest.Builderto create a request.- Returns:
- Result of the PutTableMaintenanceConfiguration operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
putTablePolicy
default PutTablePolicyResponse putTablePolicy(PutTablePolicyRequest putTablePolicyRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:PutTablePolicypermission to use this operation.
- Parameters:
putTablePolicyRequest-- Returns:
- Result of the PutTablePolicy operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
putTablePolicy
default PutTablePolicyResponse putTablePolicy(Consumer<PutTablePolicyRequest.Builder> putTablePolicyRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:PutTablePolicypermission to use this operation.
This is a convenience which creates an instance of the
PutTablePolicyRequest.Builderavoiding the need to create one manually viaPutTablePolicyRequest.builder()- Parameters:
putTablePolicyRequest- AConsumerthat will call methods onPutTablePolicyRequest.Builderto create a request.- Returns:
- Result of the PutTablePolicy operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
renameTable
default RenameTableResponse renameTable(RenameTableRequest renameTableRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:RenameTablepermission to use this operation.
- Parameters:
renameTableRequest-- Returns:
- Result of the RenameTable operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
renameTable
default RenameTableResponse renameTable(Consumer<RenameTableRequest.Builder> renameTableRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:RenameTablepermission to use this operation.
This is a convenience which creates an instance of the
RenameTableRequest.Builderavoiding the need to create one manually viaRenameTableRequest.builder()- Parameters:
renameTableRequest- AConsumerthat will call methods onRenameTableRequest.Builderto create a request.- Returns:
- Result of the RenameTable operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
updateTableMetadataLocation
default UpdateTableMetadataLocationResponse updateTableMetadataLocation(UpdateTableMetadataLocationRequest updateTableMetadataLocationRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:UpdateTableMetadataLocationpermission to use this operation.
- Parameters:
updateTableMetadataLocationRequest-- Returns:
- Result of the UpdateTableMetadataLocation operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
updateTableMetadataLocation
default UpdateTableMetadataLocationResponse updateTableMetadataLocation(Consumer<UpdateTableMetadataLocationRequest.Builder> updateTableMetadataLocationRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException
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:UpdateTableMetadataLocationpermission to use this operation.
This is a convenience which creates an instance of the
UpdateTableMetadataLocationRequest.Builderavoiding the need to create one manually viaUpdateTableMetadataLocationRequest.builder()- Parameters:
updateTableMetadataLocationRequest- AConsumerthat will call methods onUpdateTableMetadataLocationRequest.Builderto create a request.- Returns:
- Result of the UpdateTableMetadataLocation operation returned by the service.
- Throws:
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.AwsServiceException- See Also:
- AWS API Documentation
-
create
static S3TablesClient create()
Create aS3TablesClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider.
-
builder
static S3TablesClientBuilder builder()
Create a builder that can be used to configure and create aS3TablesClient.
-
serviceMetadata
static ServiceMetadata serviceMetadata()
-
serviceClientConfiguration
default S3TablesServiceClientConfiguration serviceClientConfiguration()
- Specified by:
serviceClientConfigurationin interfaceAwsClient- Specified by:
serviceClientConfigurationin interfaceSdkClient
-
-