DescribeDiskMonitorData - - Alibaba Cloud Documentation Center

Mengambil data pemantauan sebuah disk dalam periode waktu tertentu.

Catatan penggunaan

Data pemantauan mencakup IOPS baca, IOPS tulis, bandwidth baca (byte/detik), bandwidth tulis (byte/detik), latensi baca (μs), dan latensi tulis (μs) dari disk tersebut.

Perhatikan hal-hal berikut:

Anda hanya dapat mengambil data pemantauan untuk disk yang berada dalam status In Use (In_Use). Untuk informasi selengkapnya, lihat Disk states.
Catatan Beberapa informasi mungkin tidak tersedia dalam data pemantauan disk karena disk tidak berada dalam status In Use (In_Use), sehingga sistem tidak dapat memperoleh informasi terkait.
Maksimal 400 entri data pemantauan dapat dikembalikan dalam satu permintaan. Kesalahan akan dikembalikan jika nilai yang dihitung berdasarkan rumus berikut melebihi 400: (EndTime - StartTime)/Period.
Anda dapat mengambil data pemantauan hingga 30 hari ke belakang. Jika nilai StartTime lebih dari 30 hari sebelum waktu saat ini, kesalahan akan dikembalikan.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeDiskMonitorData	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeDiskMonitorData.
DiskId	String	Yes	d-bp1bq5g3dxxo1x4o****	ID disk.
StartTime	String	Yes	2014-07-23T12:07:00Z	Awal rentang waktu untuk ditanyakan. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC. Jika nilai detik (ss) bukan 00, waktu akan dibulatkan ke menit berikutnya.
EndTime	String	Yes	2014-07-23T12:09:00Z	Akhir rentang waktu untuk ditanyakan. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC. Jika nilai detik (ss) bukan 00, waktu akan dibulatkan ke menit berikutnya.
Period	Integer	No	60	Interval pengambilan data pemantauan. Satuan: detik. Nilai yang valid: 60 600 3600 Nilai default: 60.

Parameter respons

Parameter	Type	Example	Description
TotalCount	Integer	3	Jumlah total entri data pemantauan yang dikembalikan.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.
MonitorData	Array of DiskMonitorData		Data pemantauan disk.
DiskMonitorData
BPSRead	Integer	0	Bandwidth baca dari sistem disk. Satuan: byte/detik.
IOPSRead	Integer	0	Jumlah IOPS baca pada sistem disk.
LatencyRead	Integer	0	Latensi baca dari disk. Satuan: μs.
BPSTotal	Integer	204	Total bandwidth baca dan tulis dari sistem disk. Satuan: byte/detik.
IOPSTotal	Integer	0	Jumlah total IOPS baca dan tulis pada sistem disk.
TimeStamp	String	2014-07-23T12:07:00Z	Timestamp data yang dipantau. Waktu mengikuti standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
LatencyWrite	Integer	0	Latensi tulis dari disk. Satuan: μs.
IOPSWrite	Integer	0	Jumlah IOPS tulis pada sistem disk.
DiskId	String	d-bp1bq5g3dxxo1x4o****	ID disk.
BPSWrite	Integer	204	Bandwidth tulis dari sistem disk. Satuan: byte/detik.

Contoh

Contoh permintaan

https://ecs.aliyuncs.com/?Action=DescribeDiskMonitorData
&DiskId=d-bp1bq5g3dxxo1x4o****
&EndTime=2014-07-23T12:09:00Z
&StartTime=2014-07-23T12:07:00Z
&Period=60
&<Common request parameters>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDiskMonitorDataResponse>
        <MonitorData>
                <DiskMonitorData>
                        <BPSRead>0</BPSRead>
                        <BPSTotal>0</BPSTotal>
                        <BPSWrite>0</BPSWrite>
                        <DiskId>d-bp1bq5g3dxxo1x4o****</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-bp1bq5g3dxxo1x4o****</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-bp1bq5g3dxxo1x4o****</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 format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "MonitorData" : {
    "DiskMonitorData" : [ {
      "BPSRead" : 0,
      "BPSTotal" : 0,
      "BPSWrite" : 0,
      "DiskId" : "d-bp1bq5g3dxxo1x4o****",
      "IOPSRead" : 0,
      "IOPSTotal" : 0,
      "IOPSWrite" : 0,
      "TimeStamp" : "2014-07-23T12:07:00Z"
    }, {
      "BPSRead" : 0,
      "BPSTotal" : 204,
      "BPSWrite" : 204,
      "DiskId" : "d-bp1bq5g3dxxo1x4o****",
      "IOPSRead" : 0,
      "IOPSTotal" : 0,
      "IOPSWrite" : 0,
      "TimeStamp" : "2014-07-23T12:08:00Z"
    }, {
      "BPSRead" : 0,
      "BPSTotal" : 819,
      "BPSWrite" : 819,
      "DiskId" : "d-bp1bq5g3dxxo1x4o****",
      "IOPSRead" : 0,
      "IOPSTotal" : 0,
      "IOPSWrite" : 0,
      "TimeStamp" : "2014-07-23T12:09:00Z"
    } ]
  },
  "RequestId" : "A48A0A77-34F5-4C33-9066-9E8D2DA0D8E2",
  "TotalCount" : 3
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	InvalidEndTime.Malformed	The specified parameter "EndTime" is not valid.	Nilai EndTime tidak valid.
400	InvalidParameter.TooManyDataQueried	Too many data queried.	Jumlah maksimum data pemantauan yang dapat ditanyakan telah terlampaui.
400	Throttling	Request was denied due to request throttling.	Permintaan ditolak karena pembatasan kecepatan.
400	InvalidInstanceType.NotSupportCredit	The InstanceType of the specified instance does not support credit.	Tipe instans tidak mendukung instans burstable.
400	InvalidParameter.EndTime	The specified parameter EndTime is earlier than StartTime.	Waktu akhir yang ditentukan lebih awal daripada waktu mulai yang ditentukan.
404	InvalidDiskId.NotFound	The DiskId provided does not exist in our records.	Disk yang ditentukan tidak ditemukan. Periksa apakah ID disk valid.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Terjadi kesalahan internal. Coba lagi nanti.

Untuk daftar kode kesalahan lengkap, lihat Service error codes.