CreateNamespace

調用CreateNamespace介面在指定的Table Bucket中建立一個Namespace，Namespace是Table Bucket中的邏輯分組，用於組織和管理表。

注意事項

Namespace名稱在同一個Table Bucket內必須唯一。
Namespace名稱長度為1~255個字元，只允許小寫字母、數字和底線（_），不能以底線開頭或結尾，不能以oss、acs、aliyun、alibaba、aws為首碼。
建立Namespace前，需要確保目標Table Bucket已存在。

許可權說明

API	Action	說明
CreateNamespace	oss:CreateNamespace	建立Namespace

請求文法

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	字串	是	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	Table Bucket的ARN，格式為acs:osstables:{region}:{accountId}:bucket/{bucketName}。
namespace	數組	是	["my_namespace"]	Namespace名稱列表，目前僅支援單個元素。長度為1~255個字元，只允許小寫字母、數字和底線（_），不能以底線開頭或結尾，不能以oss、acs、aliyun、alibaba、aws為首碼。

響應參數

名稱	資料類型	樣本值	描述
namespace	數組	["my_namespace"]	建立的Namespace名稱列表。
tableBucketARN	字串	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	所屬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

CreateNamespace介面所對應的ossutil命令，請參見create-namespace。

錯誤碼

錯誤碼	HTTP狀態代碼	描述
BadRequestException	400	請求無效或格式錯誤。
ForbiddenException	403	調用者無權執行此請求。
NotFoundException	404	請求的資源不存在。
ConflictException	409	請求與之前的寫入操作存在衝突。