InstallMonitoringAgent - 為指定阿里雲主機安裝CloudMonitor外掛程式 - Cloud Monitor

介面說明

請確保阿里雲主機已安裝雲助手。關於如何安裝雲助手，請參見雲助手概述。

本介面僅適用於阿里雲主機，即 ECS 執行個體。通過 API 安裝CloudMonitor外掛程式的成功率約為 95%，如果安裝失敗，則請手動安裝。關於如何安裝CloudMonitor外掛程式，請參見安裝和卸載 C++版本外掛程式。

本文將提供一個樣本，強製為阿里雲主機i-m5e0k0bexac8tykr****安裝最新版本CloudMonitor外掛程式。

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作

存取層級

資源類型

條件關鍵字

關聯操作

cms:InstallMonitoringAgent

create

*全部資源

*

無

名稱	類型	必填	描述	樣本值
Force	boolean	否	是否強制安裝CloudMonitor外掛程式。取值： true（預設值）：強制安裝。 false：不強制安裝。	true
InstanceIds	array	否	阿里雲主機 ID。 N 的取值範圍：1~10。說明 `InstallCommand`和`InstanceIds`必須二選一。	i-m5e0k0bexac8tykr****
	string	否	阿里雲主機 ID。 N 的取值範圍：1~10。說明 `InstallCommand`和`InstanceIds`必須二選一。	i-m5e0k0bexac8tykr****
InstallCommand	string	否	為當前阿里雲帳號下的所有阿里雲主機安裝CloudMonitor外掛程式。取值： `onlyInstallNotHasAgent` ：僅為未安裝CloudMonitor外掛程式的阿里雲主機安裝最新版本外掛程式。 `onlyUpgradeAgent`：僅為已安裝非最新版本CloudMonitor外掛程式的阿里雲主機升級外掛程式。 `installAndUpgrade`：不僅為未安裝CloudMonitor外掛程式的阿里雲主機安裝最新版本外掛程式，且為已安裝非最新版本CloudMonitor外掛程式的阿里雲主機升級外掛程式。說明如果您已設定該參數，參數`InstanceIds`的設定無效。	onlyInstallNotHasAgent

關於公用請求參數的詳情，請參見公用參數。

名稱	類型	描述	樣本值
	object
Code	string	狀態代碼。說明 200 表示成功。	200
Message	string	錯誤資訊。	The specified resource is not found.
RequestId	string	請求 ID。	0BDAF8A8-04DC-5F0C-90E4-724D42C41945
Success	boolean	操作是否成功。取值： true：成功。 false：失敗。	true

正常返回樣本

JSON格式

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

HTTP status code	錯誤碼	錯誤資訊	描述
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.	未找到指定資源。

訪問錯誤中心查看更多錯誤碼。

更多資訊，參考變更詳情。