Tüm Ürünler
Search
Belge Merkezi

:CreateHostAvailability

Son Güncelleme:Oct 03, 2026

Bir kullanılabilirlik izleme görevi oluşturur.

Bu konu, 123456 uygulama grubunda task1 adlı kullanılabilirlik izleme görevinin nasıl oluşturulacağını açıklar. Görevin TaskType parametresi HTTP olarak ayarlanır. Görevi başlattığınızda sistem, belirtilen e-posta adresi ve DingTalk sohbet botu aracılığıyla size uyarılar gönderir.

Hata Ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlem örnek kodlarını dinamik olarak oluşturur.

İstek parametreleri

Parameter Type Required Example Description
Action String Yes CreateHostAvailability

Gerçekleştirmek istediğiniz işlem. Değeri CreateHostAvailability olarak ayarlayın.

GroupId Long Yes 123456

Uygulama grubunun ID'si.

TaskName String Yes task1

Kullanılabilirlik izleme görevinin adı. Ad 4 ila 100 karakter uzunluğunda olmalı ve harf, rakam ile alt çizgi (_) içerebilir.

TaskScope String No GROUP

Kullanılabilirlik izleme görevi tarafından izlenen örneklerin kapsamı. Geçerli değerler:

  • GROUP: Uygulama grubundaki tüm ECS örnekleri izlenir.
  • GROUP_SPEC_INSTANCE: Uygulama grubundaki belirtilen ECS örnekleri izlenir. TaskScope parametresi InstanceList.N parametresi ile birlikte kullanılmalıdır. InstanceList.N parametresi izlenecek ECS örneklerini belirtir.
TaskType String Yes HTTP

Kullanılabilirlik izleme görevinin izleme türü. Geçerli değerler:

  • PING
  • TELNET
  • HTTP
TaskOption.HttpURI String No https://www.aliyun.com

İzlemek istediğiniz URI. TaskType parametresi HTTP olarak ayarlanırsa bu parametre zorunludur.

TaskOption.TelnetOrPingHost String No www.aliyun.com

İzlemek istediğiniz alan adı veya IP adresi.

Not TaskType parametresi PING veya TELNET olarak ayarlanırsa bu parametre zorunludur.
TaskOption.HttpResponseCharset String No UTF-8

HTTP yanıtında kullanılan karakter kümesi.

Not Geçerli değer: UTF-8.
TaskOption.HttpPostContent String No params1=paramsValue1

HTTP POST isteğinin içeriği.

TaskOption.HttpResponseMatchContent String No ok

HTTP isteğine verilen yanıt.

TaskOption.HttpMethod String No GET

HTTP istek yöntemi. Geçerli değerler:

  • GET
  • POST
  • HEAD
Not TaskType parametresi HTTP olarak ayarlanırsa bu parametre zorunludur.
TaskOption.HttpNegative Boolean No true

Uyarı tetikleme yöntemi. Uyarı, belirtilen uyarı kuralının yanıt gövdesinde bulunup bulunmadığına göre tetiklenebilir. Geçerli değerler:

  • true: HTTP yanıt gövdesi uyarı kuralını içeriyorsa uyarı tetiklenir.
  • false: HTTP yanıtı uyarı kuralını içermiyorsa uyarı tetiklenir.
Not TaskType parametresi HTTP olarak ayarlanırsa bu parametre etkili olur.
TaskOption.HttpHeader String No token:testTokenValue

HTTP isteğinin üstbilgisi. Biçim: Parametre adı:Parametre değeri. Birden fazla parametreyi satır sonu karakterleriyle ayırın. Örnek:


params1:value1
params2:value2
TaskOption.Interval Integer No 60

Algılama isteklerinin gönderilme aralığı. Birim: saniye. Geçerli değerler: 15, 30, 60, 120, 300, 900, 1800 ve 3600.

Not Bu parametre yalnızca CloudMonitor agent V3.5.1 veya sonraki sürümler için kullanılabilir.
AlertConfig.NotifyType Integer Yes 0

Uyarı bildirim yöntemleri. Geçerli değerler:

0: Uyarı bildirimleri e-postalar ve DingTalk sohbet botları kullanılarak gönderilir.

AlertConfig.StartTime Integer No 0

Uyarı kuralının geçerli olduğu zaman aralığının başlangıcı. Geçerli değerler: 0 ila 23.

Örneğin, AlertConfig.StartTime parametresi 0 ve AlertConfig.EndTime parametresi 22 olarak ayarlanırsa uyarı kuralı 00:00:00 ile 22:00:00 arasında geçerli olur.

Not Uyarı kuralı yalnızca geçerli olduğunda belirtilen eşik değerine göre uyarı bildirimleri gönderilir.
AlertConfig.EndTime Integer No 22

Uyarı kuralının geçerli olduğu zaman aralığının bitişi. Geçerli değerler: 0 ila 23.

Örneğin, AlertConfig.StartTime parametresi 0 ve AlertConfig.EndTime parametresi 22 olarak ayarlanırsa uyarı kuralı 00:00:00 ile 22:00:00 arasında geçerli olur.

Not Uyarı kuralı yalnızca geçerli olduğunda belirtilen eşik değerine göre uyarı bildirimleri gönderilir.
AlertConfig.SilenceTime Integer No 86400

Tetikleme koşulları karşılanmasına rağmen yeni uyarıların gönderilmediği sessiz kalma süresi. Birim: saniye. Varsayılan değer: 86400. Varsayılan değer bir günü ifade eder.

AlertConfig.WebHook String No https://www.aliyun.com/webhook.json

Geri arama URL'si.

AlertConfigEscalationList.N.MetricName String Yes HttpStatus

Uyarı özelliğinin etkinleştirildiği ölçüm. N için geçerli değerler: 1 ila 21. Geçerli değerler:

  • HttpStatus: HTTP durum kodu
  • HttpLatency: HTTP yanıt süresi
  • TelnetStatus: Telnet durum kodu
  • TelnetLatency: Telnet yanıt süresi
  • PingLostRate: Ping paket kaybı oranı
AlertConfigEscalationList.N.Value String No 90

Uyarı eşiği. N için geçerli değerler: 1 ila 21.

AlertConfigEscalationList.N.Times Integer No 3

Bir uyarı tetiklenmeden önce ölçüm değerinin uyarı koşulunu art arda kaç kez karşılaması gerektiği. N için geçerli değerler: 1 ila 21.

AlertConfigEscalationList.N.Operator String No >

Uyarı kuralında kullanılan karşılaştırma operatörü. N için geçerli değerler: 1 ila 21. Geçerli değerler:

  • >
  • >=
  • <
  • <=
  • =
AlertConfigEscalationList.N.Aggregate String No Value

Uyarıları tetikleyen ölçüm değerlerini hesaplamak için kullanılan yöntem. N için geçerli değerler: 1 ila 21. Geçerli değerler:

  • HttpStatus: Value
  • HttpLatency: Average
  • TelnetStatus: Value
  • TelnetLatency: Average
  • PingLostRate: Average
Not Value değeri orijinal değeri ifade eder ve durum kodları gibi ölçümler için kullanılır. Average değeri ortalama değeri ifade eder ve gecikme süresi ile paket kaybı oranı gibi ölçümler için kullanılır.
InstanceList.N String No 2

İzlenen ECS örnekleri. N için geçerli değerler: 1 ila 21.

Not TaskScope parametresi GROUP_SPEC_INSTANCE olarak ayarlanırsa bu parametre zorunludur.
AlertConfigTargetList.N.Id String No 1

Uyarıların tetiklendiği kaynağın ID'si.

AlertConfigTargetList.N.Arn String No acs:mns:cn-hangzhou:120886317861****:/queues/test/message

Kaynağın Alibaba Cloud Resource Name (ARN) bilgisi. Biçim: acs:{Hizmet adı kısaltması}:{bölgeId}:{kullanıcıId}:/{Kaynak türü}/{Kaynak adı}/message. Örnek: acs:mns:cn-hangzhou:120886317861****:/queues/test123/message. Alanlar:

  • {Hizmet adı kısaltması}: Hizmet adının kısaltması. Geçerli değer: mns.
  • {userId}: Alibaba Cloud hesabının ID'si.
  • {regionId}: Mesaj kuyruğunun veya konusunun bölge ID'si.
  • {Resource type}: Uyarıların tetiklendiği kaynağın türü. Geçerli değerler: - **queues** - **topics** {Resource name}: Kaynağın adı. - Kaynak türü **queues** olarak ayarlanırsa kaynak adı mesaj kuyruğunun adıdır. - Kaynak türü **topics** olarak ayarlanırsa kaynak adı konunun adıdır.
AlertConfigTargetList.N.Level String No ["INFO", "WARN", "CRITICAL"]

Uyarının düzeyi. Geçerli değerler:

  • INFO: bilgi
  • WARN: uyarı
  • CRITICAL: kritik
AlertConfigTargetList.N.JsonParams String No {"customField1":"value1","customField2":"$.name"}

Uyarı geri arama parametreleri. Parametreler JSON biçimindedir.

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

Yanıt parametreleri

Parameter Type Example Description
Code String 200

HTTP durum kodu.

Not 200 durum kodu çağrının başarılı olduğunu gösterir.
Message String The specified resource is not found.

Hata mesajı.

RequestId String ACBDBB40-DFB6-4F4C-8957-51FFB233969C

İsteğin ID'si.

TaskId Long 12345

Kullanılabilirlik izleme görevinin ID'si.

Success Boolean true

Çağrının başarılı olup olmadığını gösterir. Geçerli değerler:

  • true: Çağrı başarılı oldu.
  • false: Çağrı başarısız oldu.

Örnekler

Örnek istekler

http(s)://[Endpoint]/?Action=CreateHostAvailability
&AlertConfig.NotifyType=0
&AlertConfigEscalationList.1.MetricName=HttpStatus
&GroupId=123456
&TaskName=task1
&TaskType=HTTP
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

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

<CreateHostAvailabilityResponse>
	<TaskId>12345</TaskId>
	<RequestId>CDA78493-F10F-485F-98AD-B4C0B40AB225</RequestId>
	<Code>200</Code>
	<Success>true</Success>
</CreateHostAvailabilityResponse>

JSON biçimi

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

{
  "TaskId" : "12345",
  "RequestId" : "CDA78493-F10F-485F-98AD-B4C0B40AB225",
  "Code" : 200,
  "Success" : true
}

Hata kodları

Hata kodlarının listesi için API Hata Merkezi adresini ziyaret edin.