更新时间:2024-12-10 GMT+08:00
分享

主机指标数据查询

功能

主机指标数据查询。

SLA项

定义

请求成功率

>=99.9%

可用性

Tair1

数据一致性

最终一致,不一致时长<1分钟

吞吐量

4000tps

TP50请求时延

2ms

TP99.9请求时延

5ms

注意事项

调用方法

GET

URI

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

路径参数

查询参数

参数

是否必选

类型

值域

描述

host_id

string

主机ID

begin_time

integer

开始时间

end_time

integer

结束时间

offset_value

integer

偏移大小:大于等于0

page_size

integer

0~1000

页大小:大于等于0

请求

  • 请求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

响应

  • 响应参数
  • 响应示例
    HTTP/1.1 200 OK
    Date:Tue,18 Jul 2023 09:58:01 GMT
    Server: example.com
    Content-Type: application/json;charset=UTF8
    {
        "total": 12132,
        "list": [
                 {
                 "time_stamp": "1697372808000",
                 "monitor_item": "memory",
                 "region_id": "cn-north-xx",
                 "az_name": "",
                 "metrics_name": "Memory",
                 "operator": "AVG",
                 "host_id": "00700188-9859-xxx8-8889-71axxx4565",
                 "az_id": "",
                 "unit": "\\%",
                 "az_name_en": "",
                 "region_name": "",
                 "data_item": "usage",
                 "region_name_en": "",
                 "value": "79.81"
                  }
                ]
    }

状态码

状态码

说明

200

操作成功。

400

参数错误。

401

token鉴权失败。

403

鉴权失败。

404

接口没找到。

操作危险级别

Minor

相关文档