DescribeDiskMonitorData

Description

The monitoring data includes read IOPS, write IOPS, read bandwidth (byte/s), write bandwidth (byte/s), read latency (μs), and write latency (μs) of the disk.

When you call this operation, take note of the following items:

• You can query the monitoring data only of the disks that are in the In Use (In_Use) state. For more information, see Basic cloud disk status table.

  Note Some portion of information may be missing from the monitoring data. This is because the system cannot obtain the relevant information, for example, when the disk is not in the In Use (In_Use) state.
• A maximum of 400 entries of data can be returned at a time. That means the value of the following formula cannot be greater than 400: (EndTime-StartTime)/Period.
• You can query only the monitoring data within the past 30 days. That means the specified StartTime parameter cannot be 30 days later than the current time.

Request parameters

Response parameters

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=DescribeDiskMonitorData
&DiskId=d-bp1bq5g3dxxo1x4o****
&EndTime=2014-07-23T12:09:00Z
&StartTime=2014-07-23T12:07:00Z
&Period=60
&<Common request parameters>

Sample success responses

XML format

<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 format

{
    "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
}

Error codes

For a list of error codes, visit the API Error Center.