Memodifikasi task pemantauan ketersediaan.
Topik ini menjelaskan cara mengubah nama task pemantauan ketersediaan 12345 dalam kelompok aplikasi 123456 menjadi task2.
Debugging
Parameter permintaan
| Parameter | Type | Wajib | Contoh | Deskripsi |
| Action | String | Yes | ModifyHostAvailability | Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyHostAvailability. |
| GroupId | Long | Yes | 123456 | ID kelompok aplikasi. |
| Id | Long | Yes | 12345 | ID task pemantauan ketersediaan. |
| TaskName | String | Yes | task2 | Nama task pemantauan ketersediaan. |
| TaskScope | String | No | GROUP | Rentang instans yang dipantau oleh task pemantauan ketersediaan. Nilai yang valid:
|
| 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. Untuk informasi lebih lanjut tentang cara mengatur parameter TaskType, lihat CreateHostAvailability. |
| TaskOption.HttpResponseCharset | String | No | UTF-8 | Set karakter yang digunakan dalam respons HTTP. Catatan Nilai yang valid: UTF-8. |
| TaskOption.HttpPostContent | String | No | params1=value1 | Konten permintaan HTTP POST. |
| TaskOption.HttpResponseMatchContent | String | No | ok | Tanggapan terhadap permintaan HTTP. |
| TaskOption.HttpMethod | String | No | GET | Metode permintaan HTTP. Nilai yang valid:
Catatan Jika parameter TaskType diatur ke HTTP, parameter ini wajib diisi. Untuk informasi lebih lanjut tentang cara mengatur parameter TaskType, lihat CreateHostAvailability. |
| 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:
Catatan Jika parameter TaskType diatur ke HTTP, parameter ini wajib diisi. Untuk informasi lebih lanjut tentang cara mengatur parameter TaskType, lihat CreateHostAvailability. |
| TaskOption.HttpHeader | String | No | params1:value1 | Header permintaan HTTP. Format:
|
| 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 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. Misalnya, jika parameter 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. Misalnya, jika parameter 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:
|
| AlertConfigEscalationList.N.Value | String | No | 3 | Ambang batas peringatan. Nilai N yang valid: 1 hingga 21. |
| AlertConfigEscalationList.N.Times | Integer | No | 3 | Jumlah kali berturut-turut nilai 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 parameter ini bervariasi tergantung pada metrik. Poin-poin berikut menjelaskan korespondensi antara metrik dan metode perhitungan:
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 resource yang memicu peringatan. |
| AlertConfigTargetList.N.Arn | String | No | acs:mns:cn-hangzhou:111:/queues/test/message | Nama Sumber Daya Alibaba Cloud (ARN) dari resource tersebut. Format:
|
| AlertConfigTargetList.N.Level | String | No | ["INFO", "WARN", "CRITICAL"] | Tingkat peringatan. Nilai yang valid:
|
| AlertConfigTargetList.N.JsonParams | String | No | {"customField1":"value1","customField2":"$.name"} | Parameter callback peringatan. Parameter dalam format JSON. |
Untuk informasi lebih lanjut 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 panggilan berhasil. |
| Message | String | The specified resource is not found. | Pesan kesalahan. |
| RequestId | String | 16E815A3-47E1-4290-87F9-D5C99471FF45 | ID permintaan. |
| Success | Boolean | true | Menunjukkan apakah panggilan berhasil. Nilai yang valid:
|
Contoh
Contoh permintaan
http(s)://[Endpoint]/?Action=ModifyHostAvailability
&AlertConfig.NotifyType=0
&AlertConfigEscalationList.1.MetricName=HttpStatus
&GroupId=123456
&Id=12345
&TaskName=task2
&<Common request parameters>
Contoh respons sukses
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<ModifyHostAvailabilityResponse>
<RequestId>16E815A3-47E1-4290-87F9-D5C99471FF45</RequestId>
<Success>true</Success>
<Code>200</Code>
</ModifyHostAvailabilityResponse>
JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "16E815A3-47E1-4290-87F9-D5C99471FF45",
"Code" : 200,
"Success" : true
}
Kode kesalahan
| HttpCode | Kode kesalahan | Pesan kesalahan | Deskripsi |
| 404 | ResourceNotFound | The specified resource is not found. | Pesan kesalahan yang dikembalikan karena resource yang ditentukan tidak ditemukan. |
Untuk daftar kode kesalahan, kunjungi API Error Center.