只能查詢到狀態 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 不存在
MissingParameter
The input parameter "DiskId" that is mandatory for processing this request is not supplied.
400
缺少 Disk ID 參數
InvalidStartTime.Malformed
The specified parameter "StartTime" is not valid.
400
StartTime 格式不合法
MissingParameter
The input parameter "StartTime" that is mandatory for processing this request is not supplied.
400
缺少 StartTime 值
InvalidEndTime.Malformed
The specified parameter "EndTime" is not valid.
400
指定的 EndTime 格式不合法
MissingParameter
The input parameter "EndTime" that is mandatory for processing this request is not supplied.
400
缺少 EndTime 值
InvalidParameter
The specified parameter "Period" is not valid.
400
指定的 Period 不是數字
InvalidPeriod.ValueNotSupported
The specified parameter "Period" is not valid.
400
指定的 Period 格式不合法
InvalidStartTime.TooEarly
The specified parameter "StartTime" is too early.
400
指定的 StartTime 太早
示例
請求示例
https://ecs.aliyuncs.com/?Action=DescribeDiskMonitorData
&DiskId=d-mydisk001
&StartTime=2014-07-23T12:07:00Z
&EndTime=2014-07-23T12:09:00Z
&<公共請求參數>
返回示例

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