閱讀801 返回首頁    go 阿裏雲 go 技術社區[雲棲]

查看磁盤的監控信息__監控相關接口_API 參考_雲服務器 ECS-阿裏雲

描述

分頁查詢本用戶的指定磁盤的相關監控信息。

  • 隻能查詢到狀態 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
&<公共請求參數>

返回示例

XML格式

<?xml version="1.0" encoding="utf-8"?>
<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
}

最後更新：2016-11-23 16:03:51

  上一篇：go 查看彈性公網IP監控信息__監控相關接口_API 參考_雲服務器 ECS-阿裏雲
  下一篇：go 創建NAT網關__NAT網關相關接口_API 參考_雲服務器 ECS-阿裏雲