调用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. 没有足够的权限,请联系云账号管理员授予您相应权限。

访问错误中心查看更多错误码。