DescribeMetricList - - Alibaba Cloud Dokümantasyon Merkezi

Operation description

Sınırlamalar

DescribeMetricLast, DescribeMetricList, DescribeMetricData ve DescribeMetricTop işlemleri için aylık toplam 1 milyon API çağrısı ücretsiz kotanız bulunmaktadır. Ücretsiz kotayı tüketirseniz ve CloudMonitor Basic için kullandıkça öde faturalandırma yöntemini etkinleştirmediyseniz, bu API işlemlerini artık kullanamazsınız. Kullandıkça öde faturalandırma yöntemini etkinleştirdiyseniz, ücretsiz kota tükendikten sonra da API işlemlerini kullanmaya devam edebilirsiniz. Ücretsiz kotayı aşan API çağrıları otomatik olarak kullandıkça öde esasına göre ücretlendirilir. Daha fazla bilgi için bkz. Kullandıkça ödeyi etkinleştirme.
Her API işlemini saniyede en fazla 50 kez çağırabilirsiniz. Bu sınır, bir Alibaba Cloud hesabı ve onun RAM kullanıcıları arasında paylaşılır.

Not

Bir API işlemini çağırdığınızda Throttling.User veya Request was denied due to user flow control hata mesajını alırsanız, API çağrısı kısıtlanmış demektir. Daha fazla bilgi için bkz. API çağrısı kısıtlama sorununu nasıl çözerim?.

Notlar

Bir bulut hizmetine ait izleme verilerinin saklama süresi, Period (istatistiksel dönem) değerine bağlıdır. Daha büyük bir Period değeri, izleme verilerinin daha az ayrıntılı olduğunu ve daha uzun bir süre saklandığını gösterir. İlişki aşağıdaki gibidir:

Period değeri 60 saniyeden az ise saklama süresi 7 gündür.
Period değeri 60 saniye ise saklama süresi 31 gündür.
Period değeri 300 saniye veya daha fazla ise saklama süresi 91 gündür.

Kullanım notları

Bu konu, acs_ecs_dashboard bulut hizmeti için cpu_idle metriğinin izleme verilerinin nasıl sorgulanacağına dair bir örnek sunmaktadır. Yanıt, 120886317861**** Alibaba Cloud hesabına ait olan i-abcdefgh12**** örneğinin verilerini göstermektedir. 60 saniyelik aralıkta, metriğin maksimum, minimum ve ortalama değerleri sırasıyla 100, 93,1 ve 99,52'dir.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

cms:QueryMetricList

get

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
Namespace	string	Yes	Bulut hizmetinin ad alanı. Daha fazla bilgi için bkz. Metrikler.	acs_ecs_dashboard
MetricName	string	Yes	Metriğin adı. Daha fazla bilgi için bkz. Metrikler.	cpu_idle
Period	string	No	İzleme verilerinin istatistiksel dönemi. Geçerli değerler: 15, 60, 900 ve 3600. Birim: saniye. Not Bu parametreyi ayarlamazsanız, metrik kaydedildiğinde belirtilen raporlama dönemi kullanılır. Bir bulut hizmetinin her metriğinin (`MetricName`) istatistiksel dönemi farklıdır. Daha fazla bilgi için bkz. Metrikler.	60
StartTime	string	No	Sorgulanacak zaman aralığının başlangıcı. Aşağıdaki biçimler desteklenir: UNIX zaman damgası: 1 Ocak 1970 00:00:00 UTC'den bu yana geçen milisaniye sayısı. Biçim: YYYY-AA-GG ss:dd:ss. Not Zaman aralığı soldan açık ve sağdan kapalı bir aralıktır. `StartTime` değeri, `EndTime` değerinden önceki bir zaman olmalıdır. `StartTime` ve `EndTime` arasındaki aralık 31 günden az veya ona eşit olmalıdır.	2019-01-30 00:00:00
EndTime	string	No	Sorgulanacak zaman aralığının sonu. Aşağıdaki biçimler desteklenir: UNIX zaman damgası: 1 Ocak 1970 00:00:00 UTC'den bu yana geçen milisaniye sayısı. Biçim: YYYY-AA-GG ss:dd:ss. Not `StartTime` ve `EndTime` arasındaki aralık 31 günden az veya ona eşit olmalıdır.	2019-01-30 00:10:00
Dimensions	string	No	İzlenecek kaynakları belirten boyutlar. Biçim: `{"userId":"120886317861**"}` ve `{"instanceId":"i-2ze2d6j5uhg20x47"}` gibi anahtar-değer çiftlerinden oluşan bir koleksiyon. Not** Tek bir istek ile en fazla 50 örnek sorgulanabilir.	[{"instanceId":"i-2ze2d6j5uhg20x47****"}]
NextToken	string	No	Sayfalandırma imleci. Not Bu parametreyi ayarlamazsanız, verilerin ilk sayfası döndürülür. Bu parametre için bir değer döndürülürse, daha fazla veri mevcut olduğu anlamına gelir. Sonraki sayfayı almak için, döndürülen değeri bir sonraki isteğinizde `NextToken` olarak kullanın. Null değer, tüm verilerin alındığını gösterir.	15761485350009dd70bb64cff1f0fff750b08ffff073be5fb1e785e2b020f1a949d5ea14aea7fed82f01dd8****
Length	string	No	Sayfalanmış bir sorgu için her sayfada döndürülecek giriş sayısı. Not Tek bir istekte `Length` parametresinin maksimum değeri 1440'tır.	1000
Express	string	No	Sorgu sonuçlarına dayalı olarak gerçek zamanlı hesaplama için kullanılan ifade. Not Yalnızca groupby ifadesi desteklenir. Bu ifade, veritabanlarındaki GROUP BY ifadesine benzer.	{"groupby":["userId","instanceId"]}

Ortak istek parametreleri hakkında daha fazla bilgi için bkz. Ortak parametreler.

Response elements

Element	Type	Description	Example
	object
NextToken	string	Sayfalandırma imleci.	15761441850009dd70bb64cff1f0fff6d0b08ffff073be5fb1e785e2b020f7fed9b5e137bd810a6d6cff5ae****
RequestId	string	İstek kimliği.	3121AE7D-4AFF-4C25-8F1D-C8226EBB1F42
Success	boolean	İşlemin başarılı olup olmadığını gösterir. Geçerli değerler: true: İşlem başarılı. false: İşlem başarısız.	true
Datapoints	string	İzleme verilerinin listesi.	[{"timestamp":1548777660000,"userId":"120886317861****","instanceId":"i-abc","Minimum":9.92,"Average":9.92,"Maximum":9.92}]
Code	string	Durum kodu. Not 200 değeri, çağrının başarılı olduğunu gösterir.	200
Message	string	Hata mesajı.	The specified resource is not found.
Period	string	İstatistiksel dönem. Birim: saniye. Geçerli değerler: 60, 300 ve 900.	60

Examples

Success response

JSON format

{
  "NextToken": "15761441850009dd70bb64cff1f0fff6d0b08ffff073be5fb1e785e2b020f7fed9b5e137bd810a6d6cff5ae****",
  "RequestId": "3121AE7D-4AFF-4C25-8F1D-C8226EBB1F42",
  "Success": true,
  "Datapoints": "[{\"timestamp\":1548777660000,\"userId\":\"120886317861****\",\"instanceId\":\"i-abc\",\"Minimum\":9.92,\"Average\":9.92,\"Maximum\":9.92}]",
  "Code": "200",
  "Message": "The specified resource is not found.",
  "Period": "60"
}

Error codes

HTTP status code	Error code	Error message	Description
400	%s	%s
500	InternalError	The request processing has failed due to some unknown error.
403	%s	%s
404	ResourceNotFound	The specified resource is not found.	The specified resource is not found.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.