Instance dimensions and metric dimensions, instance dimensions: Instance ID or parent instance ID (required); metric dimensions: Dimensions carried by the monitoring metric (optional)
Yes
Body
labels
Set<String>
Metric dimensions to be sorted
Yes
Body
startTime
String
Monitor data start time, refer to [Date and Time](BCM/API Reference/General Description.md), in UTC format
Yes
Body
endTime
String
Monitor data end time, refer to [Date and Time](BCM/API Reference/General Description.md), expressed in UTC date
Yes
Body
order
String
Sorting method, optional values top (descending), bottom (ascending), default top
No
Body
topNum
int
Number of topNum items retained after sorting, default: 10, maximum: 1000
No
Body
Parameter explanation
For concepts like Scope, Metric, Statistic, and Dimension, refer to [Core Concepts](BCM/Product Description/Core concepts.md).
Response parameters
Name
Types
Description
requestId
String
Request identifier ID
topDatas
List<TopData>
Sorted list of dimension values
TopData
Name
Types
Description
order
int
Ranking
dimensions
List<Dimension>
Dimension Information
Dimension
Name
Types
Description
name
String
Dimension name
value
String
Dimension value
Request example
// config of client
String endpoint = "http://bcm.bj.baidubce.com";
String userId = "a0d04d7c***************7b6752ce4";
String ak = "ALTAK***************3hVCYG";
String sk = "b2c53*******************f9993ac1";
// create a bcm client
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);
