InstallMonitoringAgent - - Alibaba Cloud Documentation Center

Menginstal agen CloudMonitor pada satu atau beberapa instans Elastic Compute Service (ECS).

Prasyarat

Klien Cloud Assistant telah diinstal pada instans ECS. Untuk informasi selengkapnya tentang cara menginstal klien Cloud Assistant, lihat Ikhtisar.

Informasi latar belakang

Operasi API ini hanya berlaku untuk instans ECS.

Tingkat keberhasilan instalasi agen CloudMonitor dengan memanggil operasi API ini sekitar 95%. Jika instalasi gagal, instal agen tersebut secara manual pada instans ECS. Untuk informasi selengkapnya tentang cara menginstal agen CloudMonitor, lihat Instal dan uninstal agen CloudMonitor untuk C++.

Catatan penggunaan

Topik ini memberikan contoh cara menginstal versi terbaru agen CloudMonitor pada instans ECS dengan ID i-m5e0k0bexac8tykr****.

Debugging

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

Parameter permintaan

Parameter	Type	Wajib	Contoh	Deskripsi
Action	String	Ya	InstallMonitoringAgent	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke InstallMonitoringAgent.
Force	Boolean	Tidak	true	Menentukan apakah akan menginstal agen CloudMonitor. Nilai yang valid: true (nilai default): ya false: tidak
InstanceIds.N	String	Tidak	i-m5e0k0bexac8tykr****	ID instans ECS. Nilai N yang valid: 1 hingga 10. Catatan Anda harus menentukan salah satu parameter berikut: `InstallCommand` atau `InstanceIds`.
InstallCommand	String	Tidak	onlyInstallNotHasAgent	Menentukan apakah akan menginstal agen CloudMonitor pada semua instans ECS yang termasuk dalam Akun Alibaba Cloud saat ini. Nilai yang valid: `onlyInstallNotHasAgent`: menginstal versi terbaru agen CloudMonitor hanya pada instans ECS yang belum memiliki agen tersebut. `onlyUpgradeAgent`: meningkatkan versi agen CloudMonitor ke versi terbaru hanya untuk instans ECS yang telah memiliki versi agen sebelumnya. `installAndUpgrade`: menginstal versi terbaru agen CloudMonitor pada instans ECS yang belum memiliki agen tersebut, serta meningkatkan versi agen CloudMonitor ke versi terbaru untuk instans ECS yang telah memiliki versi agen sebelumnya. Catatan Jika Anda menetapkan parameter InstallCommand, parameter `InstanceIds` tidak berlaku.

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	0BDAF8A8-04DC-5F0C-90E4-724D42C41945	ID permintaan.
Success	Boolean	true	Menunjukkan apakah pemanggilan berhasil. Nilai yang valid: true: Pemanggilan berhasil. false: Pemanggilan gagal.

Contoh

Contoh permintaan

http(s)://[Endpoint]/?Action=InstallMonitoringAgent
&Force=true
&InstallCommand=onlyInstallNotHasAgent
&<Common request parameters>

Contoh respons sukses

XML format

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

<InstallMonitoringAgentResponse>
	<RequestId>0BDAF8A8-04DC-5F0C-90E4-724D42C41945</RequestId>
	<Code>200</Code>
	<Success>true</Success>
</InstallMonitoringAgentResponse>

JSON format

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

{
  "RequestId" : "0BDAF8A8-04DC-5F0C-90E4-724D42C41945",
  "Code" : 200,
  "Success" : true
}

Kode kesalahan

Kode status HTTP	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, lihat Kode kesalahan layanan.