接口说明

可查询云盘实用信息包括读IOPS、写IOPS、读带宽（B/s）、写带宽（B/s）、读时延（μs）以及写时延（μs）。

调用该接口时，您需要注意：

• 只能查询状态为使用中（ In_Use）的云盘使用信息。更多详情，请参见 普通云盘状态表。

  说明 若查询的信息中出现内容缺失，是因为无法获取该段时间的使用信息，即云盘状态不是使用中（ In_Use）。
• 一次最多返回400条数据，即指定的（EndTime–StartTime）/Period不能超过400。
• 一次最多能查询近30天内的监控信息，即指定的参数StartTime不能超过30天。

请求参数

返回数据

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeDiskMonitorData
&DiskId=d-bp1bq5g3dxxo1x4o****
&EndTime=2014-07-23T12:09:00Z
&StartTime=2014-07-23T12:07:00Z
&Period=60
&<公共请求参数>

正常返回示例

XML 格式

<DescribeDiskMonitorDataResponse>
          <MonitorData>
                    <DiskMonitorData>
                              <BPSRead>0</BPSRead>
                              <BPSTotal>0</BPSTotal>
                              <BPSWrite>0</BPSWrite>
                              <DiskId>d-bp1bq5g3dxxo1x4o****</DiskId>
                              <IOPSRead>0</IOPSRead>
                              <IOPSTotal>0</IOPSTotal>
                              <IOPSWrite>0</IOPSWrite>
                              <TimeStamp>2014-07-23T12:07:00Z</TimeStamp>
                    </DiskMonitorData>
                    <DiskMonitorData>
                              <BPSRead>0</BPSRead>
                              <BPSTotal>204</BPSTotal>
                              <BPSWrite>204</BPSWrite>
                              <DiskId>d-bp1bq5g3dxxo1x4o****</DiskId>
                              <IOPSRead>0</IOPSRead>
                              <IOPSTotal>0</IOPSTotal>
                              <IOPSWrite>0</IOPSWrite>
                              <TimeStamp>2014-07-23T12:08:00Z</TimeStamp>
                    </DiskMonitorData>
                    <DiskMonitorData>
                              <BPSRead>0</BPSRead>
                              <BPSTotal>819</BPSTotal>
                              <BPSWrite>819</BPSWrite>
                              <DiskId>d-bp1bq5g3dxxo1x4o****</DiskId>
                              <IOPSRead>0</IOPSRead>
                              <IOPSTotal>0</IOPSTotal>
                              <IOPSWrite>0</IOPSWrite>
                              <TimeStamp>2014-07-23T12:09:00Z</TimeStamp>
                    </DiskMonitorData>
          </MonitorData>
          <RequestId>BF666447-B171-4076-BCBA-48437C18FD76</RequestId>
          <TotalCount>3</TotalCount>
</DescribeDiskMonitorDataResponse>

JSON 格式

{
    "MonitorData": {
        "DiskMonitorData": [
            {
                "BPSRead": 0,
                "BPSTotal": 0,
                "BPSWrite": 0,
                "DiskId": "d-bp1bq5g3dxxo1x4o****",
                "IOPSRead": 0,
                "IOPSTotal": 0,
                "IOPSWrite": 0,
                "TimeStamp": "2014-07-23T12:07:00Z"
            },
            {
                "BPSRead": 0,
                "BPSTotal": 204,
                "BPSWrite": 204,
                "DiskId": "d-bp1bq5g3dxxo1x4o****",
                "IOPSRead": 0,
                "IOPSTotal": 0,
                "IOPSWrite": 0,
                "TimeStamp": "2014-07-23T12:08:00Z"
            },
            {
                "BPSRead": 0,
                "BPSTotal": 819,
                "BPSWrite": 819,
                "DiskId": "d-bp1bq5g3dxxo1x4o****",
                "IOPSRead": 0,
                "IOPSTotal": 0,
                "IOPSWrite": 0,
                "TimeStamp": "2014-07-23T12:09:00Z"
            }
        ]
    },
    "RequestId": "A48A0A77-34F5-4C33-9066-9E8D2DA0D8E2",
    "TotalCount": 3
}

错误码

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