主机指标数据查询

功能

主机指标数据查询。

注意事项

无

调用方法

GET

URI

/rest/dataapi/homs/open-api/v1/host/metricdata

路径参数

无

查询参数

请求

• 请求header参数

  参数	是否必选	类型	值域	说明
  X-APIG-Appcode	是	string	无	由SRE分配的AppCode。
  x-auth-token	是	string	无	调用方APIG的IAM认证token。
  x-hcso-domainid	否	string	无	接入的租户ID，HCSO场景必填，其他场景不要求。
  x-hcso-appcode	是	string	无	由SRE分配的AppCode。

• 请求body参数

  无

• 请求示例

  GET /rest/dataapi/homs/open-api/v1/host/metricdata HTTP/1.1 
  Host: example.com 
  Content-Type: application/json 
  Accept: application/json
  X-APIG-Appcode: xxx 
  x-auth-token: xxx 
  x-hcso-domainid：xxx 
  x-hcso-appcode：xxx

响应

• 响应参数
  • 响应状态码200：返回Data对象。Data对象包含如下属性：

    参数	是否必选	类型	值域	说明
    total	是	int32	无	数据总数量。
    list	是	List<Item>	无	流程对象。

    Item对象包含如下属性：

    参数	是否必选	类型	值域	说明
    time_stamp	是	Int64	无	时间戳。
    monitor_item	是	string	无	监视器项目。
    region_id	是	String	无	区域ID。
    az_name	否	string	无	可用区域。
    metrics_name	是	string	无	指标名称。 涉及19项指标如下： CPU总体使用率 内存使用率 磁盘使用率 系统平均负载 系统截止运行时长 磁盘IO每秒读请求数 磁盘IO每秒写请求数 磁盘IO使用率 磁盘IO读平均耗时 磁盘IO写平均耗时 磁盘IO访问耗时 网卡接收字节数 网卡发送字节数 网卡当前速率 网卡接收报文错误率 网卡接收报文丢包率 网卡发送报文丢包率 网卡发送报文错误率 网卡状态
    operator	否	string	无	操作者。
    host_id	是	string	无	主机ID。
    az_id	否	string	无	可用区域ID。
    unit	否	string	无	指标单位。
    region_name	否	string	无	区域名称。
    data_item	是	string	无	数据项。
    metrics_value	否	Float64	无	指标值。

• 响应示例

  HTTP/1.1 200 OK
  Date:Tue,18 Jul 2023 09:58:01 GMT
  Server: example.com
  Content-Type: application/json;charset=UTF8
  {
      "total": 总数,
      "list": [
               {
               "time_stamp": "时间戳",
               "monitor_item": "监视器项目",
               "region_id": "区域ID",
               "az_name": "可用区域",
               "metrics_name": "指标名称",
               "operator": "操作者",
               "host_id": "主机ID",
               "az_id": "可用区域ID",
               "unit": "指标单位",
               "region_name": "区域名称",
               "data_item": "数据项",
               "value": "指标值"
                }
              ]
  }

状态码

操作危险级别

Minor