调用DescribeInstanceMonitorData查询实例CPU和内存的使用情况。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeInstanceMonitorData |
系统参数,取值:DescribeInstanceMonitorData。 |
Version | String | 是 | 2017-11-10 |
版本号。 |
InstanceId | String | 否 | yourInstance ID |
实例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 | yourInstance ID |
实例ID。 |
Memory | String | 暂不支持 |
该字段暂不支持返回参数。 |
RequestId | String | C8B26B44-0189-443E-9816-D951F59623A9 |
请求ID。 |
示例
请求示例
https://ens.aliyuncs.com/?Action=DescribeInstanceMonitorData
&Version=2017-11-10
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
<MonitorData>
<InstanceMonitorData>
<InstanceId>yourInstance ID</InstanceId>
<Memory>暂不支持</Memory>
<CPU>0.02</CPU>
</InstanceMonitorData>
</MonitorData>
<Code>0</Code>
JSON
格式
{
"RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
"MonitorData": {
"InstanceMonitorData": {
"InstanceId": "yourInstance ID",
"Memory": "暂不支持",
"CPU": 0.02
}
},
"Code": 0
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | NoPermission | Permission denied. | 没有足够的权限,请联系云账号管理员授予您相应权限。 |
访问错误中心查看更多错误码。