ListNamespaces - 对象存储 OSS

调用ListNamespaces接口列举指定Table Bucket下的所有Namespace。

注意事项

支持通过prefix参数按名称前缀过滤Namespace。
支持通过maxNamespaces参数控制单次返回的最大数量，默认值为1000。
当返回结果中包含continuationToken时，说明还有更多数据，可使用该token进行分页查询。

权限说明

API	Action	说明
ListNamespaces	oss:ListNamespaces	列出Namespace

请求语法

GET /namespaces/{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}。
continuationToken	字符串	否	xxx	分页token。当上一次请求返回的结果被截断时，可使用此token继续获取后续数据。
maxNamespaces	整数	否	10	最大返回数量，取值范围1~1000，默认1000。位于Query参数中。
prefix	字符串	否	my_	名称前缀过滤。位于Query参数中。

响应参数

名称	数据类型	示例值	描述
namespaces	数组	-	Namespace列表。每个元素包含namespace（名称数组）、namespaceId（Namespace ID）、tableBucketId（所属Table Bucket ID）、ownerAccountId（拥有者账号ID）、createdAt（创建时间）、createdBy（创建者）。
continuationToken	字符串	xxx	分页token。当还有更多数据时返回此字段，用于获取下一页结果。

示例

请求示例

GET /namespaces/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket?maxNamespaces=10 HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: Thu, 10 Apr 2025 08:00:00 GMT
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",
   "namespaces": [
      {
         "namespace": ["my_namespace"],
         "namespaceId": "ns-xxxxxxxx",
         "tableBucketId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
         "ownerAccountId": "1234567890",
         "createdAt": "2024-01-01T00:00:00.000000Z",
         "createdBy": "1234567890"
      }
   ]
}

SDK

ListNamespaces接口所对应的各语言SDK如下：

命令行工具ossutil

ListNamespaces接口所对应的ossutil命令，请参见list-namespaces。

错误码

错误码	HTTP状态码	描述
BadRequestException	400	请求无效或格式错误。
ForbiddenException	403	调用者无权执行此请求。
NotFoundException	404	请求的资源不存在。