GetTableBucket

Usage notes

The caller must have read permissions on the Table Bucket.
The response includes the Table Bucket ARN, name, creation time, owner's Alibaba Cloud account ID, and Table Bucket ID.

Permissions

API	Actions	Description
GetTableBucket	oss:GetTableBucket	Retrieves Table Bucket information.

Request syntax

GET /buckets/{tableBucketARN} HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Request parameters

Parameter	Type	Required	Example	Description
tableBucketARN	String	Yes	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	The Table Bucket ARN. Format: acs:osstables:{region}:{accountId}:bucket/{bucketName}.

Response parameters

Parameter	Type	Example	Description
arn	String	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	The ARN of the Table Bucket.
createdAt	String	2024-01-01T00:00:00.000000Z	The creation time in ISO 8601 format.
name	String	my-table-bucket	The name of the Table Bucket.
ownerAccountId	String	1234567890	The owner's Alibaba Cloud account ID.
tableBucketId	String	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx	The Table Bucket ID in UUID format.
type	String	customer	The type of the Table Bucket.

Examples

Request example

GET /buckets/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/osstables/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c****

Response example

HTTP/1.1 200 OK
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422****
x-oss-server-time: 3
Content-Type: application/json

{
   "arn": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket",
   "createdAt": "2024-01-01T00:00:00.000000Z",
   "name": "my-table-bucket",
   "ownerAccountId": "1234567890",
   "tableBucketId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
   "type": "customer"
}

SDKs

Supported SDKs:

ossutil

The corresponding ossutil command is get-table-bucket.

Error codes

Error code	HTTP status code	Description
NotFoundException	404	The requested resource does not exist.
ForbiddenException	403	You are not authorized to perform this request.