全部产品
云服务器 ECS

DescribeInstanceMonitorData

更新时间:2017-09-13 14:36:12   分享:   

描述

分页查询本用户的所有云服务器相关的监控信息。

  • 可返回的监控内容包括:云服务器的 CPU 使用率、云服务器分配到的内存数、云服务器接收到的数据流量、云服务器发送的数据流量、云服务器网络流量、云服务器平均带宽。有可能返回的监控内容中会缺少部分内部,这可能是由于系统没有获得到相应的信息,比如当时实例处于已停止(Stopped)状态。
  • 一次最大只容许返回 400 条监控数据,如果指定的(EndTime – StartTime)/ Peroid > 400,则返回错误。
  • 一次最长能查询近 30 天内的监控信息,如果指定的 StartTime 超过 30 天,则返回错误。

请求参数

名称 类型 是否必须 描述
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 秒
  • 600 秒
  • 3600 秒
默认 60 秒。

返回参数

名称 类型 描述
MonitorData InstanceMonitorDataType 实例的监控数据 InstanceMonitorDataType 组成的集合。

错误码

错误代码 描述 Http状态码 语义
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的 InstanceId 不存在。
InvalidStartTime.Malformed The specified parameter “StartTime” is not valid. 400 指定的 StartTime 格式无效。
InvalidEndTime.Malformed The specified parameter “EndTime” is not valid. 400 指定的 EndTime 格式无效。
InvalidPeriod.ValueNotSupported The specified parameter “Period” is not valid. 400 指定的 Period 格式无效。
InvalidStartTime.TooEarly The specified parameter “StartTime” is too early. 400 指定的 StartTime 早于 30 天。
InvalidParameter.TooManyDataQueried Too many data queried. 400 查询的数据量过多。
Throttling You have made too many requests within a short time; your request is denied due to request throttling. 400 请求被流控。

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=DescribeInstanceMonitorData
  2. &InstanceId=i-instnace1
  3. &StartTime=2014-10-29T23:00:00Z
  4. &EndTime=2014-10-30T08:00:00Z
  5. &<公共请求参数>

返回示例

XML格式

  1. <DescribeInstanceMonitorDataResponse>
  2. <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
  3. <MonitorData>
  4. <InstanceMonitorData>
  5. <InstanceId>Bc0102-23xYm09</InstanceId>
  6. <CPU>2</CPU>
  7. <IntranetRX>122</IntranetRX>
  8. <IntranetTX>343</IntranetTX>
  9. <IntranetFlow>675</IntranetFlow>
  10. <IntranetBandwidth>10</IntranetBandwidth>
  11. <InternetRX>122</InternetRX>
  12. <InternetTX>343</InternetTX>
  13. <InternetFlow>675</InternetFlow>
  14. <InternetBandwidth>10</InternetBandwidth>
  15. <IOPSRead>1000</IOPSRead>
  16. <IOPSWrite>200</IOPSWrite>
  17. <BPSRead>1000</BPSRead>
  18. <BPSWrite>200</BPSWrite>
  19. <TimeStamp>2010-01-21T09:50:23Z</TimeStamp>
  20. </InstanceMonitorData>
  21. </MonitorData>
  22. </DescribeInstanceMonitorDataResponse>

JSON格式

  1. {
  2. "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
  3. "MonitorData": {
  4. "InstanceMonitorData": [{
  5. "InstanceId": "Bc0102-23xYm09",
  6. "CPU": 0,
  7. "IntranetRX": 122,
  8. "IntranetTX": 343,
  9. "IntranetFlow": 675,
  10. "IntranetBandwidth": 10,
  11. "InternetRX": 122,
  12. "InternetTX": 343,
  13. "InternetFlow": 675,
  14. "InternetBandwidth": 10,
  15. "IOPSRead": 1000,
  16. "IOPSWrite": 200,
  17. "BPSRead": 1000,
  18. "BPSWrite": 200,
  19. "TimeStamp": "2010-01-21T09:50:23Z"
  20. }]
  21. }
  22. }
本文导读目录
本文导读目录
以上内容是否对您有帮助?