查看云服务器实例的监控信息
描述
分页查询本用户的所有云服务器相关的监控信息。
只能查询到状态非 Deleted 或者非刚刚创建完成尚处于 Stopped 状态的云服务器的监控信息。
可返回的监控内容包括：云服务器的 CPU 使用率、云服务器分配到的内存数、云服务器接收到的数据流量、云服务器发送的数据流量、云服务器网络流量、云服务器平均带宽。有可能返回的监控内容中会缺少部分内部，这可能是由于系统没有获得到相应的信息，比如当时实例处于 Stopped 状态。
一次最大只容许返回 400 条监控数据，如果指定的(EndTime – StartTime)/ Peroid > 400，则返回错误。
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| Action | String | 是 | 系统规定参数，取值：DescribeInstanceMonitorData |
| InstanceId | String | 是 | 指定监控的实例 ID |
| StartTime | String | 是 | 获取数据的起始时间点：按照 ISO8601 标准表示，并需要使用 UTC 时间。格式为：YYYY-MM-DDThh:mm:ssZ。 如果秒不是 00，则自动取为下一分钟开始时 |
| EndTime | String | 是 | 获取数据的结束时间点：按照 ISO8601 标准表示，并需要使用 UTC 时间。格式为：YYYY-MM-DDThh:mm:ssZ。 如果秒不是 00，则自动取为下一分钟开始时 |
| Period | Integer | 否 | 获取监控数据的精度:
默认 60 秒。 |
返回参数
| 名称 | 类型 | 描述 |
|---|---|---|
| MonitorData | InstanceMonitorDataType | 实例的监控数据 InstanceMonitorDataType 组成的集合。 |
错误码
| 错误代码 | 描述 | Http 状态码 | 语义 |
|---|---|---|---|
| InvalidInstanceId.NotFound | The InstanceId provided does not exist in our records. | 404 | 指定的 InstanceId 不存在 |
| MissingParameter | The input parameter "InstanceId" that is mandatory for processing this request is not supplied. | 400 | 缺少 InstanceId 值 |
| InvalidStartTime.Malformed | The specified parameter "StartTime" is not valid. | 400 | 指定的 StartTime 格式不合法 |
| MissingParameter | The input parameter "StartTime" that is mandatory for processing this request is not supplied. | 400 | 缺少 StartTime 值 |
| InvalidEndTime.Malformed | The specified parameter "EndTime" is not valid. | 400 | 指定的 EndTime 格式不合法 |
| MissingParameter | The input parameter "EndTime" that is mandatory for processing this request is not supplied. | 400 | 缺少 EndTime 值 |
| InvalidParameter | The specified parameter "Period" is not valid. | 400 | 指定的 Period 不是数字 |
| InvalidPeriod.ValueNotSupported | The specified parameter "Period" is not valid. | 400 | 指定的 Period 格式不合法 |
| InvalidStartTime.TooEarly | The specified parameter "StartTime" is too early. | 400 | 指定的 StartTime 太早 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=DescribeInstanceMonitorData
&InstanceId=i-instnace1
&StartTime=2014-10-29T23:00:00Z
&EndTime=2014-10-30T08:00:00Z
&<公共请求参数>
返回示例
JSON格式
{
"RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
"MonitorData": {
"InstanceMonitorData": [{
"InstanceId": "Bc0102-23xYm09",
"CPU": 0,
"IntranetRX": 122,
"IntranetTX": 343,
"IntranetFlow": 675,
"IntranetBandwidth": 10,
"InternetRX": 122,
"InternetTX": 343,
"InternetFlow": 675,
"InternetBandwidth": 10,
"IOPSRead": 1000,
"IOPSWrite": 200,
"BPSRead": 1000,
"BPSWrite": 200,
"TimeStamp": "2010-01-21T09:50:23Z"
}]
}
}