全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
云服务器 ECS

DescribeDiskMonitorData

更新时间:2017-09-13 14:36:19

描述

分页查询本用户的指定磁盘的相关监控信息。

  • 只能查询到状态 In_use 状态的磁盘的监控信息。
  • 可返回的监控内容包括:磁盘的读 IOPS,磁盘的写 IOPS,磁盘的读带宽(Bps),磁盘的写带宽(Bps),磁盘的读延时(ms),磁盘的写延时(ms)。有可能返回的监控内容中会缺少部分内部,这可能是由于系统没有获得到相应的信息,比如磁盘不在 In_use 状态。
  • 一次最大只容许返回 400 条监控数据,如果指定的 (EndTime – StartTime)/ Peroid > 400,则返回错误。

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数,取值:DescribeDiskMonitorData
DiskId 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 秒。

返回参数

名称 类型 描述
TotalCount Integer 磁盘监控数据的总个数
MonitorData DiskMonitorDataType 磁盘的监控数据 DiskMonitorDataType 组成的集合。

错误码

错误代码 描述 Http状态码 语义
InvalidDiskId.NotFound The DiskId provided does not exist in our records. 404 磁盘 ID 不存在
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 太早
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=DescribeDiskMonitorData
  2. &DiskId=d-mydisk001
  3. &StartTime=2014-07-23T12:07:00Z
  4. &EndTime=2014-07-23T12:09:00Z
  5. &<公共请求参数>

返回示例

XML格式

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <DescribeDiskMonitorDataResponse>
  3. <MonitorData>
  4. <DiskMonitorData>
  5. <BPSRead>0</BPSRead>
  6. <BPSTotal>0</BPSTotal>
  7. <BPSWrite>0</BPSWrite>
  8. <DiskId>d-23b3p4r8b</DiskId>
  9. <IOPSRead>0</IOPSRead>
  10. <IOPSTotal>0</IOPSTotal>
  11. <IOPSWrite>0</IOPSWrite>
  12. <TimeStamp>2014-07-23T12:07:00Z</TimeStamp>
  13. </DiskMonitorData>
  14. <DiskMonitorData>
  15. <BPSRead>0</BPSRead>
  16. <BPSTotal>204</BPSTotal>
  17. <BPSWrite>204</BPSWrite>
  18. <DiskId>d-23b3p4r8b</DiskId>
  19. <IOPSRead>0</IOPSRead>
  20. <IOPSTotal>0</IOPSTotal>
  21. <IOPSWrite>0</IOPSWrite>
  22. <TimeStamp>2014-07-23T12:08:00Z</TimeStamp>
  23. </DiskMonitorData>
  24. <DiskMonitorData>
  25. <BPSRead>0</BPSRead>
  26. <BPSTotal>819</BPSTotal>
  27. <BPSWrite>819</BPSWrite>
  28. <DiskId>d-23b3p4r8b</DiskId>
  29. <IOPSRead>0</IOPSRead>
  30. <IOPSTotal>0</IOPSTotal>
  31. <IOPSWrite>0</IOPSWrite>
  32. <TimeStamp>2014-07-23T12:09:00Z</TimeStamp>
  33. </DiskMonitorData>
  34. </MonitorData>
  35. <RequestId>BF666447-B171-4076-BCBA-48437C18FD76</RequestId>
  36. <TotalCount>3</TotalCount>
  37. </DescribeDiskMonitorDataResponse>

JSON格式

  1. {
  2. "MonitorData": {
  3. "DiskMonitorData": [
  4. {
  5. "BPSRead": 0,
  6. "BPSTotal": 0,
  7. "BPSWrite": 0,
  8. "DiskId": "d-23b3p4r8b",
  9. "IOPSRead": 0,
  10. "IOPSTotal": 0,
  11. "IOPSWrite": 0,
  12. "TimeStamp": "2014-07-23T12:07:00Z"
  13. },
  14. {
  15. "BPSRead": 0,
  16. "BPSTotal": 204,
  17. "BPSWrite": 204,
  18. "DiskId": "d-23b3p4r8b",
  19. "IOPSRead": 0,
  20. "IOPSTotal": 0,
  21. "IOPSWrite": 0,
  22. "TimeStamp": "2014-07-23T12:08:00Z"
  23. },
  24. {
  25. "BPSRead": 0,
  26. "BPSTotal": 819,
  27. "BPSWrite": 819,
  28. "DiskId": "d-23b3p4r8b",
  29. "IOPSRead": 0,
  30. "IOPSTotal": 0,
  31. "IOPSWrite": 0,
  32. "TimeStamp": "2014-07-23T12:09:00Z"
  33. }
  34. ]
  35. },
  36. "RequestId": "A48A0A77-34F5-4C33-9066-9E8D2DA0D8E2",
  37. "TotalCount": 3
  38. }
本文导读目录