文档首页/ 数据安全中心 DSC/ API参考/ API/ 设备管理/ 获取设备状态列表 - ListMonitorInfo
更新时间：2026-07-15 GMT+08:00
在线调试
CLI示例
查看PDF
分享

获取设备状态列表 - ListMonitorInfo

功能介绍

查询项目中所有设备的监控状态信息

调用方法

请参见如何调用API。

授权信息

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

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

GET /v1/{project_id}/devices/monitor-info

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

请求参数

无

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

monitor_infos

Array of MonitorInfo objects

设备状态信息列表

total

Integer

信息总数
表3 MonitorInfo

参数

参数类型

描述

description

String

描述

id

String

ID

ip

String

设备IP地址

license_info

LicenseInfo object

许可证信息

name

String

名称

os_info

OsInfo object

虚拟机资源占用信息

status

String

状态

type

Integer

类型
表4 LicenseInfo

参数

参数类型

描述

license

String

许可证信息

license_end

Long

许可证到期时间

license_start

Long

许可证生效时间
表5 OsInfo

参数

参数类型

描述

cpu

String

cpu核心数

disk

String

磁盘大小

mem

String

内存大小

请求示例

无

响应示例

无

状态码

状态码

描述

200

查询结果

401

未授权，用户未登录或令牌无效

403

无权限访问该资源

404

指定的项目不存在

错误码

请参见错误码。

父主题： 设备管理