Amazon S3 Tables

2025/07/15 - Amazon S3 Tables - 2 updated api methods

Changes  Adds table bucket type to ListTableBucket and GetTableBucket API operations

GetTableBucket (updated) Link ¶
Changes (response)
{'type': 'customer | aws'}

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

Permissions

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

See also: AWS API Documentation

Request Syntax

client.get_table_bucket(
    tableBucketARN='string'
)
type tableBucketARN:

string

param tableBucketARN:

[REQUIRED]

The Amazon Resource Name (ARN) of the table bucket.

rtype:

dict

returns:

Response Syntax

{
    'arn': 'string',
    'name': 'string',
    'ownerAccountId': 'string',
    'createdAt': datetime(2015, 1, 1),
    'tableBucketId': 'string',
    'type': 'customer'|'aws'
}

Response Structure

  • (dict) --

    • arn (string) --

      The Amazon Resource Name (ARN) of the table bucket.

    • name (string) --

      The name of the table bucket

    • ownerAccountId (string) --

      The ID of the account that owns the table bucket.

    • createdAt (datetime) --

      The date and time the table bucket was created.

    • tableBucketId (string) --

      The unique identifier of the table bucket.

    • type (string) --

      The type of the table bucket.

ListTableBuckets (updated) Link ¶
Changes (request, response)
Request
{'type': 'customer | aws'}
Response
{'tableBuckets': {'type': 'customer | aws'}}

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

Permissions

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

See also: AWS API Documentation

Request Syntax

client.list_table_buckets(
    prefix='string',
    continuationToken='string',
    maxBuckets=123,
    type='customer'|'aws'
)
type prefix:

string

param prefix:

The prefix of the table buckets.

type continuationToken:

string

param continuationToken:

ContinuationToken indicates to Amazon S3 that the list is being continued on this bucket with a token. ContinuationToken is obfuscated and is not a real key. You can use this ContinuationToken for pagination of the list results.

type maxBuckets:

integer

param maxBuckets:

The maximum number of table buckets to return in the list.

type type:

string

param type:

The type of table buckets to filter by in the list.

rtype:

dict

returns:

Response Syntax

{
    'tableBuckets': [
        {
            'arn': 'string',
            'name': 'string',
            'ownerAccountId': 'string',
            'createdAt': datetime(2015, 1, 1),
            'tableBucketId': 'string',
            'type': 'customer'|'aws'
        },
    ],
    'continuationToken': 'string'
}

Response Structure

  • (dict) --

    • tableBuckets (list) --

      A list of table buckets.

      • (dict) --

        Contains details about a table bucket.

        • arn (string) --

          The Amazon Resource Name (ARN) of the table bucket.

        • name (string) --

          The name of the table bucket.

        • ownerAccountId (string) --

          The ID of the account that owns the table bucket.

        • createdAt (datetime) --

          The date and time the table bucket was created at.

        • tableBucketId (string) --

          The system-assigned unique identifier for the table bucket.

        • type (string) --

          The type of the table bucket.

    • continuationToken (string) --

      You can use this ContinuationToken for pagination of the list results.