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

查询nacos命名空间 - QueryNacosNamespace

功能介绍

查询nacos命名空间。

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    cse:namespace:get

    read

    engine

    -

    -

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

父主题： Nacos API

相关文档