Cloud Monitor:CreateInstantSiteMonitor - Cloud Monitor - Alibaba Cloud - Cloud Monitor

Membuat tugas pemantauan sintetis satu kali.

Deskripsi operasi

Hanya akun Alibaba Cloud yang telah mengaktifkan Network Analysis and Monitoring yang dapat membuat tugas pemantauan sintetis satu kali.

Topik ini menyediakan contoh cara membuat tugas pemantauan sintetis satu kali. Nama tugas adalah task1, alamat yang dipantau adalah http://www.aliyun.com, tipe tugas adalah HTTP, dan jumlah titik deteksi adalah 1.

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:CreateInstantSiteMonitor

create

*Semua Sumber daya.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Address	string	Yes	URL atau alamat IP dari tugas pemantauan sintetis.	http://www.aliyun.com.
TaskType	string	Yes	Tipe tugas pemantauan sintetis. Nilai valid: HTTP, PING, TCP, UDP, dan DNS.	HTTP.
TaskName	string	Yes	Nama tugas pemantauan sintetis. Panjang nama harus 4 hingga 100 karakter dan dapat berisi huruf, angka, serta garis bawah (_).	task1
IspCities	string	No	Informasi titik deteksi. Jika parameter ini dibiarkan kosong, sistem akan memilih tiga titik deteksi secara acak. Nilainya dalam format `JSONArray`. Contoh: [{"city":"546","isp":"465", "type":"IDC"},{"city":"572","isp":"465", "type":"LASTMILE"},{"city":"738","isp":"465"}], yang masing-masing sesuai dengan Beijing, Hangzhou, dan Qingdao. Bidang type menentukan tipe titik deteksi. Ketika AgentGroup diatur ke PC, nilai validnya adalah IDC dan LASTMILE. IDC menunjukkan titik deteksi yang diterapkan di pusat data. LASTMILE menunjukkan titik deteksi yang diterapkan di rumah pengguna akhir yang menggunakan jaringan kabel tetap. Bidang type bersifat opsional dan default-nya adalah IDC. Ketika AgentGroup diatur ke MOBILE, bidang ini tidak perlu ditentukan. Untuk informasi tentang cara memperoleh informasi titik deteksi, lihat DescribeSiteMonitorISPCityList. Catatan Anda harus menentukan `IspCities` atau `RandomIspCity`.	[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]
OptionsJson	string	No	Opsi lanjutan yang diperluas untuk jenis protokol tugas pemantauan sintetis. Jenis protokol yang berbeda memiliki opsi lanjutan yang berbeda.	{"time_out":5000}
RandomIspCity	integer	No	Jumlah titik deteksi. Catatan Anda harus menentukan `IspCities` atau `RandomIspCity`.- Jika Anda mengatur parameter `RandomIspCity`, parameter `IspCities` menjadi tidak valid.	1
AgentGroup	string	No	Tipe titik deteksi. Nilai valid: PC dan MOBILE. PC menunjukkan titik deteksi jaringan kabel tetap. MOBILE menunjukkan titik deteksi jaringan seluler. Nilai default: PC. Valid values: PC : titik deteksi jaringan kabel tetap. MOBILE : titik deteksi jaringan seluler.	PC

Pengaturan parameter lanjutan untuk TaskType

Tabel berikut menjelaskan cara mengonfigurasi parameter lanjutan untuk HTTP, PING, TCP, UDP, dan DNS di TaskType.

HTTP

Parameter	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 baris baru (\n). Setiap baris header harus sesuai dengan format protokol HTTP (pasangan kunci-nilai yang dipisahkan oleh titik dua lebar setengah).
cookie	String	Cookie, ditulis dalam format permintaan HTTP standar.
request_content	String	Konten permintaan. Dua format didukung: JSON dan form. Jika tidak disediakan, permintaan tidak mengandung body.
response_content	String	Konten respons yang diharapkan. Selama deteksi, 64 byte pertama yang dikembalikan oleh server HTTP diperiksa.
match_rule	String	0: Deteksi berhasil jika respons tidak mengandung response_content. 1: Deteksi berhasil jika respons mengandung response_content.
username	String	Jika nama pengguna disediakan, header BasicAuth disertakan dalam permintaan HTTP.
password	String	Kata sandi untuk autentikasi permintaan HTTP.
time_out	int	Periode pengatur waktu tunggu. Unit: milidetik. Nilai default: 30000.
max_redirect	int	Jumlah maksimum pengalihan. Nilai default adalah 5 untuk probe ECS dan 2 untuk titik deteksi operator. Atur parameter ini ke 0 untuk menonaktifkan pengalihan. Nilai valid: 0 hingga 50.

PING

Parameter	Tipe	Deskripsi
failure_rate	int	Jika tingkat kegagalan PING melebihi nilai ini, deteksi 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.

TCP atau UDP

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

Parameter	Tipe	Deskripsi
dns_server	string	Alamat server DNS, yang dapat berupa nama domain atau alamat IP.
dns_type	string	Tipe kueri DNS. Nilai valid: A, NS, CNAME, MX, TXT, dan ANY.
expect_value	string	Daftar nilai yang diharapkan dipisahkan oleh karakter spasi putih.
match_rule	string	Hubungan antara daftar nilai yang diharapkan dan daftar DNS. Jika hubungan yang ditentukan tidak terpenuhi, deteksi 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.

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: Berhasil. false: Gagal.	true.
CreateResultList	array<object>	Daftar hasil pembuatan tugas pemantauan sintetis satu kali.
	object	Daftar hasil pembuatan tugas pemantauan sintetis satu kali.
TaskId	string	ID tugas pemantauan sintetis.	2c8dbdf9-a3ab-46a1-85a4-f094965e****
TaskName	string	Nama tugas pemantauan sintetis.	task1

Contoh

Respons sukses

JSONformat

{
  "Code": "200",
  "Message": "successful",
  "RequestId": "68192f5d-0d45-4b98-9724-892813f86c71",
  "Success": "true",
  "CreateResultList": [
    {
      "TaskId": "2c8dbdf9-a3ab-46a1-85a4-f094965e****",
      "TaskName": "task1"
    }
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidQueryParameter	%s
400	IllegalAddress	Illegal HTTP address
400	OperationError	Operation failed
400	TaskNotExists	Task does not exist
400	OperatorInvalid	Operator invalid
400	OperatorCityInvalid	Operator City invalid
400	NameRepeat	Task name repeat
400	CreateAlarmError	Create alarm error
400	NameNotExists	Task name not exists
400	Illegal Task Name	The task name of the sitemonitor task is illegal.	Nama tugas pemantauan situs tidak valid.
401	AccessDeniedException	You donot have sufficient access to perform this action.
500	InternalError	%s
402	LimitExceeded	The quota for this customer had been reached.
403	%s	%s
403	Forbidden	%s
503	%s	%s
406	ExceedingQuota	Exceeding quota limits.	Jumlah tugas melebihi kuota.
409	%s	%s

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.