调用ListTableBuckets接口列出当前阿里云账号在指定地域下的所有Table Bucket。
注意事项
-
支持通过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 |
调用者无权执行此请求。 |