调用DescribeInstanceMonitorData查询实例CPU和内存的使用情况。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeInstanceMonitorData | 系统参数,取值:DescribeInstanceMonitorData。 |
Version | String | 是 | 2017-11-10 | 版本号。 |
InstanceId | String | 否 | instance**** | 实例ID,仅支持单个查询。 |
StartTime | String | 否 | 2019-10-29T23:00:00Z | 获取数据的起始时间点。 按照ISO8601标准表示,并需要使用UTC时间。格式为yyyy-MM-ddTHH:mm:ssZ。如果秒不是00,则自动取为下一分钟开始时。 |
EndTime | String | 否 | 2019-10-30T08:00:00Z | 获取数据的结束时间点。 按照ISO8601标准表示,并需要使用UTC时间。格式为yyyy-MM-ddTHH:mm:ssZ。如果秒不是00,则自动取为下一分钟开始时。 |
Period | String | 否 | 60 | 获取监控数据的精度,取值:60(默认值)、300、1200、3600及14400,单位:秒。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | Integer | 0 | 业务码,成功返回0。 |
MonitorData | Array of InstanceMonitorData | 实例的监控数据InstanceMonitorDataType组成的集合。 |
|
InstanceMonitorData | |||
CPU | String | 0.02 | 实例vCPU的使用情况,为原始数据,如0.02,则使用率为2%。 |
InstanceId | String | instance**** | 实例ID。 |
Memory | String | 暂不支持 | 该字段暂不支持返回参数。 |
RequestId | String | C8B26B44-0189-443E-9816-D951F59623A9 | 请求ID。 |
示例
请求示例
https://ens.aliyuncs.com/?Action=DescribeInstanceMonitorData
&InstanceId=instance****
&StartTime=2019-10-29T23:00:00Z
&EndTime=2019-10-30T08:00:00Z
&<公共请求参数>
正常返回示例
XML
格式
<DescribeInstanceMonitorDataResponse>
<RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
<MonitorData>
<InstanceMonitorData>
<InstanceId>instance****</InstanceId>
<CPU>
<CPU>0.02</CPU>
<TimeStamp>2010-01-21T09:50:23Z</TimeStamp>
</CPU>
<CPU>
<CPU>0.02</CPU>
<TimeStamp>2010-01-21T09:50:23Z</TimeStamp>
</CPU>
</InstanceMonitorData>
</MonitorData>
</DescribeInstanceMonitorDataResponse>
JSON
格式
{
"RequestId":"C8B26B44-0189-443E-9816-D951F59623A9",
"MonitorData":{
"InstanceMonitorData":[
{
"InstanceId":"instance****",
"CPU":[
{
"CPU":0.02,
"TimeStamp":"2010-01-21T09:50:23Z"
},
{
"CPU":0.02,
"TimeStamp":"2010-01-21T09:50:23Z"
}
]
}
]
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | NoPermission | Permission denied. | 没有足够的权限,请联系云账号管理员授予您相应权限。 |
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交