
# 获取设备列表 - ListDevicesInfo
#### 功能介绍
查询项目中所有设备的信息列表
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-dsc/dsc_02_0008.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dsc/dsc_02_0031.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
GET /v1/{project_id}/devices
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述   |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID |
   
表2Query参数 
| 参数     | 是否必选 | 参数类型    | 描述     |
|:---|:---|:---|:---|
| limit  | 否    | Integer | 每页显示数量 |
| offset | 否    | Integer | 分页偏移量  |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数      | 参数类型                                                         | 描述     |
|:---|:---|:---|
| devices | Array of [Device] objects | 设备信息列表 |
| total   | Integer                                                      | 设备总数   |
   
 表4Device 
| 参数                             | 参数类型                                                                                       | 描述                                                                 |
|:---|:---|:---|
| create_time                    | Long                                                                                       | 创建时间                                                               |
| description                    | String                                                                                     | 描述信息                                                               |
| id                             | String                                                                                     | 设备ID                                                               |
| ip                             | String                                                                                     | 设备IP地址                                                             |
| manage_url                     | String                                                                                     | 管理地址                                                               |
| mode                           | String                                                                                     | 部署模式                                                               |
| name                           | String                                                                                     | 设备名称                                                               |
| related_datasource_policy_list | Array of [RelatedDatasourceInfo] objects | 关联的策略信息                                                            |
| status                         | String                                                                                     | 状态                                                                 |
| subnet_id                      | String                                                                                     | 子网ID                                                               |
| type                           | Integer                                                                                    | 设备类型，0（应用数据审计）、1（应用数据安全网关）、2（数据库防火墙）、3（数据库加密）、4（静态脱敏实例）、5(数据库动脱实例) |
| update_time                    | Long                                                                                       | 更新时间                                                               |
| version                        | String                                                                                     | 版本                                                                 |
| vpc_id                         | String                                                                                     | 虚拟私有云ID                                                            |
   
 表5RelatedDatasourceInfo 
| 参数                 | 参数类型                                                               | 描述            |
|:---|:---|:---|
| datasource_address | String                                                             | 数据源地址         |
| datasource_id      | String                                                             | 数据源资产ID       |
| datasource_port    | Integer                                                            | 数据源端口         |
| ddm_policies       | Array of [DdmPolicy] objects | 关联的动态脱敏策略信息列表 |
| gde_policies       | Array of [GdePolicy] objects | 关联的加密策略信息列表   |
| proxy_port         | Integer                                                            | 代理端口          |
| sdm_policies       | Array of [SdmPolicy] objects | array         |
   
 表6DdmPolicy 
| 参数        | 参数类型                                                         | 描述         |
|:---|:---|:---|
| columns   | Array of [Column] objects | 策略配置的列信息列表 |
| namespace | String                                                       | 命名空间名称     |
| table     | String                                                       | 表名称        |
   
 表7GdePolicy 
| 参数      | 参数类型                                                         | 描述                       |
|:---|:---|:---|
| action  | Integer                                                      | 1加密，2解密                  |
| alg     | String                                                       | 加密算法，sm4、aes-128、aes-256 |
| columns | Array of [Column] objects | 需加密的列信息                  |
| table   | String                                                       | 表名称                      |
   
 表8SdmPolicy 
| 参数        | 参数类型                                                         | 描述           |
|:---|:---|:---|
| columns   | Array of [Column] objects | 列信息          |
| do_mask   | Boolean                                                      | 是否脱敏         |
| do_move   | Boolean                                                      | 是否迁移         |
| namespace | String                                                       | 命名空间，HBase特有 |
| table     | String                                                       | 表名称          |
   
 表9Column 
| 参数   | 参数类型    | 描述        |
|:---|:---|:---|
| mask | Integer | 脱敏算法名称或ID |
| name | String  | 列名称       |
   
#### 请求示例
无
#### 响应示例
无
#### 状态码
| 状态码 | 描述             |
|:---|:---|
| 200 | 查询结果           |
| 401 | 未授权，用户未登录或令牌无效 |
| 403 | 无权限访问该资源       |
| 404 | 指定的项目不存在       |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-dsc/ErrorCode.html)。
