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

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