全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
云服务器 ECS

DescribeInstanceMonitorData

更新时间:2018-02-26 15:01:03

描述

查询您某一台 ECS 实例所有相关的监控信息,查询结果可以分页显示。返回的监控内容包括 ECS 实例的 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。
如果指定的秒(ss)不是 00,则自动换算为下一分钟。
EndTime String 获取数据的结束时间点。按照 ISO8601 标准表示,并需要使用 UTC 时间,格式为:YYYY-MM-DDThh:mm:ssZ。
如果指定的秒(ss)不是 00,则自动换算为下一分钟。
Period Integer 获取监控数据的间隔时间,单位为秒。取值范围:
  • 60
  • 600
  • 3600
默认值:60

返回参数

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

示例

请求示例

  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. }

错误码

错误代码 错误信息 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 天,单次最多能查询近 30 天内的监控信息。
InvalidParameter.TooManyDataQueried Too many data queried. 400 查询的数据量过多,每次最多查询 400 条监控数据。
Throttling You have made too many requests within a short time; your request is denied due to request throttling. 400 请求被流控,请稍后再试。
本文导读目录