ListTableBuckets -

注意事項

支援通過prefix參數按名稱首碼過濾Table Bucket。
支援通過maxBuckets參數控制單次返回的最大數量，預設值為1000。
當返回結果中包含continuationToken時，說明還有更多資料，可使用該token進行分頁查詢。

許可權說明

API	Action	說明
ListTableBuckets	oss:ListTableBuckets	列出Table Bucket

請求文法

GET /buckets?continuationToken={continuationToken}&maxBuckets={maxBuckets}&prefix={prefix} HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

請求參數

名稱	資料類型	是否必選	樣本值	描述
maxBuckets	整數	否	10	最大返回數量，取值範圍1~1000，預設1000。
prefix	字串	否	my-	名稱首碼過濾。
continuationToken	字串	否	-	分頁標記，從上一次返回結果中擷取。

響應參數

名稱	資料類型	樣本值	描述
tableBuckets	數組	-	Table Bucket列表，每個元素包含arn、createdAt、name、ownerAccountId、tableBucketId、type。
continuationToken	字串	-	分頁標記，當存在更多結果時返回。

樣本

請求樣本

GET /buckets?maxBuckets=10 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


{
   "continuationToken": "xxxxx",
   "tableBuckets": [
      {
         "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

ListTableBuckets介面所對應的各語言SDK如下：

命令列工具ossutil

ListTableBuckets介面所對應的ossutil命令，請參見list-table-buckets。

錯誤碼

錯誤碼	HTTP狀態代碼	描述
BadRequestException	400	請求無效或格式錯誤。
ForbiddenException	403	調用者無權執行此請求。