更新时间：2025-11-21 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
