All Products
Search
Document Center

:CreateHostAvailability

Last Updated:May 27, 2026

Membuat task pemantauan ketersediaan.

Topik ini menjelaskan cara membuat task pemantauan ketersediaan task1 dalam kelompok aplikasi 123456. Parameter TaskType dari task tersebut diatur ke HTTP. Setelah task dijalankan, sistem akan mengirimkan peringatan melalui alamat email dan chatbot DingTalk yang telah ditentukan.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter permintaan

Parameter Type Required Contoh Deskripsi
Action String Yes CreateHostAvailability

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CreateHostAvailability.

GroupId Long Yes 123456

ID kelompok aplikasi.

TaskName String Yes task1

Nama task pemantauan ketersediaan. Nama harus terdiri dari 4 hingga 100 karakter, dan dapat berisi huruf, angka, serta garis bawah (_).

TaskScope String No GROUP

Rentang instans yang dipantau oleh task pemantauan ketersediaan. Nilai yang valid:

  • GROUP: Semua Instance ECS dalam kelompok aplikasi dipantau.
  • GROUP_SPEC_INSTANCE: Instance ECS tertentu dalam kelompok aplikasi dipantau. Parameter TaskScope harus digunakan bersama dengan parameter InstanceList.N. Parameter InstanceList.N menentukan Instance ECS yang akan dipantau.
TaskType String Yes HTTP

Jenis pemantauan dari task pemantauan ketersediaan. Nilai yang valid:

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

URI yang ingin Anda pantau. Jika parameter TaskType diatur ke HTTP, parameter ini wajib diisi.

TaskOption.TelnetOrPingHost String No www.aliyun.com

Nama domain atau alamat IP yang ingin Anda pantau.

Catatan Jika parameter TaskType diatur ke PING atau TELNET, parameter ini wajib diisi.
TaskOption.HttpResponseCharset String No UTF-8

Set karakter yang digunakan dalam respons HTTP.

Catatan Nilai yang valid: UTF-8.
TaskOption.HttpPostContent String No params1=paramsValue1

Konten permintaan HTTP POST.

TaskOption.HttpResponseMatchContent String No ok

Respons terhadap permintaan HTTP.

TaskOption.HttpMethod String No GET

Metode permintaan HTTP. Nilai yang valid:

  • GET
  • POST
  • HEAD
Catatan Jika parameter TaskType diatur ke HTTP, parameter ini wajib diisi.
TaskOption.HttpNegative Boolean No true

Metode untuk memicu peringatan. Peringatan dapat dipicu berdasarkan apakah aturan peringatan yang ditentukan termasuk dalam badan respons. Nilai yang valid:

  • true: Jika badan respons HTTP mencakup aturan peringatan, peringatan dipicu.
  • false: Jika respons HTTP tidak mencakup aturan peringatan, peringatan dipicu.
Catatan Jika parameter TaskType diatur ke HTTP, parameter ini berlaku.
TaskOption.HttpHeader String No token:testTokenValue

Header permintaan HTTP. Format: Nama parameter:Nilai parameter. Pisahkan beberapa parameter dengan karakter carriage return. Contoh:


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

Interval pengiriman permintaan deteksi. Satuan: detik. Nilai yang valid: 15, 30, 60, 120, 300, 900, 1800, dan 3600.

Catatan Parameter ini hanya tersedia untuk Agen CloudMonitor V3.5.1 atau versi yang lebih baru.
AlertConfig.NotifyType Integer Yes 0

Metode notifikasi peringatan. Nilai yang valid:

0: Notifikasi peringatan dikirim melalui email dan chatbot DingTalk.

AlertConfig.StartTime Integer No 0

Awal periode waktu saat aturan peringatan berlaku. Nilai yang valid: 0 hingga 23.

Sebagai contoh, jika parameter AlertConfig.StartTime diatur ke 0 dan parameter AlertConfig.EndTime diatur ke 22, aturan peringatan berlaku dari pukul 00:00:00 hingga 22:00:00.

Catatan Notifikasi peringatan hanya dikirim berdasarkan ambang batas yang ditentukan jika aturan peringatan sedang berlaku.
AlertConfig.EndTime Integer No 22

Akhir periode waktu saat aturan peringatan berlaku. Nilai yang valid: 0 hingga 23.

Sebagai contoh, jika parameter AlertConfig.StartTime diatur ke 0 dan parameter AlertConfig.EndTime diatur ke 22, aturan peringatan berlaku dari pukul 00:00:00 hingga 22:00:00.

Catatan Notifikasi peringatan hanya dikirim berdasarkan ambang batas yang ditentukan jika aturan peringatan sedang berlaku.
AlertConfig.SilenceTime Integer No 86400

Periode bisu selama notifikasi peringatan baru tidak dikirim meskipun kondisi pemicu terpenuhi. Satuan: detik. Nilai default: 86400. Nilai default ini setara dengan satu hari.

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

URL callback.

AlertConfigEscalationList.N.MetricName String Yes HttpStatus

Metrik yang diaktifkan fitur peringatannya. Nilai N yang valid: 1 hingga 21. Nilai yang valid:

  • HttpStatus: Kode status HTTP
  • HttpLatency: Waktu respons HTTP
  • TelnetStatus: Kode status Telnet
  • TelnetLatency: Waktu respons Telnet
  • PingLostRate: Tingkat kehilangan paket Ping
AlertConfigEscalationList.N.Value String No 90

Ambang batas peringatan. Nilai N yang valid: 1 hingga 21.

AlertConfigEscalationList.N.Times Integer No 3

Jumlah kali berturut-turut metrik memenuhi kondisi peringatan sebelum peringatan dipicu. Nilai N yang valid: 1 hingga 21.

AlertConfigEscalationList.N.Operator String No >

Operator perbandingan yang digunakan dalam aturan peringatan. Nilai N yang valid: 1 hingga 21. Nilai yang valid:

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

Metode yang digunakan untuk menghitung nilai metrik yang memicu peringatan. Nilai N yang valid: 1 hingga 21. Nilai yang valid:

  • HttpStatus: Value
  • HttpLatency: Average
  • TelnetStatus: Value
  • TelnetLatency: Average
  • PingLostRate: Average
Catatan Nilai Value menunjukkan nilai asli dan digunakan untuk metrik seperti kode status. Nilai Average menunjukkan nilai rata-rata dan digunakan untuk metrik seperti latensi dan tingkat kehilangan paket.
InstanceList.N String No 2

Instance ECS yang dipantau. Nilai N yang valid: 1 hingga 21.

Catatan Jika parameter TaskScope diatur ke GROUP_SPEC_INSTANCE, parameter ini wajib diisi.
AlertConfigTargetList.N.Id String No 1

ID sumber daya yang memicu peringatan.

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

Nama Sumber Daya Alibaba Cloud (ARN) dari sumber daya tersebut. Format: acs:{Singkatan nama layanan}:{regionId}:{userId}:/{Jenis sumber daya}/{Nama sumber daya}/message. Contoh: acs:mns:cn-hangzhou:120886317861****:/queues/test123/message. Kolom:

  • {Singkatan nama layanan}: Singkatan nama layanan. Nilai yang valid: mns.
  • {userId}: ID Akun Alibaba Cloud.
  • {regionId}: ID wilayah dari antrian pesan atau topik.
  • {Jenis sumber daya}: Jenis sumber daya yang memicu peringatan. Nilai yang valid: - **queues** - **topics** {Nama sumber daya}: Nama sumber daya. - Jika jenis sumber daya diatur ke **queues**, nama sumber daya adalah nama antrian pesan. - Jika jenis sumber daya diatur ke **topics**, nama sumber daya adalah nama topik.
AlertConfigTargetList.N.Level String No ["INFO", "WARN", "CRITICAL"]

Tingkat peringatan. Nilai yang valid:

  • INFO: informasi
  • WARN: peringatan
  • CRITICAL: kritis
AlertConfigTargetList.N.JsonParams String No {"customField1":"value1","customField2":"$.name"}

Parameter callback peringatan. Parameter dalam format JSON.

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

Parameter respons

Parameter Type Contoh Deskripsi
Code String 200

Kode status HTTP.

Catatan Kode status 200 menunjukkan bahwa pemanggilan berhasil.
Message String The specified resource is not found.

Pesan kesalahan.

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

ID permintaan.

TaskId Long 12345

ID task pemantauan ketersediaan.

Success Boolean true

Menunjukkan apakah pemanggilan berhasil. Nilai yang valid:

  • true: Pemanggilan berhasil.
  • false: Pemanggilan gagal.

Contoh

Permintaan contoh

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

Respons sukses contoh

Format XML

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>

Format JSON

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

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

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.