Tüm Ürünler
Search
Belge Merkezi

:DescribeHostAvailabilityList

Son Güncelleme:Oct 03, 2026

Kullanılabilirlik izleme görevlerini sorgular.

Bu konuda, Alibaba Cloud hesabınızdaki tüm kullanılabilirlik izleme görevlerinin nasıl sorgulanacağı gösterilmektedir. Örnek yanıtlar, hesabınızda ecs_instance adlı bir kullanılabilirlik izleme görevi olduğunu gösterir.

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 örnek kodları dinamik olarak oluşturur.

İstek parametreleri

Parametre

Tür

Gerekli

Örnek

Açıklama

Action

String

Evet

DescribeHostAvailabilityList

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

Id

Long

Hayır

123456

Kullanılabilirlik izleme görevinin ID'si.

Ids

String

Hayır

123456,345678

Kullanılabilirlik izleme görevlerinin ID'leri. Birden fazla ID'yi virgül (,) ile ayırın.

TaskName

String

Hayır

ecs_instance

Kullanılabilirlik izleme görevinin adı.

PageNumber

Integer

Hayır

1

Döndürülecek sayfa numarası.

Sayfalar 1'den başlar. Varsayılan değer: 1.

PageSize

Integer

Hayır

10

Her sayfada döndürülecek kayıt sayısı.

Varsayılan değer: 10.

GroupId

Long

Hayır

12345

Uygulama grubunun ID'si.

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

Yanıt parametreleri

Parametre Tür Örnek Açıklama
RequestId String 4A288E86-45C3-4858-9DB0-6D85B10BD92A

İsteğin ID'si.

Code String 200

HTTP durum kodu.

Not 200 değeri, çağrının başarılı olduğunu gösterir.
Success Boolean true

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

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

Kullanılabilirlik izleme görevlerinin ayrıntıları.

NodeTaskConfig
AlertConfig Struct

Uyarı kuralının yapılandırmaları.

EndTime Integer 22

Uyarı kuralının etkili 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 etkili olur.

Not Uyarı bildirimleri yalnızca uyarı kuralı etkiliyse belirtilen eşik değerine göre gönderilir.
EscalationList Array of escalationList

Uyarı kuralının tetikleme koşulları.

escalationList
Aggregate String Value

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

  • Value: HTTP durum kodunun değeri
  • Average: Ortalama HTTP yanıt süresi
  • Value: Telnet durum kodunun değeri
  • TelnetLatency: Ortalama Telnet yanıt süresi
  • Average: Ortalama Ping paket kayıp oranı
MetricName String HttpStatus

Ölçümün adı. 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 kayıp oranı
Operator String =

Uyarı kuralında kullanılan karşılaştırma operatörü. Geçerli değerler:

  • >
  • >=
  • <
  • <=
  • =
Times String 3

Bir uyarı tetiklenmeden önce ölçüm değerinin art arda ölçüldüğü ardışık sayı.

Value String 400

Uyarı eşiği.

NotifyType Integer 1

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

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

SilenceTime Integer 86400

Tetikleme koşulları karşılanmış olsa bile yeni uyarıların gönderilmediği sessiz süre. Birim: saniye. Varsayılan değer: 86400.

StartTime Integer 0

Uyarı kuralının etkili 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 etkili olur.

Not Uyarı bildirimleri yalnızca uyarı kuralı etkiliyse belirtilen eşik değerine göre gönderilir.
WebHook String https://www.aliyun.com

Geri arama URL'si.

CloudMonitor, bir HTTP POST isteği göndererek belirtilen geri arama URL'sine bir uyarı bildirimi iletir. Yalnızca HTTP protokolü desteklenir.

Disabled Boolean false

Kullanılabilirlik izleme görevinin devre dışı bırakılıp bırakılmadığını belirtir. Geçerli değerler:

  • true: Kullanılabilirlik izleme görevi devre dışı bırakıldı.
  • false: Kullanılabilirlik izleme görevi etkinleştirildi.
GroupId Long 12345

Uygulama grubunun ID'si.

GroupName String Group_ECS

Uygulama grubunun adı.

Id Long 123456

Kullanılabilirlik izleme görevinin ID'si.

Instances List i-abcdefgh12****

İzlenen ECS örnekleri.

TaskName String ecs_instance

Kullanılabilirlik izleme görevinin adı.

TaskOption Struct

Kullanılabilirlik izleme görevinin isteğe bağlı parametreleri.

HttpKeyword String OK

HTTP isteğine verilen yanıt.

HttpMethod String GET

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

  • GET
  • POST
  • HEAD
HttpNegative Boolean true

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

  • true: HTTP yanıt gövdesi uyarı kuralını içeriyorsa bir uyarı tetiklenir.
  • false: HTTP yanıtı uyarı kuralını içermiyorsa bir uyarı tetiklenir.
HttpPostContent String params1=paramsValue1

HTTP POST isteğinin içeriği.

HttpResponseCharset String UTF-8

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

HttpURI String https://www.aliyun.com

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

Interval Integer 60

Algılama isteklerinin gönderilme aralığı. Birim: saniye.

TelnetOrPingHost String ssh.aliyun.com

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

TaskScope String 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.
TaskType String HTTP

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

  • PING
  • TELNET
  • HTTP
Total Integer 1

Döndürülen toplam kayıt sayısı.

Message String The specified resource is not found.

Hata mesajı.

Örnekler

Örnek istekler

http(s)://[Endpoint]/?Action=DescribeHostAvailabilityList
&<Common request parameters>

Örnek başarılı yanıtlar

XML formatı

<DescribeHostAvailabilityListResponse>
	  <RequestId>4A288E86-45C3-4858-9DB0-6D85B10BD92A</RequestId>
	  <Total>1</Total>
	  <TaskList>
		    <NodeTaskConfig>
			      <GroupName>Group_ECS</GroupName>
			      <TaskOption>
				        <HttpURI>https://aliyun.com</HttpURI>
				        <HttpMethod>GET</HttpMethod>
			      </TaskOption>
			      <AlertConfig>
				        <NotifyType>1</NotifyType>
				        <SilenceTime>86400</SilenceTime>
				        <EndTime>22</EndTime>
				        <StartTime>0</StartTime>
				        <EscalationList>
					          <escalationList>
						            <Operator>=</Operator>
						            <MetricName>HttpStatus</MetricName>
						            <Times>3</Times>
						            <Value>400</Value>
						            <Aggregate>Value</Aggregate>
					          </escalationList>
					          <escalationList>
						            <Operator>=</Operator>
						            <MetricName>HttpLatency</MetricName>
						            <Times>3</Times>
						            <Value>500</Value>
						            <Aggregate>Average</Aggregate>
					          </escalationList>
				        </EscalationList>
			      </AlertConfig>
			      <TaskName>ecs_instance</TaskName>
			      <TaskScope>GROUP</TaskScope>
			      <TaskType>HTTP</TaskType>
			      <Id>123456</Id>
			      <Disabled>false</Disabled>
			      <GroupId>12345</GroupId>
		    </NodeTaskConfig>
	  </TaskList>
	  <Code>200</Code>
	  <Success>true</Success>
</DescribeHostAvailabilityListResponse>

JSON formatı

{
	"RequestId": "4A288E86-45C3-4858-9DB0-6D85B10BD92A",
	"Total": 1,
	"TaskList": {
		"NodeTaskConfig": [
			{
				"GroupName": "Group_ECS",
				"TaskOption": {
					"HttpURI": "https://aliyun.com",
					"HttpMethod": "GET"
				},
				"AlertConfig": {
					"NotifyType": 1,
					"SilenceTime": 86400,
					"EndTime": 22,
					"StartTime": 0,
					"EscalationList": {
						"escalationList": [
							{
								"Operator": "=",
								"MetricName": "HttpStatus",
								"Times": 3,
								"Value": "400",
								"Aggregate": "Value"
							},
							{
								"Operator": "=",
								"MetricName": "HttpLatency",
								"Times": 3,
								"Value": "500",
								"Aggregate": "Average"
							}
						]
					}
				},
				"TaskName": "ecs_instance",
				"TaskScope": "GROUP",
				"TaskType": "HTTP",
				"Id": 123456,
				"Disabled": false,
				"GroupId": 12345
			}
		]
	},
	"Code": 200,
	"Success": true
}

Hata kodları

HTTP durum kodu

Hata kodu

Hata mesajı

Açıklama

404

ResourceNotFound

The specified resource is not found.

Belirtilen kaynak bulunamadığı için döndürülen hata mesajı.

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