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

查询nacos命名空间

功能介绍

查询nacos命名空间。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

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参数

参数

参数类型

描述

code

Integer

响应码。

data

Array of 表5

命名空间信息列表。

表5 ListData

参数

参数类型

描述

namespace

String

命名空间名称。

namespaceShowName

String

命名空间展示名称。

quota

number

命名空间配额。

configCount

number

命名空间下配置的数量。

type

number

命名空间类型。

  • 0:保留空间。
  • 1:用户创建空间。

状态码: 400

表6 响应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错误码

相关文档