维度值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 |
维度值 |
请求示例
String endpoint = "http://bcm.bj.baidubce.com";
String userId = "a0d04d7c***************7b6752ce4";
String ak = "ALTAK***************3hVCYG";
String sk = "b2c53*******************f9993ac1";
BcmClientConfiguration config = new BcmClientConfiguration();
config.setCredentials(new DefaultBceCredentials(ak, sk));
config.setEndpoint(endpoint);
BcmClient bcmClient = new BcmClient(config);
TsdbDimensionTopQuery request = new TsdbDimensionTopQuery();
request.setUserId(userId);
request.setScope("BCE_NAT");
request.setRegion("bj");
request.setMetricName("ConnNumber");
request.setStatistics("average");
request.setStartTime("2024-04-27T07:10:01Z");
request.setEndTime("2024-04-27T07:20:01Z");
Map<String, String> dimensionMap = new HashMap<>();
dimensionMap.put("NatId", "nat-bm********f8");
request.setDimensions(dimensionMap);
Set<String> labels = new HashSet<>();
labels.add("FixIp");
request.setLabels(labels);
request.setTopNum(2);
TsdbDimensionTopResult result = bcmClient.getMetricDimensionTop(request);
响应示例
{
"requestId": "34faaba47566446c9ba32cd1d2bf082b",
"topDatas": [
{
"order": 1,
"dimensions": [
{
"name": "FixIp",
"value": "192.168.0.16"
}
]
},
{
"order": 2,
"dimensions": [
{
"name": "FixIp",
"value": "192.168.0.15"
}
]
}
]
}