CreateNamespace - 对象存储 OSS

调用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	请求与之前的写入操作存在冲突。