查询单个服务器的状态详情

功能说明

查询单个服务器的状态详情。

默认接口请求频率限制：20次/秒

实现方法

REST URL

GET /api/rest/external/v1/ops/server/status/query?enterpriseId=xxx&uniqueId=xxx&startTime=xxxx&endTime=xxxx

请求参数说明

参数	参数类型	参数位置	是否必须	默认值	说明	初始平台
enterpriseId	String	Query	是	无	企业ID，通过管理平台-云视讯API获得	分区云5.2-20260327 公有云不存在
uniqueId	String	Query	是	无	服务器 id	分区云5.2-20260327 公有云不存在
startTime	Long	Query	否	当前时间-1小时	时间戳，默认最近一小时	分区云5.2-20260327 公有云不存在
endTime	Long	Query	否	当前时间	时间戳。时间跨度最大 14 天	分区云5.2-20260327 公有云不存在

示例代码

返回结果示例：

成功时返回200，失败时返回小鱼RESTAPI错误码

{
  "cpuCount": 32,
  "cpuUsagePercent": [
    [1769150955, "34"],
    [1769150970, "34"],
    [1769150985, "34"],
    [1769151000, "32"]
  ],
  "memoryTotal": 128,
  "memoryUsage": [
    [1769150955, "34"],
    [1769150970, "34"],
    [1769150985, "34"],
    [1769151000, "32"]
  ],
  "memoryUsagePercent": [
    [1769150955, "34"],
    [1769150970, "34"],
    [1769150985, "34"],
    [1769151000, "32"]
  ],
  "diskUsagePercent": {
    "/mnt/xylink": [
      [1772095104, 43.6],
      [1772095140, 43.6],
      [1772095176, 43.6],
      [1772095212, 43.6],
      [1772095248, 43.6],
      [1772095284, 43.6],
      [1772095320, 43.6],
      [1772095356, 43.6]
    ]
  },
  "networkIO": {
    "eth0-recv": [
      [1772095104, 0],
      [1772095140, 0],
      [1772095176, 0],
      [1772095212, 0],
      [1772095248, 0],
      [1772095284, 0],
      [1772098704, 0]
    ],
    "eth0-sent": [
      [1772095104, 0.01],
      [1772095140, 0.01],
      [1772095176, 0.01],
      [1772095212, 0.01],
      [1772095248, 0.01],
      [1772095284, 0.01],
      [1772095320, 0.01],
      [1772095356, 0.01],
      [1772095392, 0.01],
      [1772095428, 0.01]
    ]
  },
  "fanStatus": "normal",
  "powerStatus": "on"
}

成功时返回结果数据，失败时返回小鱼RESTAPI错误码

返回参数说明

参数名	说明
cpuCount	cpu总核数
cpuUsagePercent	服务器 CPU 使用率（单位：%），数组，取开始到结束时间某些时间点的对应值。取值范围 0~100
memoryTotal	内存总量
memoryUsagePercent	服务器内存使用率（单位：%），取开始到结束时间某些时间点的对应值。取值范围 0~100
memoryUsage	服务器内存使用量
diskUsagePercent	各磁盘分区使用率，Key 为分区路径（如/），Value 为使用率（%）
networkIO	各网卡网络 IO 数据，eth0-recv为 eth0 网卡的入网流量，eth0-sent为 eth0网卡的出网流量
fanStatus	风扇状态
powerStatus	电源状态

2026-03-02 16:05:16

导出PDF文档