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

Object Storage Service:名前空間の作成

最終更新日:May 09, 2026

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

指定された名前空間はすでに存在します。