更新时间：2025-12-31 GMT+08:00
创建nacos命名空间 - CreateNacosNamespace
功能介绍
创建nacos命名空间。
授权信息
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
cse:namespace:create
write
engine
-
-
URI
POST /v1/{project_id}/nacos/v1/console/namespaces
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 租户子项目的唯一标识。字符长度为1~64。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
custom_namespace_id | 是 | String | 命名空间ID，仅支持大小写字母、数字、短划线（-）和下划线（_），不超过128个字符。 |
namespace_name | 是 | String | 命名空间名，支持非@、#、$、%、^、&、*，不超过128个字符。 |
namespace_desc | 否 | String | 命名空间描述，不超过256个字符。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | IAM-Token。 |
x-engine-id | 是 | String | 微服务引擎专享版的实例ID。 |
X-Enterprise-Project-ID | 是 | String | 企业项目ID。 |
响应参数
状态码：200
状态码： 400
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码。 |
error_msg | String | 错误信息。 |
detail | String | 详细定位信息。 |
请求示例
请求表单数据示例：
POST https://{endpoint}/v1/{project_id}/nacos/v1/console/namespaces
customNamespaceId=namespace_id&namespaceName=namespace_name&namespaceDesc=&namespaceId= 响应示例
true
状态码
状态码 | 描述 |
|---|---|
200 | 创建nacos命名空间响应结构体。 |
400 | 错误的请求。 |
错误码
请参见CSE错误码。
父主题：Nacos API
