GetTableBucket

調用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	調用者無權執行此請求。