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.
Request Syntax
GET /tables/tableBucketARN/namespace/name HTTP/1.1
URI Request Parameters
The request uses the following URI parameters.
- name
-
The name of the table.
Length Constraints: Minimum length of 1. Maximum length of 255.
Pattern:
[0-9a-z_]*Required: Yes
- namespace
-
The name of the namespace the table is associated with.
Length Constraints: Minimum length of 1. Maximum length of 255.
Pattern:
[0-9a-z_]*Required: Yes
- tableBucketARN
-
The Amazon Resource Name (ARN) of the table bucket associated with the table.
Pattern:
(arn:aws[-a-z0-9]*:[a-z0-9]+:[-a-z0-9]*:[0-9]{12}:bucket/[a-z0-9_-]{3,63})Required: Yes
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"createdAt": "string",
"createdBy": "string",
"format": "string",
"managedByService": "string",
"metadataLocation": "string",
"modifiedAt": "string",
"modifiedBy": "string",
"name": "string",
"namespace": [ "string" ],
"namespaceId": "string",
"ownerAccountId": "string",
"tableARN": "string",
"tableBucketId": "string",
"type": "string",
"versionToken": "string",
"warehouseLocation": "string"
}Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- createdAt
-
The date and time the table bucket was created at.
Type: Timestamp
- createdBy
-
The ID of the account that created the table.
Type: String
Length Constraints: Fixed length of 12.
Pattern:
[0-9].* - format
-
The format of the table.
Type: String
Valid Values:
ICEBERG - managedByService
-
The service that manages the table.
Type: String
- metadataLocation
-
The metadata location of the table.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 2048.
- modifiedAt
-
The date and time the table was last modified on.
Type: Timestamp
- modifiedBy
-
The ID of the account that last modified the table.
Type: String
Length Constraints: Fixed length of 12.
Pattern:
[0-9].* - name
-
The name of the table.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 255.
Pattern:
[0-9a-z_]* - namespace
-
The namespace associated with the table.
Type: Array of strings
Length Constraints: Minimum length of 1. Maximum length of 255.
Pattern:
[0-9a-z_]* - namespaceId
-
The unique identifier of the namespace containing this table.
Type: String
- ownerAccountId
-
The ID of the account that owns the table.
Type: String
Length Constraints: Fixed length of 12.
Pattern:
[0-9].* - tableARN
-
The Amazon Resource Name (ARN) of the table.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 2048.
Pattern:
(arn:aws[-a-z0-9]*:[a-z0-9]+:[-a-z0-9]*:[0-9]{12}:bucket/[a-z0-9_-]{3,63}/table/[a-zA-Z0-9-_]{1,255}) - tableBucketId
-
The unique identifier of the table bucket containing this table.
Type: String
- type
-
The type of the table.
Type: String
Valid Values:
customer | aws - versionToken
-
The version token of the table.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 2048.
- warehouseLocation
-
The warehouse location of the table.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 2048.
Errors
- AccessDeniedException
-
The action cannot be performed because you do not have the required permission.
HTTP Status Code: 403
- BadRequestException
-
The request is invalid or malformed.
HTTP Status Code: 400
- ConflictException
-
The request failed because there is a conflict with a previous write. You can retry the request.
HTTP Status Code: 409
- ForbiddenException
-
The caller isn't authorized to make the request.
HTTP Status Code: 403
- InternalServerErrorException
-
The request failed due to an internal server error.
HTTP Status Code: 500
- NotFoundException
-
The request was rejected because the specified resource could not be found.
HTTP Status Code: 404
- TooManyRequestsException
-
The limit on the number of requests per second was exceeded.
HTTP Status Code: 429
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
