维度值TopN查询接口
接口描述
接口可获取某个云产品实例下某个指标名的某些维度下的维度值TopN。
请求参数
名称 |
类型 |
描述 |
是否必须 |
参数位置 |
userId |
String |
用户ID |
是 |
Body参数 |
scope |
String |
云产品标识,取值请参考云产品标识列表 |
是 |
Body参数 |
region |
String |
区域标识,取值请参考区域列表 |
是 |
Body参数 |
metricName |
String |
监控指标 |
是 |
Body参数 |
statistics |
String |
统计方法类型,可选值:average、maximum、minimum、sum、sampleCount |
是 |
Body参数 |
dimensions |
Map<String, String> |
实例维度和指标维度,实例维度:实例Id或父实例Id(必填);指标维度:监控指标携带的维度(选填) |
是 |
Body参数 |
labels |
Set<String> |
需要排序的指标维度 |
是 |
Body参数 |
startTime |
String |
监控数据开始时间,请参考日期与时间,UTC日期表示 |
是 |
Body参数 |
endTime |
String |
监控数据结束时间,请参考日期与时间,UTC日期表示 |
是 |
Body参数 |
order |
String |
排序方式,可选值top(从大到小)、bottom((从小到大)),默认top |
否 |
Body参数 |
topNum |
int |
排序后保留的前topNum数量,默认值:10,最大为1000 |
否 |
Body参数 |
参数解释
- 名字空间scope、监控项metric、统计方法Statistic、维度Dimension等的概念请参考核心概念。
响应参数
名称 |
类型 |
描述 |
requestId |
String |
请求标识ID |
topDatas |
List<TopData> |
排序后的维度值列表 |
TopData
名称 |
类型 |
描述 |
order |
int |
排名 |
dimensions |
List<Dimension> |
维度信息 |
Dimension
名称 |
类型 |
描述 |
name |
String |
维度名 |
value |
String |
维度值 |
请求示例
response = bcm_client.get_metric_dimension_top(user_id="453bf9********************9090dc",
scope="BCE_NAT", region="bj",
dimensions= {"NatId": "nat-bm1******vf8"},
metric_name="ConnNumber",
statistics="average",
labels=[
"FixIp"
],
start_time="2024-03-21T06:33:50Z",
end_time="2024-03-21T07:33:50Z")
响应示例
{
"requestId": "34faaba47566446c9ba32cd1d2bf082b",
"topDatas": [
{
"order": 1,
"dimensions": [
{
"name": "FixIp",
"value": "192.168.0.16"
}
]
},
{
"order": 2,
"dimensions": [
{
"name": "FixIp",
"value": "192.168.0.15"
}
]
}
]
}