指定されたテーブルバケット内のすべての名前空間をリスト表示します。
注意事項
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)。フォーマットは |
continuationToken | String | いいえ | xxx | 以前のリクエストが切り捨てられた結果を返した場合、このトークンを使用して次のページの結果を取得します。 |
maxNamespaces | Integer | いいえ | 10 | 返される名前空間の最大数。有効な値:1 ~ 1000。デフォルト値:1000。これはクエリパラメーターです。 |
prefix | String | いいえ | my_ | 返される名前空間の名前が開始する必要があるプレフィックス。これはクエリパラメーターです。 |
レスポンスパラメーター
パラメーター | タイプ | 例 | 説明 |
namespaces | 配列 | - | 名前空間オブジェクトのリスト。各オブジェクトには以下の詳細が含まれます: |
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 | 要求されたリソースが存在しません。 |