调用GetTableBucket接口获取指定Table Bucket的详细信息，包括名称、ARN、创建时间、拥有者等。
注意事项
调用者需要拥有该Table Bucket的读取权限。
返回的信息包括Table Bucket的基本属性，如ARN、名称、创建时间、拥有者账号ID和Bucket ID。
权限说明
API | Action | 说明 |
GetTableBucket | oss:GetTableBucket | 获取Table Bucket信息 |
请求语法
GET /buckets/{tableBucketARN} HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue请求参数
名称 | 数据类型 | 是否必选 | 示例值 | 描述 |
tableBucketARN | 字符串 | 是 | acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket | Table Bucket的ARN，格式为acs:osstables:{region}:{accountId}:bucket/{bucketName}。 |
响应参数
名称 | 数据类型 | 示例值 | 描述 |
arn | 字符串 | acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket | Table Bucket的ARN。 |
createdAt | 字符串 | 2024-01-01T00:00:00.000000Z | 创建时间，ISO 8601格式。 |
name | 字符串 | my-table-bucket | Table Bucket名称。 |
ownerAccountId | 字符串 | 1234567890 | 拥有者的阿里云账号ID。 |
tableBucketId | 字符串 | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx | Table Bucket的唯一标识，UUID格式。 |
type | 字符串 | customer | Bucket类型。 |
示例
请求示例
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****返回示例
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"
}SDK
GetTableBucket接口所对应的各语言SDK如下：
命令行工具ossutil
GetTableBucket接口所对应的ossutil命令，请参见get-table-bucket。
错误码
错误码 | HTTP状态码 | 描述 |
NotFoundException | 404 | 请求的资源不存在。 |
ForbiddenException | 403 | 调用者无权执行此请求。 |