ModifySiteMonitor - - Alibaba Cloud Documentation Center

Memodifikasi tugas Pemantauan situs.

Topik ini memberikan contoh cara mengubah nama tugas Pemantauan situs dengan ID 2c8dbdf9-a3ab-46a1-85a4-f094965e**** menjadi HanZhou_ECS1. Hasil respons menunjukkan bahwa nama tugas telah berhasil diubah.

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	Example	Description
Action	String	Yes	ModifySiteMonitor	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifySiteMonitor.
TaskId	String	Yes	2c8dbdf9-a3ab-46a1-85a4-f094965e****	ID tugas Pemantauan situs.
Address	String	No	http://www.aliyun.com	URL atau alamat IP yang dipantau oleh tugas.
TaskName	String	No	HanZhou_ECS1	Nama tugas Pemantauan situs. Nama harus terdiri dari 4 hingga 100 karakter, dan dapat berisi huruf, angka, serta garis bawah (_).
Interval	String	No	1	Frekuensi pemantauan. Nilai yang valid: 1, 5, 15, dan 15000. Satuan: milidetik. Nilai default: 1.
IspCities	String	No	[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]	Titik deteksi. Nilainya berupa array JSON. Contoh: `[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]`. Nilai bidang `city` masing-masing merepresentasikan Beijing, Hangzhou, dan Qingdao. Catatan Anda dapat memanggil operasi DescribeSiteMonitorISPCityList untuk mengkueri titik deteksi. Untuk informasi lebih lanjut, lihat DescribeSiteMonitorISPCityList. Jika Anda tidak mengisi parameter ini, sistem akan memilih tiga titik deteksi secara acak.
OptionsJson	String	No	null	Opsi ekstensi protokol yang digunakan oleh tugas Pemantauan situs. Opsi ini berbeda-beda tergantung pada protokolnya.
AlertIds	String	No	49f7c317-7645-4cc9-94fd-ea42e122****	ID aturan alert. Anda dapat memanggil operasi DescribeMetricRuleList untuk mengkueri ID aturan alert yang ada di CloudMonitor. Untuk informasi lebih lanjut, lihat DescribeMetricRuleList.
IntervalUnit	String	No	ms	Satuan frekuensi pemantauan. Parameter ini harus digunakan berpasangan dengan parameter `Interval`. Misalnya, Anda dapat menetapkan parameter ini ke `ms` dan parameter `Interval` ke `15000` (15 detik). Nilai yang valid: s: detik ms: milidetik Catatan Sebelum menetapkan parameter ini, Anda harus mengaktifkan fitur pemantauan presisi tinggi. Untuk informasi lebih lanjut tentang cara mengaktifkan fitur tersebut, lihat Activate Hybrid Cloud Monitoring.

Pemantauan situs mendukung delapan protokol berikut. Tabel-tabel berikut menjelaskan opsi ekstensi yang ditentukan oleh parameter OptionsJson untuk setiap protokol.

HTTP

Parameter	Type	Description
http_method	String	Metode permintaan HTTP. Nilai yang valid: GET, POST, dan HEAD. Nilai default: GET.
header	String	Header HTTP kustom yang dipisahkan dengan line feed (\n). Setiap header harus sesuai dengan protokol HTTP. Setiap header harus berupa pasangan kunci-nilai di mana kunci dan nilai dipisahkan oleh tanda titik dua (:).
cookie	String	Cookie HTTP yang ditentukan sesuai dengan standar permintaan HTTP.
request_content	String	Konten permintaan. Konten dapat dalam format JSON atau form. Jika parameter ini tidak ditentukan, badan permintaan akan kosong.
response_content	String	Konten respons yang diharapkan. Selama Pemantauan situs, 64 byte pertama dari konten yang dikembalikan oleh server HTTP akan diperiksa.
match_rule	String	0: Jika respons tidak berisi konten yang ditentukan oleh parameter response_content, deteksi berhasil. 1: Jika respons berisi konten yang ditentukan oleh parameter response_content, deteksi berhasil.
username	String	Jika parameter username ditentukan, permintaan HTTP akan berisi header autentikasi dasar.
password	String	Password yang digunakan untuk mengotentikasi permintaan HTTP.
time_out	int	Periode timeout. Satuan: milidetik. Nilai default: 5.
max_redirect	int	Jumlah maksimum pengalihan. Nilai default adalah 5 untuk titik deteksi yang berjalan pada instans Elastic Compute Service (ECS) dan 2 untuk titik deteksi yang disediakan oleh penyedia layanan. Untuk menonaktifkan pengalihan, tetapkan nilainya ke 0. Nilai yang valid: 0 hingga 50.

PING

Parameter

Type

Description

failure_rate

int

Jika laju ping gagal melebihi nilai parameter ini, deteksi gagal dan kode status 610 atau 615 dikembalikan. Pesan kesalahan untuk kode status 610 adalah PingAllFail dan untuk kode status 615 adalah PingPartialFail.

Nilai default: 0,1.

ping_num

int

Jumlah kali alamat yang dipantau diping. Nilai default: 20.

Nilai yang valid: 1 hingga 100.

Parameter	Type	Description
dns_server	string	Nama domain atau alamat IP server Domain Name System (DNS).
dns_type	string	Tipe rekaman DNS yang dikueri. Nilai yang valid: A, NS, CNAME, MX, TXT, dan ANY.
expect_value	string	Daftar nilai yang diharapkan. Pisahkan nilai-nilai yang diharapkan dengan spasi.
match_rule	string	Hubungan antara daftar nilai yang diharapkan dan daftar hasil DNS. Jika kedua daftar tidak memenuhi hubungan yang ditentukan, deteksi gagal. Nilai yang valid: String kosong atau IN_DNS: Daftar nilai yang diharapkan merupakan subset dari daftar hasil DNS. DNS_IN: Daftar hasil DNS merupakan subset dari daftar nilai yang diharapkan. EQUAL: Daftar hasil DNS sama persis dengan daftar nilai yang diharapkan. ANY: Terdapat irisan antara daftar hasil DNS dan daftar nilai yang diharapkan.

Parameter	Type	Description
port	int	Nomor port server FTP. Jika parameter ini tidak ditentukan, nilai default digunakan. Nomor port default adalah 21 untuk FTP dan 990 untuk FTPS.
username	string	Username yang digunakan untuk login ke server FTP. Jika parameter ini tidak ditentukan, login anonim digunakan.
password	string	Password yang digunakan untuk login ke server FTP.

POP3/SMTP

Parameter	Type	Description
port	int	Nomor port server POP3. Nomor port default adalah 110 untuk POP3 dan 995 untuk POP3S.
username	string	Username yang digunakan untuk login ke server POP3 atau SMTP.
password	string	Password yang digunakan untuk login ke server POP3 atau SMTP.

TCP/UDP

Parameter	Type	Description
port	int	Nomor port server TCP atau UDP.
request_content	string	Konten permintaan. Jika parameter request_format diatur ke hex, nilai parameter request_content akan diurai dalam format heksadesimal.
request_format	string	Jika parameter request_format diatur ke nilai lain, nilai parameter request_content akan dikirim ke server TCP atau UDP sebagai string biasa.
response_content	string	Konten respons. Jika respons dari server TCP atau UDP tidak berisi konten yang ditentukan oleh parameter response_content, deteksi gagal. Jika parameter response_format diatur ke hex, nilai parameter response_content akan diurai dalam format heksadesimal. Jika parameter response_format diatur ke nilai lain, nilai parameter response_content akan diurai sebagai string biasa.

Parameter respons

Parameter	Type	Example	Description
Code	String	200	Kode status HTTP. Catatan Kode status 200 menunjukkan bahwa pemanggilan berhasil.
Data	Struct		Hasil modifikasi tugas.
count	Integer	1	Jumlah tugas Pemantauan situs.
Message	String	successful	Pesan yang dikembalikan.
RequestId	String	68192f5d-0d45-4b98-9724-892813f86c71	ID permintaan.
Success	String	true	Menunjukkan apakah pemanggilan berhasil. Nilai yang valid: true: Pemanggilan berhasil. false: Pemanggilan gagal.

Contoh

Permintaan contoh

http(s)://[Endpoint]/?Action=ModifySiteMonitor
&TaskId=2c8dbdf9-a3ab-46a1-85a4-f094965e****
&TaskName=HanZhou_ECS2
&<Common request parameters>

Respons sukses contoh

XML format

<ModifySiteMonitorResponse>
	  <Message>successful</Message>
	  <RequestId>32E77F32-B86E-4763-A0BB-0311581ABE67</RequestId>
	  <Data>
		    <count>1</count>
	  </Data>
	  <Code>200</Code>
	  <Success>true</Success>
</ModifySiteMonitorResponse>

JSON format

{
	"Message": "successful",
	"RequestId": "32E77F32-B86E-4763-A0BB-0311581ABE67",
	"Data": {
		"count": 1
	},
	"Code": "200",
	"Success": true
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.