# 查询nacos命名空间 - QueryNacosNamespace
#### 功能介绍
查询nacos命名空间。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CSE/doc?api=ListNacosNamespaces)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cse/cse_06_0081.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项               | 访问级别 | 资源类型（\*为必须） | 条件键                                                                                                                                                                                                                                                                                                                                                                                     | 别名 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | cse:namespace:get | read | engine      | - [g:ResourceTag/\<tag-key\>](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html)  - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html)   | -  | -      |
     
  
 
#### URI
GET /v1/{project_id}/nacos/v1/console/namespaces
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                     |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户子项目的唯一标识。字符长度为1\~64。 |
   
表2Query参数 
| 参数     | 是否必选 | 参数类型    | 描述                |
|:---|:---|:---|:---|
| 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] | 命名空间信息列表。 |
   
 表5ListData 
| 参数                | 参数类型   | 描述                                                                                                                                                                                                                   |
|:---|:---|:---|
| 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错误码](https://support.huaweicloud.com/api-cse/cse_06_0109.html)。