Interface S3TablesClient
- All Superinterfaces:
AutoCloseable,AwsClient,SdkAutoCloseable,SdkClient
builder() 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 Amazon Web Services Glue Data Catalog you can interact with your tables using Amazon Web Services analytics services, such as Amazon Athena and Amazon Redshift. Amazon S3 manages maintenance of your tables through automatic file compaction and snapshot management. For more information, see Amazon S3 table buckets.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringValue for looking up the service's metadata from theServiceMetadataProvider.static final String -
Method Summary
Modifier and TypeMethodDescriptionstatic S3TablesClientBuilderbuilder()Create a builder that can be used to configure and create aS3TablesClient.static S3TablesClientcreate()Create aS3TablesClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider.default CreateNamespaceResponsecreateNamespace(Consumer<CreateNamespaceRequest.Builder> createNamespaceRequest) Creates a namespace.default CreateNamespaceResponsecreateNamespace(CreateNamespaceRequest createNamespaceRequest) Creates a namespace.default CreateTableResponsecreateTable(Consumer<CreateTableRequest.Builder> createTableRequest) Creates a new table associated with the given namespace in a table bucket.default CreateTableResponsecreateTable(CreateTableRequest createTableRequest) Creates a new table associated with the given namespace in a table bucket.default CreateTableBucketResponsecreateTableBucket(Consumer<CreateTableBucketRequest.Builder> createTableBucketRequest) Creates a table bucket.default CreateTableBucketResponsecreateTableBucket(CreateTableBucketRequest createTableBucketRequest) Creates a table bucket.default DeleteNamespaceResponsedeleteNamespace(Consumer<DeleteNamespaceRequest.Builder> deleteNamespaceRequest) Deletes a namespace.default DeleteNamespaceResponsedeleteNamespace(DeleteNamespaceRequest deleteNamespaceRequest) Deletes a namespace.default DeleteTableResponsedeleteTable(Consumer<DeleteTableRequest.Builder> deleteTableRequest) Deletes a table.default DeleteTableResponsedeleteTable(DeleteTableRequest deleteTableRequest) Deletes a table.default DeleteTableBucketResponsedeleteTableBucket(Consumer<DeleteTableBucketRequest.Builder> deleteTableBucketRequest) Deletes a table bucket.default DeleteTableBucketResponsedeleteTableBucket(DeleteTableBucketRequest deleteTableBucketRequest) Deletes a table bucket.deleteTableBucketEncryption(Consumer<DeleteTableBucketEncryptionRequest.Builder> deleteTableBucketEncryptionRequest) Deletes the encryption configuration for a table bucket.deleteTableBucketEncryption(DeleteTableBucketEncryptionRequest deleteTableBucketEncryptionRequest) Deletes the encryption configuration for a table bucket.default DeleteTableBucketPolicyResponsedeleteTableBucketPolicy(Consumer<DeleteTableBucketPolicyRequest.Builder> deleteTableBucketPolicyRequest) Deletes a table bucket policy.default DeleteTableBucketPolicyResponsedeleteTableBucketPolicy(DeleteTableBucketPolicyRequest deleteTableBucketPolicyRequest) Deletes a table bucket policy.default DeleteTablePolicyResponsedeleteTablePolicy(Consumer<DeleteTablePolicyRequest.Builder> deleteTablePolicyRequest) Deletes a table policy.default DeleteTablePolicyResponsedeleteTablePolicy(DeleteTablePolicyRequest deleteTablePolicyRequest) Deletes a table policy.default GetNamespaceResponsegetNamespace(Consumer<GetNamespaceRequest.Builder> getNamespaceRequest) Gets details about a namespace.default GetNamespaceResponsegetNamespace(GetNamespaceRequest getNamespaceRequest) Gets details about a namespace.default GetTableResponsegetTable(Consumer<GetTableRequest.Builder> getTableRequest) Gets details about a table.default GetTableResponsegetTable(GetTableRequest getTableRequest) Gets details about a table.default GetTableBucketResponsegetTableBucket(Consumer<GetTableBucketRequest.Builder> getTableBucketRequest) Gets details on a table bucket.default GetTableBucketResponsegetTableBucket(GetTableBucketRequest getTableBucketRequest) Gets details on a table bucket.default GetTableBucketEncryptionResponsegetTableBucketEncryption(Consumer<GetTableBucketEncryptionRequest.Builder> getTableBucketEncryptionRequest) Gets the encryption configuration for a table bucket.default GetTableBucketEncryptionResponsegetTableBucketEncryption(GetTableBucketEncryptionRequest getTableBucketEncryptionRequest) Gets the encryption configuration for a table bucket.getTableBucketMaintenanceConfiguration(Consumer<GetTableBucketMaintenanceConfigurationRequest.Builder> getTableBucketMaintenanceConfigurationRequest) Gets details about a maintenance configuration for a given table bucket.getTableBucketMaintenanceConfiguration(GetTableBucketMaintenanceConfigurationRequest getTableBucketMaintenanceConfigurationRequest) Gets details about a maintenance configuration for a given table bucket.default GetTableBucketPolicyResponsegetTableBucketPolicy(Consumer<GetTableBucketPolicyRequest.Builder> getTableBucketPolicyRequest) Gets details about a table bucket policy.default GetTableBucketPolicyResponsegetTableBucketPolicy(GetTableBucketPolicyRequest getTableBucketPolicyRequest) Gets details about a table bucket policy.default GetTableEncryptionResponsegetTableEncryption(Consumer<GetTableEncryptionRequest.Builder> getTableEncryptionRequest) Gets the encryption configuration for a table.default GetTableEncryptionResponsegetTableEncryption(GetTableEncryptionRequest getTableEncryptionRequest) Gets the encryption configuration for a table.getTableMaintenanceConfiguration(Consumer<GetTableMaintenanceConfigurationRequest.Builder> getTableMaintenanceConfigurationRequest) Gets details about the maintenance configuration of a table.getTableMaintenanceConfiguration(GetTableMaintenanceConfigurationRequest getTableMaintenanceConfigurationRequest) Gets details about the maintenance configuration of a table.getTableMaintenanceJobStatus(Consumer<GetTableMaintenanceJobStatusRequest.Builder> getTableMaintenanceJobStatusRequest) Gets the status of a maintenance job for a table.getTableMaintenanceJobStatus(GetTableMaintenanceJobStatusRequest getTableMaintenanceJobStatusRequest) Gets the status of a maintenance job for a table.default GetTableMetadataLocationResponsegetTableMetadataLocation(Consumer<GetTableMetadataLocationRequest.Builder> getTableMetadataLocationRequest) Gets the location of the table metadata.default GetTableMetadataLocationResponsegetTableMetadataLocation(GetTableMetadataLocationRequest getTableMetadataLocationRequest) Gets the location of the table metadata.default GetTablePolicyResponsegetTablePolicy(Consumer<GetTablePolicyRequest.Builder> getTablePolicyRequest) Gets details about a table policy.default GetTablePolicyResponsegetTablePolicy(GetTablePolicyRequest getTablePolicyRequest) Gets details about a table policy.default ListNamespacesResponselistNamespaces(Consumer<ListNamespacesRequest.Builder> listNamespacesRequest) Lists the namespaces within a table bucket.default ListNamespacesResponselistNamespaces(ListNamespacesRequest listNamespacesRequest) Lists the namespaces within a table bucket.default ListNamespacesIterablelistNamespacesPaginator(Consumer<ListNamespacesRequest.Builder> listNamespacesRequest) This is a variant oflistNamespaces(software.amazon.awssdk.services.s3tables.model.ListNamespacesRequest)operation.default ListNamespacesIterablelistNamespacesPaginator(ListNamespacesRequest listNamespacesRequest) This is a variant oflistNamespaces(software.amazon.awssdk.services.s3tables.model.ListNamespacesRequest)operation.default ListTableBucketsResponselistTableBuckets(Consumer<ListTableBucketsRequest.Builder> listTableBucketsRequest) Lists table buckets for your account.default ListTableBucketsResponselistTableBuckets(ListTableBucketsRequest listTableBucketsRequest) Lists table buckets for your account.default ListTableBucketsIterablelistTableBucketsPaginator(Consumer<ListTableBucketsRequest.Builder> listTableBucketsRequest) This is a variant oflistTableBuckets(software.amazon.awssdk.services.s3tables.model.ListTableBucketsRequest)operation.default ListTableBucketsIterablelistTableBucketsPaginator(ListTableBucketsRequest listTableBucketsRequest) This is a variant oflistTableBuckets(software.amazon.awssdk.services.s3tables.model.ListTableBucketsRequest)operation.default ListTablesResponselistTables(Consumer<ListTablesRequest.Builder> listTablesRequest) List tables in the given table bucket.default ListTablesResponselistTables(ListTablesRequest listTablesRequest) List tables in the given table bucket.default ListTablesIterablelistTablesPaginator(Consumer<ListTablesRequest.Builder> listTablesRequest) This is a variant oflistTables(software.amazon.awssdk.services.s3tables.model.ListTablesRequest)operation.default ListTablesIterablelistTablesPaginator(ListTablesRequest listTablesRequest) This is a variant oflistTables(software.amazon.awssdk.services.s3tables.model.ListTablesRequest)operation.default PutTableBucketEncryptionResponseputTableBucketEncryption(Consumer<PutTableBucketEncryptionRequest.Builder> putTableBucketEncryptionRequest) Sets the encryption configuration for a table bucket.default PutTableBucketEncryptionResponseputTableBucketEncryption(PutTableBucketEncryptionRequest putTableBucketEncryptionRequest) Sets the encryption configuration for a table bucket.putTableBucketMaintenanceConfiguration(Consumer<PutTableBucketMaintenanceConfigurationRequest.Builder> putTableBucketMaintenanceConfigurationRequest) Creates a new maintenance configuration or replaces an existing maintenance configuration for a table bucket.putTableBucketMaintenanceConfiguration(PutTableBucketMaintenanceConfigurationRequest putTableBucketMaintenanceConfigurationRequest) Creates a new maintenance configuration or replaces an existing maintenance configuration for a table bucket.default PutTableBucketPolicyResponseputTableBucketPolicy(Consumer<PutTableBucketPolicyRequest.Builder> putTableBucketPolicyRequest) Creates a new maintenance configuration or replaces an existing table bucket policy for a table bucket.default PutTableBucketPolicyResponseputTableBucketPolicy(PutTableBucketPolicyRequest putTableBucketPolicyRequest) Creates a new maintenance configuration or replaces an existing table bucket policy for a table bucket.putTableMaintenanceConfiguration(Consumer<PutTableMaintenanceConfigurationRequest.Builder> putTableMaintenanceConfigurationRequest) Creates a new maintenance configuration or replaces an existing maintenance configuration for a table.putTableMaintenanceConfiguration(PutTableMaintenanceConfigurationRequest putTableMaintenanceConfigurationRequest) Creates a new maintenance configuration or replaces an existing maintenance configuration for a table.default PutTablePolicyResponseputTablePolicy(Consumer<PutTablePolicyRequest.Builder> putTablePolicyRequest) Creates a new maintenance configuration or replaces an existing table policy for a table.default PutTablePolicyResponseputTablePolicy(PutTablePolicyRequest putTablePolicyRequest) Creates a new maintenance configuration or replaces an existing table policy for a table.default RenameTableResponserenameTable(Consumer<RenameTableRequest.Builder> renameTableRequest) Renames a table or a namespace.default RenameTableResponserenameTable(RenameTableRequest renameTableRequest) Renames a table or a namespace.The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationstatic ServiceMetadataupdateTableMetadataLocation(Consumer<UpdateTableMetadataLocationRequest.Builder> updateTableMetadataLocationRequest) Updates the metadata location for a table.updateTableMetadataLocation(UpdateTableMetadataLocationRequest updateTableMetadataLocationRequest) Updates the metadata location for a table.Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
closeMethods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
Field Details
-
SERVICE_NAME
- See Also:
-
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider.- See Also:
-
-
Method Details
-
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.
- See Also:
-
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.
- See Also:
-
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. -
If you use this operation with the optional
metadatarequest parameter you must have thes3tables:PutTableDatapermission. -
If you use this operation with the optional
encryptionConfigurationrequest parameter you must have thes3tables:PutTableEncryptionpermission.
Additionally, If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see Permissions requirements for S3 Tables SSE-KMS encryption.
-
- Parameters:
createTableRequest-- Returns:
- Result of the CreateTable operation returned by the service.
- See Also:
-
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. -
If you use this operation with the optional
metadatarequest parameter you must have thes3tables:PutTableDatapermission. -
If you use this operation with the optional
encryptionConfigurationrequest parameter you must have thes3tables:PutTableEncryptionpermission.
Additionally, If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see Permissions requirements for S3 Tables SSE-KMS encryption.
-
This is a convenience which creates an instance of the
CreateTableRequest.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.
- See Also:
-
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. -
If you use this operation with the optional
encryptionConfigurationparameter you must have thes3tables:PutTableBucketEncryptionpermission.
-
- Parameters:
createTableBucketRequest-- Returns:
- Result of the CreateTableBucket operation returned by the service.
- See Also:
-
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. -
If you use this operation with the optional
encryptionConfigurationparameter you must have thes3tables:PutTableBucketEncryptionpermission.
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
deleteTableBucketEncryption
default DeleteTableBucketEncryptionResponse deleteTableBucketEncryption(DeleteTableBucketEncryptionRequest deleteTableBucketEncryptionRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException Deletes the encryption configuration for a table bucket.
- Permissions
-
You must have the
s3tables:DeleteTableBucketEncryptionpermission to use this operation.
- Parameters:
deleteTableBucketEncryptionRequest-- Returns:
- Result of the DeleteTableBucketEncryption operation returned by the service.
- See Also:
-
deleteTableBucketEncryption
default DeleteTableBucketEncryptionResponse deleteTableBucketEncryption(Consumer<DeleteTableBucketEncryptionRequest.Builder> deleteTableBucketEncryptionRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException Deletes the encryption configuration for a table bucket.
- Permissions
-
You must have the
s3tables:DeleteTableBucketEncryptionpermission to use this operation.
This is a convenience which creates an instance of the
DeleteTableBucketEncryptionRequest.Builderavoiding the need to create one manually viaDeleteTableBucketEncryptionRequest.builder()- Parameters:
deleteTableBucketEncryptionRequest- AConsumerthat will call methods onDeleteTableBucketEncryptionRequest.Builderto create a request.- Returns:
- Result of the DeleteTableBucketEncryption operation returned by the service.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
getTableBucketEncryption
default GetTableBucketEncryptionResponse getTableBucketEncryption(GetTableBucketEncryptionRequest getTableBucketEncryptionRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, AccessDeniedException, TooManyRequestsException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException Gets the encryption configuration for a table bucket.
- Permissions
-
You must have the
s3tables:GetTableBucketEncryptionpermission to use this operation.
- Parameters:
getTableBucketEncryptionRequest-- Returns:
- Result of the GetTableBucketEncryption operation returned by the service.
- See Also:
-
getTableBucketEncryption
default GetTableBucketEncryptionResponse getTableBucketEncryption(Consumer<GetTableBucketEncryptionRequest.Builder> getTableBucketEncryptionRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, AccessDeniedException, TooManyRequestsException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException Gets the encryption configuration for a table bucket.
- Permissions
-
You must have the
s3tables:GetTableBucketEncryptionpermission to use this operation.
This is a convenience which creates an instance of the
GetTableBucketEncryptionRequest.Builderavoiding the need to create one manually viaGetTableBucketEncryptionRequest.builder()- Parameters:
getTableBucketEncryptionRequest- AConsumerthat will call methods onGetTableBucketEncryptionRequest.Builderto create a request.- Returns:
- Result of the GetTableBucketEncryption operation returned by the service.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
getTableEncryption
default GetTableEncryptionResponse getTableEncryption(GetTableEncryptionRequest getTableEncryptionRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, AccessDeniedException, TooManyRequestsException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException Gets the encryption configuration for a table.
- Permissions
-
You must have the
s3tables:GetTableEncryptionpermission to use this operation.
- Parameters:
getTableEncryptionRequest-- Returns:
- Result of the GetTableEncryption operation returned by the service.
- See Also:
-
getTableEncryption
default GetTableEncryptionResponse getTableEncryption(Consumer<GetTableEncryptionRequest.Builder> getTableEncryptionRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, AccessDeniedException, TooManyRequestsException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException Gets the encryption configuration for a table.
- Permissions
-
You must have the
s3tables:GetTableEncryptionpermission to use this operation.
This is a convenience which creates an instance of the
GetTableEncryptionRequest.Builderavoiding the need to create one manually viaGetTableEncryptionRequest.builder()- Parameters:
getTableEncryptionRequest- AConsumerthat will call methods onGetTableEncryptionRequest.Builderto create a request.- Returns:
- Result of the GetTableEncryption operation returned by the service.
- See Also:
-
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. -
You must have the
s3tables:GetTableDatapermission to use set the compaction strategy tosortorzorder.
-
- Parameters:
getTableMaintenanceConfigurationRequest-- Returns:
- Result of the GetTableMaintenanceConfiguration operation returned by the service.
- See Also:
-
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. -
You must have the
s3tables:GetTableDatapermission to use set the compaction strategy tosortorzorder.
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
putTableBucketEncryption
default PutTableBucketEncryptionResponse putTableBucketEncryption(PutTableBucketEncryptionRequest putTableBucketEncryptionRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException Sets the encryption configuration for a table bucket.
- Permissions
-
You must have the
s3tables:PutTableBucketEncryptionpermission to use this operation.If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see Permissions requirements for S3 Tables SSE-KMS encryption in the Amazon Simple Storage Service User Guide.
- Parameters:
putTableBucketEncryptionRequest-- Returns:
- Result of the PutTableBucketEncryption operation returned by the service.
- See Also:
-
putTableBucketEncryption
default PutTableBucketEncryptionResponse putTableBucketEncryption(Consumer<PutTableBucketEncryptionRequest.Builder> putTableBucketEncryptionRequest) throws InternalServerErrorException, ForbiddenException, NotFoundException, TooManyRequestsException, ConflictException, BadRequestException, AwsServiceException, SdkClientException, S3TablesException Sets the encryption configuration for a table bucket.
- Permissions
-
You must have the
s3tables:PutTableBucketEncryptionpermission to use this operation.If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see Permissions requirements for S3 Tables SSE-KMS encryption in the Amazon Simple Storage Service User Guide.
This is a convenience which creates an instance of the
PutTableBucketEncryptionRequest.Builderavoiding the need to create one manually viaPutTableBucketEncryptionRequest.builder()- Parameters:
putTableBucketEncryptionRequest- AConsumerthat will call methods onPutTableBucketEncryptionRequest.Builderto create a request.- Returns:
- Result of the PutTableBucketEncryption operation returned by the service.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
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.
- See Also:
-
create
Create aS3TablesClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider. -
builder
Create a builder that can be used to configure and create aS3TablesClient. -
serviceMetadata
-
serviceClientConfiguration
Description copied from interface:SdkClientThe SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfigurationin interfaceAwsClient- Specified by:
serviceClientConfigurationin interfaceSdkClient- Returns:
- SdkServiceClientConfiguration
-