主机指标数据查询
功能
主机指标数据查询。
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