Modifikasi tugas pemantauan situs dengan ModifySiteMonitor - Cloud Monitor - Alibaba Cloud - Cloud Monitor

Mengubah tugas pemantauan situs.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

cms:ModifySiteMonitor

update

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Address	string	No	URL atau alamat IP tugas pemantauan.	http://www.aliyun.com
TaskId	string	Yes	ID tugas pemantauan.	2c8dbdf9-a3ab-46a1-85a4-f094965e****
TaskName	string	No	Nama tugas pemantauan. Nama harus terdiri dari 4 hingga 100 karakter dan dapat berisi huruf, digit, garis bawah (_), serta karakter Tionghoa.	HanZhou_ECS2
Interval	string	No	Frekuensi pemantauan. Nilai valid: 1, 5, dan 15. Unit: minutes. Nilai default: 1.	1
IspCities	string	No	Informasi titik deteksi. Nilai dalam format JSONArray, misalnya: `[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]`, di mana `city` masing-masing sesuai dengan Beijing, Hangzhou, dan Qingdao. Catatan Anda dapat memanggil operasi DescribeSiteMonitorISPCityList untuk mengkueri informasi titik deteksi. Untuk informasi selengkapnya, lihat DescribeSiteMonitorISPCityList. Jika parameter ini dikosongkan, sistem akan memilih tiga titik deteksi secara acak.	[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]
OptionsJson	string	No	Opsi lanjutan untuk jenis protokol tugas pemantauan. Jenis protokol yang berbeda memiliki opsi lanjutan yang berbeda.	{"time_out":5000}
AlertIds	string	No	ID aturan peringatan. Tentukan ID aturan peringatan yang ada di CloudMonitor. Anda dapat memanggil operasi DescribeMetricRuleList untuk mengkueri ID aturan peringatan. Untuk informasi selengkapnya, lihat DescribeMetricRuleList.	49f7c317-7645-4cc9-94fd-ea42e122****
IntervalUnit	string	No	Unit metrik pemantauan. Unit: milliseconds (ms).	ms
CustomSchedule	string	No	Jadwal pemantauan kustom. Anda dapat memilih periode waktu tertentu dari Senin hingga Minggu untuk pemantauan.	{"start_hour":0,"end_hour":24, "days":[0], "time_zone":"Local"}

Pemantauan situs mendukung delapan jenis tugas berikut. Opsi lanjutan (OptionsJson) untuk setiap jenis tugas dijelaskan dalam tabel berikut.

HTTP.

Nama	Tipe	Deskripsi
http_method	String	Metode permintaan HTTP. Nilai valid: GET, POST, dan HEAD. Nilai default: GET.
header	String	Header HTTP kustom yang dipisahkan oleh umpan baris (\n). Setiap header harus sesuai dengan format protokol HTTP (pasangan kunci-nilai yang dipisahkan oleh titik dua).
cookie	String	Cookie, yang mengikuti format permintaan HTTP standar.
request_content	String	Konten permintaan. Dua format didukung: JSON dan form. Jika parameter ini tidak ditentukan, permintaan tidak berisi body.
response_content	String	Konten respons yang diharapkan. Selama pemantauan, 64 byte pertama yang dikembalikan oleh server HTTP akan diperiksa.
match_rule	String	0: Pemantauan berhasil jika respons tidak mengandung response_content. 1: Pemantauan berhasil jika respons mengandung response_content.
username	String	Jika nama pengguna disediakan, header BasicAuth akan disertakan dalam permintaan HTTP.
password	String	Kata sandi untuk autentikasi permintaan HTTP.
time_out	int	Periode pengatur waktu tunggu. Unit: milliseconds. Nilai default: 5.
max_redirect	int	Jumlah pengalihan maksimum. Nilai default adalah 5 untuk titik deteksi ECS dan 2 untuk titik deteksi operator. Untuk menonaktifkan pengalihan, tetapkan parameter ini ke 0. Nilai valid: 0 hingga 50.

PING.

Nama	Tipe	Deskripsi
failure_rate	int	Jika tingkat kegagalan PING melebihi nilai ini, pemantauan gagal dan mengembalikan 610 (PingAllFail) atau 615 (PingPartialFail). Nilai default: 0.1.
ping_num	int	Jumlah percobaan PING. Nilai default: 20. Nilai valid: 1 hingga 100.

DNS.

Nama	Tipe	Deskripsi
dns_server	string	Alamat server DNS. Nilai dapat berupa nama domain atau alamat IP.
dns_type	string	Jenis kueri DNS. Nilai valid: A, NS, CNAME, MX, TXT, dan ANY.
expect_value	string	Daftar nilai yang diharapkan dipisahkan oleh karakter spasi.
match_rule	string	Hubungan antara daftar nilai yang diharapkan dan daftar DNS. Jika hubungan yang ditentukan tidak terpenuhi, pemantauan gagal. String kosong atau IN_DNS: Daftar nilai yang diharapkan adalah subset dari daftar DNS. DNS_IN: Daftar DNS adalah subset dari daftar nilai yang diharapkan. EQUAL: Daftar DNS sama dengan daftar nilai yang diharapkan. ANY: Daftar DNS dan daftar nilai yang diharapkan memiliki irisan yang tidak kosong.

FTP.

Nama	Tipe	Deskripsi
port	int	Nomor port server FTP. Jika parameter ini tidak ditentukan, nilai default akan digunakan. Nilai default untuk FTP: 21. Nilai default untuk FTPs: 990.
username	string	Nama pengguna FTP. Jika parameter ini tidak ditentukan, login anonim akan digunakan.
password	string	Kata sandi FTP.

POP3/SMTP.

Nama	Tipe	Deskripsi
port	int	Nomor port server POP3. Nilai default untuk POP3: 110. Nilai default untuk POP3s: 995.
username	string	Nama pengguna untuk POP3/SMTP.
password	string	Kata sandi untuk POP3/SMTP.

TCP/UDP.

Nama	Tipe	Deskripsi
port	int	Port server TCP/UDP.
request_content	string	Konten permintaan. Jika request_format diatur ke hex, nilai request_content dalam format heksadesimal ringkas.
request_format	string	Jika request_format diatur ke nilai lain, request_content dikirim ke server TCP/UDP sebagai string biasa.
response_content	string	Konten respons. Jika konten yang dikembalikan oleh server TCP/UDP tidak mengandung response_content, pemantauan gagal. Jika response_format diatur ke hex, nilai response_content dalam format heksadesimal ringkas. Jika response_content diatur ke nilai lain, response_content adalah string biasa.

Elemen respons

Element	Type	Description	Example
	object
Code	string	Kode status. Catatan Nilai 200 menunjukkan keberhasilan.	200
Message	string	Paket yang dikembalikan.	successful
RequestId	string	ID permintaan.	68192f5d-0d45-4b98-9724-892813f86c71
Success	string	Apakah operasi berhasil. Nilai valid: true: Operasi berhasil. false: Operasi gagal.	true
Data	object	Detail hasil tugas node.
count	integer	Jumlah tugas pemantauan.	1

Contoh

Respons sukses

JSONformat

{
  "Code": "200",
  "Message": "successful",
  "RequestId": "68192f5d-0d45-4b98-9724-892813f86c71",
  "Success": "true",
  "Data": {
    "count": 1
  }
}

Kode kesalahan

HTTP status code	Error code	Error message
400	InvalidQueryParameter	%s
400	IllegalAddress	Illegal HTTP address
400	OperationError	Operation failed
400	TaskNotExists	Task does not exist
400	OperatorInvalid	%s
400	NameRepeat	Task name repeat
400	CreateAlarmError	Create alarm error
400	NameNotExists	Task name not exists
400	OperatorCityInvalid	Invalid Isp.
401	AccessDeniedException	You donot have sufficient access to perform this action.
500	InternalError	%s
500	InternetServerError	System internal error.
402	LimitExceeded	The quota for this customer had been reached.
403	Forbidden	You are not authorized to operate the specified resource.
403	RestrictedUser	The user's operation is restricted, please register NAAM product code.
403	UnauthorizedTasks	You are not permitted to operate the specified tasks.
404	TaskNotExist	The specified task does not exist.
406	ExceedingQuota	Exceeding quota limits.
429	ThrottlingException	The request was denied due to request throttling.
409	%s	%s

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.