
# 查询接入点列表
#### 功能介绍
查询当前用户可用的接入点列表，包括专享版设备管理实例。
#### URI
GET /v5/iotps/{project_id}/access-points
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                           |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID。 最小长度：**1** 最大长度：**32** |
表2Query参数 
| 参数                    | 是否必选 | 参数类型   | 描述                                     |
|:---|:---|:---|:---|
| authorizing_domain_id | 否    | String | 授权租户的账户ID 最小长度：**1** 最大长度：**128**      |
| region_id             | 否    | String | 区域ID，用于区分不同的区域。 最小长度：**1** 最大长度：**64** |
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                  |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：**0** 最大长度：**65535** |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数            | 参数类型                                                                                        | 描述                      |
|:---|:---|:---|
| access_points | Array of [AccessPointItem] objects | 接入点列表。 数组长度：**0 - 100** |
   
 表5AccessPointItem 
| 参数                | 参数类型   | 描述                                                                             |
|:---|:---|:---|
| access_point_id   | String | 接入点id。 最小长度：**1** 最大长度：**256**                                                 |
| access_point_name | String | 接入点名称。 最小长度：**1** 最大长度：**256**                                                 |
| region_id         | String | 华为云区域ID。节选自https://developer.huaweicloud.com/endpoint。 最小长度：**1** 最大长度：**128** |
| region_name       | String | 华为云区域名称。节选自https://developer.huaweicloud.com/endpoint。 最小长度：**1** 最大长度：**128** |
| edition           | String | 实例版本。Basic：基础版；Enterprise：企业版；Standard：基础版。 最小长度：**1** 最大长度：**256**            |
   
#### 请求示例
查询接入点列表
```
GET https://{endpoint}/v5/iotps/{project_id}/access-points
```
#### 响应示例
**状态码： 200**
OK
```
{
  "access_points" : [ {
    "access_point_id" : "DMP-CNNorth-1-1",
    "access_point_name" : "设备管理-北京一-1",
    "region_id" : "cn-north-1",
    "region_name" : "华北-北京一",
    "edition" : "Basic"
  }, {
    "access_point_id" : "DMP-CNNorth-4-1",
    "access_point_name" : "设备管理-北京四-1",
    "region_id" : "cn-north-4",
    "region_name" : "华北-北京四",
    "edition" : "Standard"
  }, {
    "access_point_id" : "DMP-CNNorth-4-1",
    "access_point_name" : "设备管理-北京四-1",
    "region_id" : "cn-north-4",
    "region_name" : "华北-北京四",
    "edition" : "Enterprise"
  } ]
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-iotps/ErrorCode.html)。
