All Products
Search
Document Center

Security Center:InstallCloudMonitor

Last Updated:Jun 17, 2026

Menginstal Agen CloudMonitor pada server tertentu.

Deskripsi operasi

Catatan

Sebelum instalasi, pastikan bahwa Klien Pusat Keamanan pada server Anda online dan server Anda dapat mengakses layanan Alibaba Cloud melalui jaringan.

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

yundun-sas:InstallCloudMonitor

none

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

ArgusVersion

string

Yes

Versi Agen CloudMonitor yang akan diinstal. Anda dapat memperoleh versi Agen CloudMonitor terbaru dari Ikhtisar plugin.

3.5.6

AgentAccessKey

string

No

AccessKey yang diperlukan untuk menginstal Agen CloudMonitor. Anda dapat memanggil operasi DescribeMonitoringAgentAccessKey untuk memperoleh parameter ini.

Catatan

Parameter ini hanya diperlukan saat Anda menginstal Agen CloudMonitor pada server non-Alibaba Cloud.

usY*****R_U

AgentSecretKey

string

No

AccessSecret yang diperlukan untuk menginstal Agen CloudMonitor. Anda dapat memanggil operasi DescribeMonitoringAgentAccessKey untuk memperoleh parameter ini.

Catatan

Parameter ini hanya diperlukan saat Anda menginstal Agen CloudMonitor pada server non-Alibaba Cloud.

UCxF2R1sIO90XlU9****

InstanceIdList

array

No

Daftar ID instans server tempat Anda ingin menginstal Agen CloudMonitor. Pisahkan beberapa ID dengan koma (,).

string

No

Daftar ID instans server tempat Anda ingin menginstal Agen CloudMonitor. Pisahkan beberapa ID dengan koma (,).

Catatan

Anda harus menentukan setidaknya satu parameter InstanceIdList atau UuidList agar operasi berhasil. Jika kedua parameter ditentukan, Agen CloudMonitor diinstal pada union server yang ditentukan oleh kedua parameter tersebut.

[VMware-564d4e22ce6d9207-c97c8af3a448****,VMware-564d4a9574e0b8ab-843ba10d8b0c****,VMware-564dbb7fddaf27ce-629271166745****]

UuidList

array

No

Daftar UUID server tempat Anda ingin menginstal Agen CloudMonitor. Pisahkan beberapa UUID dengan koma (,).

string

No

Daftar UUID server tempat Anda ingin menginstal Agen CloudMonitor. Pisahkan beberapa UUID dengan koma (,).

Catatan

Anda harus menentukan setidaknya satu parameter InstanceIdList atau UuidList agar operasi berhasil. Jika kedua parameter ditentukan, Agen CloudMonitor diinstal pada union server yang ditentukan oleh kedua parameter tersebut.

[inet-c669e5d9-0adf-4d71-a9ce-65ed2730****,inet-2e87cce8-763d-4dcd-b39f-d592e1b0****,inet-7c676676-06fa-442e-90fb-b802e5d6****]

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan. Alibaba Cloud menghasilkan ID unik untuk setiap permintaan. Anda dapat menggunakan ID ini untuk memecahkan masalah.

F92AFB96-FACC-57E7-928E-678D04B94CAE

Success

boolean

Apakah operasi berhasil. Nilai valid:

  • true: Operasi berhasil.

  • false: Operasi gagal.

false

Code

string

Kode kesalahan yang dikembalikan saat operasi gagal.

IllegalParam

Message

string

Informasi detail mengenai kode kesalahan.

There was an error with your request.

HttpStatusCode

integer

Kode status HTTP.

400

Contoh

Respons sukses

JSONformat

{
  "RequestId": "F92AFB96-FACC-57E7-928E-678D04B94CAE",
  "Success": false,
  "Code": "IllegalParam",
  "Message": "There was an error with your request.",
  "HttpStatusCode": 400
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 ConsoleError The error message is %s %s.
400 IllegalParam Illegal param 无效参数
400 MachineNotExist The machine does not exist. 所操作的机器不存在,请确认后重新操作。
400 AgentNotOnline The agent not online. 客户端不在线不支持操作,请保持客户端在线后再进行操作。
400 InvalidParam There was an error with your request. 您的请求发生错误,请稍后重试!
500 ServerError ServerError 服务故障,请稍后重试!
403 NoPermission caller has no permission 当前操作未被授权,请联系主账号在RAM控制台进行授权后再执行操作。

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.