v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1449192184.5 KB

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

Permissions

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

put/tables/{tableBucketARN}/{namespace}/{name}/metadata-location

Path parameters

tableBucketARNstring required

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

namespacestring required

The namespace of the table.

namestring required

The name of the table.

Request body

versionTokenstring required

The version token of the table.

metadataLocationstring required

The new metadata location for the table.

Response

Success

namestring required

The name of the table.

tableARNstring required

The Amazon Resource Name (ARN) of the table.

namespaceNamespaceName[] required

The namespace the table is associated with.

versionTokenstring required

The version token of the table.

metadataLocationstring required

The metadata location of the table.