ListNamespaces

調用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	請求的資源不存在。