CreateNamespace 操作を使用して、指定されたテーブルバケット内に名前空間を作成します。名前空間は、テーブルバケット内でテーブルを整理・管理するための論理的なグループです。
注意事項
-
名前空間名は、テーブルバケット内で一意である必要があります。
-
名前空間名は 1~255 文字で、小文字、数字、アンダースコア (_) のみを使用できます。名前の先頭または末尾をアンダースコアにすることはできず、oss、acs、aliyun、alibaba、aws のいずれかで始まることもできません。
-
名前空間を作成する前に、送信先のテーブルバケットが存在することを確認してください。
権限
|
API |
Action |
説明 |
|
CreateNamespace |
oss:CreateNamespace |
名前空間を作成します。 |
リクエスト構文
PUT /namespaces/{tableBucketARN} HTTP/1.1
Content-type: application/json
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
{
"namespace": ["string"]
}
リクエストパラメーター
|
パラメーター |
タイプ |
必須 |
例 |
説明 |
|
tableBucketARN |
string |
はい |
acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket |
テーブルバケットの ARN です。フォーマットは acs:osstables:{region}:{accountId}:bucket/{bucketName} です。 |
|
namespace |
array |
はい |
["my_namespace"] |
名前空間名の配列です。現在、1 回のリクエストにつき 1 つの名前空間のみ指定できます。名前は 1~255 文字で、小文字、数字、アンダースコア (_) のみを使用できます。名前の先頭または末尾をアンダースコアにすることはできず、oss、acs、aliyun、alibaba、aws のいずれかで始まることもできません。 |
レスポンスパラメーター
|
パラメーター |
タイプ |
例 |
説明 |
|
namespace |
array |
["my_namespace"] |
作成された名前空間名の配列です。 |
|
tableBucketARN |
string |
acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket |
名前空間を所有するテーブルバケットの ARN です。 |
使用例
リクエスト例
PUT /namespaces/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket HTTP/1.1
Content-type: application/json
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****
{
"namespace": ["my_namespace"]
}
レスポンス例
HTTP/1.1 200 OK
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422****
x-oss-server-time: 3
Content-Type: application/json
{
"namespace": ["my_namespace"],
"tableBucketARN": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket"
}
SDK
CreateNamespace 操作は、以下の SDK で利用できます。
ossutil CLI
同等の ossutil コマンドについては、「create-namespace」をご参照ください。
エラーコード
|
エラーコード |
HTTP ステータスコード |
説明 |
|
BadRequestException |
400 |
リクエストが無効または不正な形式です。 |
|
ForbiddenException |
403 |
呼び出し元にこのリクエストを実行する権限がありません。 |
|
NotFoundException |
404 |
要求されたリソースが存在しません。 |
|
ConflictException |
409 |
指定された名前空間はすでに存在します。 |