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

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