全部产品
Search
文档中心

Cloud Monitor:InstallMonitoringAgent

更新时间:Jan 21, 2026

Panggil operasi InstallMonitoringAgent untuk menginstal agen CloudMonitor pada host Alibaba Cloud yang ditentukan.

Deskripsi operasi

Prasyarat

Pastikan Cloud Assistant telah diinstal pada host Alibaba Cloud. Untuk informasi selengkapnya, lihat Cloud Assistant overview.

Informasi latar belakang

API ini hanya berlaku untuk host Alibaba Cloud, yaitu instance Elastic Compute Service (ECS). Tingkat keberhasilan penginstalan agen CloudMonitor melalui API ini sekitar 95%. Jika penginstalan gagal, Anda harus menginstal agen tersebut secara manual. Untuk informasi selengkapnya tentang cara menginstal agen CloudMonitor, lihat Install and uninstall the C++ agent.

Contoh

Contoh berikut menunjukkan cara menginstal versi terbaru agen CloudMonitor secara paksa pada instance ECS i-m5e0k0bexac8tykr****.

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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

Force

boolean

No

Menentukan apakah akan memaksa instalasi agen CloudMonitor. Nilai yang valid:

  • true (default): Memaksa instalasi agen.

  • false: Tidak memaksa instalasi agen.

true

InstanceIds

array

No

ID host Alibaba Cloud.

Anda dapat menentukan 1 hingga 10 ID instans.

Catatan

Anda harus menentukan salah satu dari InstallCommand atau InstanceIds.

i-m5e0k0bexac8tykr****

string

No

ID host Alibaba Cloud.

Anda dapat menentukan 1 hingga 10 ID instans.

Catatan

Anda harus menentukan salah satu dari InstallCommand atau InstanceIds.

i-m5e0k0bexac8tykr****

InstallCommand

string

No

Perintah instalasi. Perintah ini menginstal agen CloudMonitor pada semua host Alibaba Cloud yang termasuk dalam Akun Alibaba Cloud Anda. Nilai yang valid:

  • onlyInstallNotHasAgent: Menginstal versi terbaru agen CloudMonitor hanya pada host Alibaba Cloud yang belum memiliki agen.

  • onlyUpgradeAgent: Meningkatkan versi agen CloudMonitor hanya pada host Alibaba Cloud yang telah memiliki versi agen sebelumnya.

  • installAndUpgrade: Menginstal versi terbaru agen CloudMonitor pada host Alibaba Cloud yang belum memiliki agen, serta meningkatkan agen pada host yang telah memiliki versi agen sebelumnya.

Catatan

Jika Anda menetapkan parameter ini, parameter InstanceIds tidak berlaku.

onlyInstallNotHasAgent

Untuk informasi selengkapnya tentang parameter permintaan umum, lihat Common parameters.

Elemen respons

Element

Type

Description

Example

object

Code

string

Kode status.

Catatan

Nilai 200 menunjukkan bahwa permintaan berhasil.

200

Message

string

Pesan kesalahan.

The specified resource is not found.

RequestId

string

ID permintaan.

0BDAF8A8-04DC-5F0C-90E4-724D42C41945

Success

boolean

Menunjukkan apakah operasi berhasil. Nilai yang valid:

  • true: Operasi berhasil.

  • false: Operasi gagal.

true

Contoh

Respons sukses

JSONformat

{
  "Code": "200",
  "Message": "The specified resource is not found.",
  "RequestId": "0BDAF8A8-04DC-5F0C-90E4-724D42C41945",
  "Success": true
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 ParameterInvalid Parameter invalid.
500 InternalError The request processing has failed due to some unknown error.
403 AccessForbidden User not authorized to operate on the specified resource.
404 ResourceNotFound The specified resource is not found.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.