Query Latest Metric Data for Partial Dimensions

Updated at：2025-11-03

API description

Data from Cloud Product Monitor, Site Monitor, or Custom Monitor with a defined time range can be accessed using multiple dimensions, metrics, and statistics.

API restriction

Each query can include up to 100 dimension combinations.
A query can include a maximum of 30 metric names.

Request structure

Method: POST
URL: /csm/api/v2/userId/{userId}/services/{scope}/data/metricData/latest/batch

Request parameters

Name	Types	Description	Required or not	Parameter location
userId	String	User ID	Yes	Body
scope	String	Cloud product identifier. For values, refer to [Cloud Product Identifier List](BCM/Cloud Product Monitor List/Cloud Product Monitor Object Type List.md)	Yes	Body
region	String	Region identifier. For values, refer to [Region List](BCM/API Reference/Service domain.md)	Yes	Body
resourceType	String	Monitor object type, default value: Instance. For values, refer to [Cloud Product Monitor Object Type List](BCM/Cloud Product Monitor List/Cloud Product Monitor Object Type List.md)	No	Body
metricNames	List<String>	List of Monitor Metrics	Yes	Body
statistics	List<String>	List of statistic methods includes: average, maximum, minimum, sum, and sampleCount. If left empty, the latest original value will be returned by default.	No	Body
dimensions	List<Dimension>	Dimension list	No	Body
cycle	int	Statistical period, unit: second, default: 60, maximum: 3,600	No	Body
timestamp	DateTime	Time corresponding to the statistical period of Metric, default is the current time. Refer to [Date and Time](BCM/API Reference/General Description.md), expressed in UTC date	Yes	Body

Dimension

Name	Types	Description	Required or not	Parameter location
name	String	Dimension key	Yes	Body
value	String	Dimension value	Yes	Body

Parameter explanation

For cloud product identifier 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
code	String	Return code
message	String	Error message
metrics	List<AllDataMetric>	Monitor Metric

AllDataMetric

Name	Types	Description
region	String	Region identifier
scope	String	Cloud product identifier
userId	String	User ID
resourceId	String	Resource ID
metricName	String	Metric name
dimensions	List<Dimensions>	Dimension list
dataPoints	List<DataPoint>	Monitor Metric data

DataPoint

Name	Types	Description
average	double	Average of Metrics within the statistical period
sum	double	Sum of Metrics within the statistical period
minimum	double	Minimum value of Metrics within the statistical period
maximum	double	Maximum value of Metrics within the counting cycle
sampleCount	int	Number of DataPoints for the Metric within the statistical period
value	int	Original value of Metrics within the counting cycle
timestamp	DateTime	Time corresponding to the statistical period of Metric, refer to [Date and Time](BCM/API Reference/General Description.md), expressed in UTC date

Request example

                JSON
                
            

                POST /csm/api/v2/userId/user1/services/BCE_BLB/data/metricData/latest/batch  HTTP/1.1  
Host:bcm.bj.baidubce.com:80
{   
    "userId" : "453bf9588c*****f9ba2c984129090dc",    
    "region" : "bj",
    "scope" : "BCE_BLB",
    "resourceType" : "Instance",
    "dimensions" : [
             {
                 "name": "BlbId",
                 "value": "lb-8ce1****"
             },
             {
                 "name": "BlbPort",
                 "value": "8200"
             }
    ],
    "metricNames": [
        "ActiveConnCount"
    ],
    "timestamp" : "2024-03-18T06:01:00Z"
    "statistics":[
        "average",
        "sum",
        "minimum"
    ],
    "cycle" : 60
}
            

Response example

                JSON
                
            

                HTTP/1.1 200 OK
x-bce-request-id: 8a53f39b25ff44c6b2f9ac5b75377bbb
Content-Type: application/json;charset=UTF-8
{
    "requestId": "8a53f39b25ff44c6b2f9ac5b75377bbb",
    "code": "success",
    "message": null,
    "metrics": [
        {
            "region": "bj",
            "scope": "BCE_BLB",
            "userId": "453bf9588c9*******a2c984129090dc",
            "resourceId": "lb-8ce1e1a0",
            "metricName": "ActiveConnCount",
            "dimensions": [
                {
                    "name": "BlbId",
                    "value": "lb-8ce1****"
                },
                {
                    "name": "BlbPort",
                    "value": "8200"
                },
                {
                    "name": "BlbPortType",
                    "value": "TCP"
                }
            ],
            "dataPoints": [
                {
                    "average": 3.0,
                    "sum": 3.0,
                    "minimum": 3.0,
                    "timestamp": "2024-03-18T06:01:00Z"
                }
            ]
        }
    ]
}
            

Site Monitor

General Description

BCM

BCM