すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:名前空間のリスト表示

最終更新日:May 09, 2026

指定されたテーブルバケット内のすべての名前空間をリスト表示します。

注意事項

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

  • maxNamespaces パラメーターを使用して、1 回の応答で返される名前空間の最大数を設定できます。デフォルト値は 1000 です。

  • 応答に continuationToken が含まれている場合、さらに結果が利用可能であることを示します。このトークンを使用して、次のページの結果を取得してください。

権限

API

アクション

説明

ListNamespaces

oss:ListNamespaces

名前空間をリスト表示します。

リクエスト構文

GET /namespaces/{tableBucketARN} HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

リクエストパラメーター

パラメーター

タイプ

必須

説明

tableBucketARN

String

はい

acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket

テーブルバケットの Alibaba Cloud リソースネーム (ARN)。フォーマットは acs:osstables:{region}:{accountId}:bucket/{bucketName} です。

continuationToken

String

いいえ

xxx

以前のリクエストが切り捨てられた結果を返した場合、このトークンを使用して次のページの結果を取得します。

maxNamespaces

Integer

いいえ

10

返される名前空間の最大数。有効な値:1 ~ 1000。デフォルト値:1000。これはクエリパラメーターです。

prefix

String

いいえ

my_

返される名前空間の名前が開始する必要があるプレフィックス。これはクエリパラメーターです。

レスポンスパラメーター

パラメーター

タイプ

説明

namespaces

配列

-

名前空間オブジェクトのリスト。各オブジェクトには以下の詳細が含まれます:namespace(名前空間名。配列で返されます)、namespaceId(名前空間の ID)、tableBucketId(親テーブルバケットの ID)、ownerAccountId(所有者アカウントの ID)、createdAt(作成タイムスタンプ)、および createdBy(作成者のアカウント ID)。

continuationToken

String

xxx

このフィールドは、結果が切り捨てられている場合にのみ返されます。後続のリクエストでこのトークンを使用して、次のページの結果を取得してください。

使用例

リクエスト例

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

SDKs

ListNamespaces 操作は、以下の SDK で利用できます。

ossutil CLI

同等の ossutil コマンドは list-namespaces です。

エラーコード

エラーコード

HTTP ステータスコード

説明

BadRequestException

400

リクエストが無効または不正な形式です。

ForbiddenException

403

呼び出し元にこのリクエストを実行する権限がありません。

NotFoundException

404

要求されたリソースが存在しません。