DescribeMetricLast - - Alibaba Cloud Dokümantasyon Merkezi

Operation description

Başlamadan önce

DescribeMetricLast, DescribeMetricList, DescribeMetricData ve DescribeMetricTop çağrıları, ayda 1.000.000 çağrılık birleşik bir ücretsiz kota paylaşır. Ücretsiz kota tükendikten sonra, CloudMonitor Basic kullandıkça öde faturalandırma yöntemini etkinleştirmediyseniz bu API'yi normal şekilde kullanamazsınız. CloudMonitor Basic kullandıkça öde faturalandırma yöntemini etkinleştirdiyseniz, ücretsiz kota tükendikten sonra API çalışmaya devam eder ve ücretsiz kotayı aşan kullanım otomatik olarak faturalandırılır. Kullandıkça öde faturalandırmayı etkinleştirme yöntemi için bkz. Kullandıkça öde faturalandırmayı etkinleştirme.
Tek bir API işlemi için hız sınırı saniyede 50 çağrıdır. Bu sınır, bir Alibaba Cloud hesabı ve hesap altındaki tüm Kaynak Erişim Yönetimi (RAM) kullanıcıları tarafından paylaşılır.

Not

Bir API işlemi çağırdığınızda, yanıt Throttling.User veya Request was denied due to user flow control içeriyorsa, API kısıtlanıyor demektir. Ele alma yöntemi için bkz. Sorgu API kısıtlamasını nasıl ele alırım.

Notlar

Bulut hizmeti izleme verilerinin depolama süresi Period (istatistiksel dönem) değerine bağlıdır. Daha büyük bir Period değeri, daha seyrek izleme verileri ve daha uzun bir depolama süresi ile sonuçlanır. İlişkiler aşağıdaki gibidir:

Period 60 saniyeden az ise depolama süresi 7 gündür.
Period 60 saniyeye eşit ise depolama süresi 31 gündür.
Period 300 saniyeden büyük veya eşit ise depolama süresi 91 gündür.

İşlem açıklaması

Bu konu, acs_ecs_dashboard bulut hizmeti için CPUUtilization metriğinin en son izleme verilerinin nasıl sorgulanacağına dair bir örnek sunar. Yanıt, 123456789876**** hesabı altındaki i-abcdefgh12**** örneği için 60 saniyelik aralıkta maksimum değerin 100, minimum değerin 93,1 ve ortalama değerin 99,52 olduğunu gösterir.

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:QueryMetricLast

get

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
Namespace	string	Yes	Bulut hizmetinin ad alanı. Bulut hizmetlerinin ad alanları hakkında bilgi için bkz. Bulut hizmeti izleme metrikleri.	acs_ecs_dashboard
MetricName	string	Yes	Bulut hizmetinin metrik adı. Metrik adları hakkında bilgi için bkz. Bulut hizmeti izleme metrikleri.	CPUUtilization
Period	string	No	İzleme verilerinin istatistiksel dönemi. Geçerli değerler: 15, 60, 900 ve 3600. Birim: saniye. Not İstatistiksel dönemi ayarlamazsanız, izleme verileri metrik kaydedildiğinde belirtilen raporlama dönemine göre sorgulanır. - İstatistiksel dönem her bulut hizmeti için metriğe (`MetricName`) göre değişir. Daha fazla bilgi için bkz. Bulut hizmeti izleme metrikleri sayfasındaki hedef bulut hizmetinin metrik listesi sayfasındaki `Min Periods` sütunu.	60
StartTime	string	No	Başlangıç zamanı. İki biçim desteklenir: 1. 1970-01-01 00:00:00 UTC tarihinden itibaren geçen milisaniye sayısını temsil eden milisaniye (ms) cinsinden bir UNIX zaman damgası dizesi. 2. UTC cinsinden YYYY-AA-GGThh:mm:ssZ ISO 8601 biçiminde bir zaman dizesi. Not Sorgu aralığı, sol hariç ve sağ dahil modunu kullanır. StartTime, EndTime değerine eşit veya ondan büyük olamaz ve aralarındaki aralık 31 günden az veya eşit olmalıdır.	2019-01-31 10:00:00
EndTime	string	No	Metriği sorgulamak için bitiş zamanı. Sistem, veri ayrıntı düzeyine göre sorgu başlangıç zamanını (sorgu penceresi boyutu) otomatik olarak sınırlar: Saniye düzeyinde veri: Maksimum sorgu aralığı 20 dakikadır (başlangıç zamanı = Max(startTime, EndTime - 20min)). Dakika düzeyinde veri: Maksimum sorgu aralığı 2 saattir (başlangıç zamanı = Max(startTime, EndTime - 2h)). Saat düzeyinde veri: Maksimum sorgu aralığı 2 gündür (başlangıç zamanı = Max(startTime, EndTime - 2d)). Not Belirtilen startTime sınırdan daha erken ise, sistem sınırı otomatik olarak gerçek sorgu başlangıç zamanı olarak kullanır.	2019-01-31 10:10:00
Dimensions	string	No	Belirtilen kaynağın izleme boyutları. Biçim: `anahtar:değer` çiftlerinden oluşan bir koleksiyon. Örnek: `{"userId":"120886317861**"}` veya `{"instanceId":"i-2ze2d6j5uhg20x47"}`. Not** Tek bir istekte en fazla 50 örnek sorgulanabilir.	[{"instanceId":"i-2ze2d6j5uhg20x47****"}]
NextToken	string	No	Sayfalandırma imleci. Filtre koşullarıyla eşleşen sorgu sonuçları sayfa boyutunu aşarsa bir sayfalandırma imleci döndürülür. Verilerin sonraki sayfasını almak için, tüm verilerin alındığını gösteren bir imleç değeri döndürülmeyene kadar döndürülen imleç değerini istek parametresi olarak kullanın.	15761432850009dd70bb64cff1f0fff6c0b08ffff073be5fb1e785e2b020f7fed9b5e137bd810a6d6cff5ae****
Length	string	No	İzleme verileri için sayfa başına giriş sayısı. Bu parametre sayfalandırılmış sorgu için kullanılır. Varsayılan değer: Sayfa başına 1000 izleme verisi girişini belirten 1000. Not Tek bir istekte Length parametresinin maksimum değeri 1440'tır.	1000
Express	string	No	Mevcut sorgu sonuçları üzerinde gerçek zamanlı hesaplama için ifade.	{"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.	xxxxxx
RequestId	string	İstek kimliği.	021472A6-25E3-4094-8D00-BA4B6A5486C3
Success	boolean	İşlemin başarılı olup olmadığını gösterir. Geçerli değerler: true: Başarılı. false: Başarısız.	true
Datapoints	string	İzleme verileri listesi.	[{"timestamp":1548777660000,"userId":"123456789876**","instanceId":"i-abcdefgh12**","Minimum":93.1,"Average":99.52,"Maximum":100}]
Code	string	Durum kodu. Not 200 değeri başarıyı gösterir.	200
Message	string	Hata mesajı.	The specified resource is not found.
Period	string	Zaman aralığı. Birim: saniye.	60

Examples

Success response

JSON format

{
  "NextToken": "xxxxxx",
  "RequestId": "021472A6-25E3-4094-8D00-BA4B6A5486C3",
  "Success": true,
  "Datapoints": "[{\"timestamp\":1548777660000,\"userId\":\"123456789876****\",\"instanceId\":\"i-abcdefgh12****\",\"Minimum\":93.1,\"Average\":99.52,\"Maximum\":100}]",
  "Code": "200",
  "Message": "The specified resource is not found.",
  "Period": "60"
}

Error codes

HTTP status code	Error code	Error message	Description
400	ParameterInvalid	Illegal parameters.
500	InternalError	The request processing has failed due to some unknown error.
403	AccessForbidden	User not authorized to operate on the specified resource.
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.