DescribeDiskMonitorData - - Alibaba Cloud ドキュメントセンター

指定したディスクの監視データを照会します。監視データには、測定された読み取り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 で構成される集合。

例

リクエストの例

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

レスポンスの例

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 エラーコードセンターをご参照ください。


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` パラメーターは存在しません。