DescribeMetricList - - Alibaba Cloud Documentation Center

Mengambil data pemantauan suatu metrik untuk layanan cloud tertentu.

Batasan

Setiap operasi API dapat dipanggil hingga 50 kali per detik. Akun Alibaba Cloud dan Pengguna RAM dalam akun tersebut berbagi kuota yang sama.

Perhatian

Durasi penyimpanan data pemantauan setiap layanan cloud bergantung pada parameter Period (periode statistik). Semakin besar nilai parameter Period, semakin luas rentang waktu data pemantauan yang diambil dan semakin lama durasi penyimpanannya. Hubungan spesifiknya adalah sebagai berikut:

Jika nilai parameter Period kurang dari 60 detik, durasi penyimpanannya adalah tujuh hari.
Jika nilai parameter Period adalah 60 detik, durasi penyimpanannya adalah 31 hari.
Jika nilai parameter Period adalah 300 detik, durasi penyimpanannya adalah 91 hari.

Catatan penggunaan

Topik ini memberikan contoh cara mengambil data pemantauan metrik cpu_idle untuk Elastic Compute Service (ECS). Namespace ECS adalah acs_ecs_dashboard. Hasil yang dikembalikan menunjukkan bahwa data pemantauan untuk instans i-abcdefgh12**** dari akun 120886317861**** diambil dengan interval 60 detik. Nilai maksimum, minimum, dan rata-rata metrik tersebut masing-masing adalah 100, 93,1, dan 99,52.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kemudahan 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	Tipe	Wajib	Contoh	Deskripsi
Action	String	Ya	DescribeMetricList	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeMetricList.
Namespace	String	Ya	acs_ecs_dashboard	Namespace layanan cloud. Untuk informasi selengkapnya tentang namespace layanan cloud, lihat Lampiran 1: Metrik.
MetricName	String	Ya	cpu_idle	Metrik yang digunakan untuk memantau layanan cloud. Untuk informasi selengkapnya tentang nama metrik, lihat Lampiran 1: Metrik.
Period	String	Tidak	60	Periode statistik data pemantauan. Nilai yang valid: 15, 60, 900, dan 3600. Unit: detik. Catatan Jika parameter ini tidak ditentukan, data pemantauan ditanyakan berdasarkan periode pelaporan nilai metrik. Periode statistik bervariasi tergantung pada metrik yang ditentukan oleh `MetricName`. Untuk informasi selengkapnya, lihat Lampiran 1: Metrik.
StartTime	String	Tidak	2019-01-30 00:00:00	Awal rentang waktu yang akan ditanyakan. Format berikut didukung: Stempel waktu UNIX: jumlah milidetik sejak pukul 00:00:00 Kamis, 1 Januari 1970 Format waktu: YYYY-MM-DDThh:mm:ssZ Catatan Periode yang ditentukan mencakup waktu akhir dan tidak mencakup waktu mulai. Waktu mulai harus lebih awal daripada waktu akhir. Interval antara waktu mulai dan waktu akhir kurang dari atau sama dengan 31 hari.
EndTime	String	Tidak	2019-01-30 00:10:00	Akhir rentang waktu yang akan ditanyakan. Format berikut didukung: Stempel waktu UNIX: jumlah milidetik sejak pukul 00:00:00 Kamis, 1 Januari 1970 Format waktu: YYYY-MM-DDThh:mm:ssZ Catatan Interval antara waktu mulai dan waktu akhir kurang dari atau sama dengan 31 hari.
Dimensions	String	Tidak	[{"instanceId":"i-2ze2d6j5uhg20x47****"}]	Dimensi pemantauan resource yang ditentukan. Tetapkan nilainya ke kumpulan pasangan `key:value`. Contoh: `{"userId":"120886317861**"}` atau `{"instanceId":"i-2ze2d6j5uhg20x47"}`. Catatan** Anda dapat menanyakan maksimal 50 instans dalam satu permintaan.
NextToken	String	Tidak	15761485350009dd70bb64cff1f0fff750b08ffff073be5fb1e785e2b020f1a949d5ea14aea7fed82f01dd8****	Token paginasi. Catatan Jika parameter ini tidak ditentukan, data pada halaman pertama dikembalikan. Nilai kembali selain Null menunjukkan bahwa belum semua entri dikembalikan. Anda dapat menggunakan nilai ini sebagai parameter input untuk mendapatkan entri pada halaman berikutnya. Nilai Null menunjukkan bahwa semua hasil kueri telah dikembalikan.
Length	String	Tidak	1000	Jumlah entri per halaman. Catatan Nilai maksimum parameter Length dalam satu permintaan adalah 1440.
Express	String	Tidak	{"groupby":["userId","instanceId"]}	Ekspresi yang digunakan untuk menghitung hasil kueri secara real time. Catatan Hanya ekspresi groupby yang didukung. Ekspresi ini mirip dengan pernyataan GROUP BY yang digunakan dalam database.

Untuk informasi selengkapnya tentang parameter permintaan umum, lihat Parameter umum.

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
NextToken	String	15761441850009dd70bb64cff1f0fff6d0b08ffff073be5fb1e785e2b020f7fed9b5e137bd810a6d6cff5ae****	Token paginasi.
RequestId	String	3121AE7D-4AFF-4C25-8F1D-C8226EBB1F42	ID permintaan.
Success	Boolean	true	Menunjukkan apakah permintaan berhasil. Nilai yang valid: true false
Datapoints	String	[{"timestamp":1548777660000,"userId":"120886317861****","instanceId":"i-abc","Minimum":9.92,"Average":9.92,"Maximum":9.92}]	Data pemantauan.
Code	String	200	Kode status. Catatan Kode status 200 menunjukkan bahwa permintaan berhasil.
Message	String	The specified resource is not found.	Pesan kesalahan.
Period	String	60	Interval waktu. Unit: detik. Nilai yang valid: 60, 300, dan 900.

Contoh

Contoh permintaan

http(s)://[Endpoint]/?Action=DescribeMetricList
&MetricName=cpu_idle
&Namespace=acs_ecs_dashboard
&<Common request parameters>

Contoh respons sukses

XML format

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

<DescribeMetricListResponse>
	<Period>60</Period>
	<Datapoints>
		<timestamp>1490152860000</timestamp>
		<Maximum>100</Maximum>
		<userId>120886317861****</userId>
		<Minimum>93.1</Minimum>
		<instanceId>i-abcdefgh12****</instanceId>
		<Average>99.52</Average>
	</Datapoints>
	<RequestId>6A5F022D-AC7C-460E-94AE-B9E75083D027</RequestId>
	<Success>true</Success>
	<Code>200</Code>
</DescribeMetricListResponse>

JSON format

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

{
  "Period" : "60",
  "Datapoints" : [ {
    "timestamp" : 1490152860000,
    "Maximum" : 100,
    "userId" : "120886317861****",
    "Minimum" : 93.1,
    "instanceId" : "i-abcdefgh12****",
    "Average" : 99.52
  } ],
  "RequestId" : "6A5F022D-AC7C-460E-94AE-B9E75083D027",
  "Success" : true,
  "Code" : "200"
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
404	ResourceNotFound	The specified resource is not found.	Resource yang ditentukan tidak ditemukan.

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.