edit-icon download-icon

DescribeDiskMonitorData

最終更新日: Aug 01, 2018

指定したディスクの監視データを照会します。監視データには、測定された読み取りIOPS、書き込み IOPS、読み取り帯域幅(Bps)、書き込み帯域幅(Bps)、読み取り待ち時間(ms)、書き込み待ち時間(ms)などの動作動作が含まれます。ディスクが In_Use ステータスでない場合はデータを取得できないため、返された結果から一部のデータが失われている可能性があります。

説明

このインターフェイスを呼び出すときは、次の点を考慮してください。

  • In_use ステータスのディスクに関するモニタリング情報についてのみ照会することができます。詳細については汎用クラウドディスクのステータス表を参照してください。

  • 1 回で最大 400 のモニタリングデータエントリを返すことができます。指定された (EndTime - StartTime)/ Period が 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 で構成される集合。

リクエストの例

  1. https://ecs.aliyuncs.com/?Action=DescribeDiskMonitorData
  2. &DiskId=d-mydisk001
  3. &StartTime=2014-07-23T12:07:00Z
  4. &EndTime=2014-07-23T12:09:00Z
  5. &<Common Request Parameters>

レスポンスの例

XML 形式

  1. <DescribeDiskMonitorDataResponse>
  2. <MonitorData>
  3. <DiskMonitorData>
  4. <BPSRead>0</BPSRead>
  5. <BPSTotal>0</BPSTotal>
  6. <BPSWrite>0</BPSWrite>
  7. <DiskId>d-23b3p4r8b</DiskId>
  8. <IOPSRead>0</IOPSRead>
  9. <IOPSTotal>0</IOPSTotal>
  10. <IOPSWrite>0</IOPSWrite>
  11. <TimeStamp>2014-07-23T12:07:00Z</TimeStamp>
  12. </DiskMonitorData>
  13. <DiskMonitorData>
  14. <BPSRead>0</BPSRead>
  15. <BPSTotal>204</BPSTotal>
  16. <BPSWrite>204</BPSWrite>
  17. <DiskId>d-23b3p4r8b</DiskId>
  18. <IOPSRead>0</IOPSRead>
  19. <IOPSTotal>0</IOPSTotal>
  20. <IOPSWrite>0</IOPSWrite>
  21. <TimeStamp>2014-07-23T12:08:00Z</TimeStamp>
  22. </DiskMonitorData>
  23. <DiskMonitorData>
  24. <BPSRead>0</BPSRead>
  25. <BPSTotal>819</BPSTotal>
  26. <BPSWrite>819</BPSWrite>
  27. <DiskId>d-23b3p4r8b</DiskId>
  28. <IOPSRead>0</IOPSRead>
  29. <IOPSTotal>0</IOPSTotal>
  30. <IOPSWrite>0</IOPSWrite>
  31. <TimeStamp>2014-07-23T12:09:00Z</TimeStamp>
  32. </DiskMonitorData>
  33. </MonitorData>
  34. <RequestId>BF666447-B171-4076-BCBA-48437C18FD76</RequestId>
  35. <TotalCount>3</TotalCount>
  36. </DescribeDiskMonitorDataResponse>

JSON 形式

  1. {
  2. "MonitorData": {
  3. "DiskMonitorData": [
  4. {
  5. "BPSRead": 0,
  6. "BPSTotal": 0,
  7. "BPSWrite": 0,
  8. "DiskId": "d-23b3p4r8b",
  9. "IOPSRead": 0,
  10. "IOPSTotal": 0,
  11. "IOPSWrite": 0,
  12. "TimeStamp": "2014-07-23T12:07:00Z"
  13. },
  14. {
  15. "BPSRead": 0,
  16. "BPSTotal": 204,
  17. "BPSWrite": 204,
  18. "DiskId": "d-23b3p4r8b",
  19. "IOPSRead": 0,
  20. "IOPSTotal": 0,
  21. "IOPSWrite": 0,
  22. "TimeStamp": "2014-07-23T12:08:00Z"
  23. },
  24. {
  25. "BPSRead": 0,
  26. "BPSTotal": 819,
  27. "BPSWrite": 819,
  28. "DiskId": "d-23b3p4r8b",
  29. "IOPSRead": 0,
  30. "IOPSTotal": 0,
  31. "IOPSWrite": 0,
  32. "TimeStamp": "2014-07-23T12:09:00Z"
  33. }
  34. ]
  35. },
  36. "RequestId": "A48A0A77-34F5-4C33-9066-9E8D2DA0D8E2",
  37. "TotalCount": 3
  38. }

エラーコード

次のエラーコードは、このインタフェースに固有のものです。その他のエラーコードについては、API エラーコードセンターをご参照ください。

エラーコード エラーメッセージ HTTP ステータスコード 意味
InvalidEndTime.Malformed The specified parameter “EndTime” is not valid. 400 指定された EndTime 形式が無効です。
InvalidParameter.TooManyDataQueried Too many data queried. 400 指定された (EndTime-StartTime) / Period の値は 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 形式が無効です。
Throttling You have made too many requests within a short time; your request is denied due to request throttling. 400 指定されたリクエストは処理できません。後からもう一度お試しください。
InvalidDiskId.NotFound The DiskId provided does not exist. 404 DiskId パラメーターは存在しません。