Object Storage Service:ListTableBuckets

注意事項

• prefix パラメーターを使用して、名前のプレフィックスでテーブルバケットをフィルターできます。

• maxBuckets パラメーターを使用して、1 回の応答で返されるテーブルバケットの最大数を指定できます。デフォルト値は 1,000 です。

• 応答に continuationToken が含まれている場合、結果は切り捨てられています。次のページの結果を取得するには、このトークンを次のリクエストに含めてください。

権限

リクエスト構文

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

リクエストパラメーター

レスポンスパラメーター

使用例

リクエスト例

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"
      }
   ]
}

SDKs

以下の SDK を使用して ListTableBuckets 操作を呼び出すことができます。

• Python V2

• Go V2

• Java V2

ossutil コマンドラインツール

この操作に対応する ossutil コマンドの詳細については、「list-table-buckets」をご参照ください。

エラーコード