文档首页/ 微服务引擎 CSE/ API参考/ Nacos API/ 查询nacos命名空间
更新时间:2025-07-25 GMT+08:00

查询nacos命名空间

功能介绍

查询nacos命名空间。

URI

GET /v1/{project_id}/nacos/v1/console/namespaces

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户子项目的唯一标识。字符长度为1~64。

表2 Query参数

参数

是否必选

参数类型

描述

offset

Integer

分页的页码,从0开始。

limit

Integer

分页参数,分页大小,0表示不分页。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

IAM-Token。

x-engine-id

String

微服务引擎专享版的实例ID。

X-Enterprise-Project-ID

String

企业项目ID。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

namespace

String

命名空间名称。

namespaceShowName

String

命名空间展示名称。

quota

number

命名空间配额。

configCount

number

命名空间下配置的数量。

type

number

命名空间类型。

状态码: 400

表5 响应Body参数

参数

参数类型

描述

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错误码