查詢一塊磁碟指定時間內的使用資訊。可查詢磁碟實用資訊包括讀 IOPS、寫 IOPS、讀頻寬(Bps)、寫頻寬(Bps)、讀延時(ms)以及寫延時(ms)。若查詢的資訊中出現內容缺失,是因為我們無法獲取該段時間的使用資訊,即磁碟狀態不是 使用中In_Use)。

描述

調用該介面時,您需要注意:

  • 只能查詢狀態為 使用中In_Use)的磁碟使用資訊。更多詳情,請參閱 普通雲端碟狀態表

  • 一次最多返回 400 條資料,即指定的(EndTimeStartTime)/Peroid 需要小於等於 400。

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:DescribeDiskMonitorData
DiskId String 磁碟 ID。
StartTime String 資料的起始時間。按照 ISO8601 標準表示,格式為 YYYY-MM-DDThh:mm:ssZ。使用 UTC 時間標準。如果秒(ss)不是 00,則自動取為下一分鐘開始時。
EndTime String 資料的結束時間。按照 ISO8601 標準表示,格式為 YYYY-MM-DDThh:mm:ssZ。使用 UTC 時間標準。如果秒(ss)不是 00,則自動取為下一分鐘開始時。
Period Integer 資料的精度,單位為秒。取值範圍:
  • 60
  • 600
  • 3600
預設值:60

返回參數

名稱 類型 描述
TotalCount Integer 磁碟使用資訊的返回條目數量。
MonitorData DiskMonitorDataType 磁碟的監控資料集合。

樣本

請求樣本
https://ecs.aliyuncs.com/?Action=DescribeDiskMonitorData
&DiskId=d-mydisk001
&StartTime=2014-07-23T12:07:00Z
&EndTime=2014-07-23T12:09:00Z
&<公共請求參數>
返回樣本

XML 格式

<DescribeDiskMonitorDataResponse>
        <MonitorData>
                <DiskMonitorData>
                        <BPSRead>0</BPSRead>
                        <BPSTotal>0</BPSTotal>
                        <BPSWrite>0</BPSWrite>
                        <DiskId>d-23b3p4r8b</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-23b3p4r8b</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-23b3p4r8b</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-23b3p4r8b",
        "IOPSRead": 0,
        "IOPSTotal": 0,
        "IOPSWrite": 0,
        "TimeStamp": "2014-07-23T12:07:00Z"
      },
      {
        "BPSRead": 0,
        "BPSTotal": 204,
        "BPSWrite": 204,
        "DiskId": "d-23b3p4r8b",
        "IOPSRead": 0,
        "IOPSTotal": 0,
        "IOPSWrite": 0,
        "TimeStamp": "2014-07-23T12:08:00Z"
      },
      {
        "BPSRead": 0,
        "BPSTotal": 819,
        "BPSWrite": 819,
        "DiskId": "d-23b3p4r8b",
        "IOPSRead": 0,
        "IOPSTotal": 0,
        "IOPSWrite": 0,
        "TimeStamp": "2014-07-23T12:09:00Z"
      }
    ]
  }, 
  "RequestId": "A48A0A77-34F5-4C33-9066-9E8D2DA0D8E2",
  "TotalCount": 3
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
InvalidEndTime.Malformed The specified parameter “EndTime” is not valid. 400 指定的 EndTime 不合法。
InvalidParameter.TooManyDataQueried Too many data queried. 400 一次最多返回 400 條資料,即指定的(EndTimeStartTime)/Peroid需要小於等於 400。
InvalidPeriod.ValueNotSupported The specified parameter “Period” is not valid. 400 指定的 Period 不合法。
InvalidStartTime.TooEarly The specified parameter “StartTime” is too early. 400 指定的 StartTime 太早。
InvalidStartTime.Malformed The specified parameter “StartTime” is not valid. 400 指定的 StartTime 不合法。
InvalidDiskId.NotFound The DiskId provided does not exist. 404 指定的 DiskId 不存在。
Throttling You have made too many requests within a short time; your request is denied due to request throttling. 400 系統流控期間,請稍後再試。