更新时间：2025-12-31 GMT+08:00
查询nacos命名空间 - QueryNacosNamespace
功能介绍
查询nacos命名空间。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
cse:namespace:get
read
engine
-
-
URI
GET /v1/{project_id}/nacos/v1/console/namespaces
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 租户子项目的唯一标识。字符长度为1~64。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
offset | 是 | Integer | 分页的页码，从0开始。 |
limit | 是 | Integer | 分页参数，分页大小，0表示不分页。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | IAM-Token。 |
x-engine-id | 是 | String | 微服务引擎专享版的实例ID。 |
X-Enterprise-Project-ID | 是 | String | 企业项目ID。 |
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
code | Integer | 响应码。 |
data | Array of 表5 | 命名空间信息列表。 |
参数 | 参数类型 | 描述 |
|---|---|---|
namespace | String | 命名空间名称。 |
namespaceShowName | String | 命名空间展示名称。 |
quota | number | 命名空间配额。 |
configCount | number | 命名空间下配置的数量。 |
type | number | 命名空间类型。
|
状态码： 400
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码。 |
error_msg | String | 错误信息。 |
detail | String | 详细定位信息。 |
请求示例
GET https://{endpoint}/v1/{project_id}/nacos/v1/console/namespaces 响应示例
{
"code": 200,
"message": null,
"data": [
{
"namespace": "",
"namespaceShowName": "public",
"quota": 200,
"configCount": 0,
"type": 0
}
]
} 状态码
状态码 | 描述 |
|---|---|
200 | 查询nacos命名空间响应结构体。 |
400 | 错误的请求。 |
错误码
请参见CSE错误码。
父主题：Nacos API
