Skip to main content

DescribeInstanceMonitorData

Description

Call the DescribeInstanceMonitorData to query the monitoring information of an ECS instance. The metrics that can be queried include the vCPU usage of ECS instances, burstable instance credits, received data traffic, sent data traffic, and average bandwidth.

Request Method

POST

Request Path

/apsara/route/Ecs/DescribeInstanceMonitorData

Request Parameters Common Parameters

NameLocationTypeRequiredSample valueDescription
EndTimeBODYstringYes2014-10-30T08:00:00Zend time of data acquisition. According to the ISO8601 standard and using UTC +0 time, the format is yyyy-MM-ddTHH:mm:ssZ. If the specified second (ss) is not 00, it is automatically converted to the next minute.
InstanceIdBODYstringYesi-bp1a36962lrhj4ab****the instance ID to be queried.
regionIdBODYstringYesNo sample value for this parameter.region id
StartTimeBODYstringYes2014-10-29T23:00:00Zthe starting time to obtain data. According to the ISO8601 standard and using UTC +0 time, the format is yyyy-MM-ddTHH:mm:ssZ. If the specified second (ss) is not 00, it is automatically converted to the next minute.
PeriodBODYintegerNo60the interval between obtaining monitoring data, in seconds. Value range: 60 600 3600 default value: 60.
versionBODYstringNo2016-01-01version of api

Return data

NameTypeSample valueDescription
RequestIDstring1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DCRequest id

Example

Successful Response example

{
"RequestID":"1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DC"
}

Failed Response example

{
"errorSample":
{
"resultCode":-1,
"resultMsg":"system error",
"result":null
}

}