すべてのプロダクト
Search

このプロダクト

    :InstallMonitoringAgent

    ドキュメントセンター

    :InstallMonitoringAgent

    最終更新日:Jun 27, 2025

    1 つ以上の Elastic Compute Service (ECS) インスタンスに CloudMonitor エージェントをインストールします。

    前提条件

    Cloud Assistant クライアントが ECS インスタンスにインストールされています。 Cloud Assistant クライアントのインストール方法の詳細については、「概要」をご参照ください。

    背景情報

    この API 操作は ECS インスタンスにのみ適用されます。

    この API 操作を呼び出して CloudMonitor エージェントをインストールする際の成功率は約 95% です。インストールに失敗した場合は、ECS インスタンスにエージェントを手動でインストールしてください。 CloudMonitor エージェントのインストール方法の詳細については、「C++ 用の CloudMonitor エージェントをインストールおよびアンインストールする」をご参照ください。

    使用上の注意

    このトピックでは、ID が i-m5e0k0bexac8tykr**** の ECS インスタンスに最新バージョンの CloudMonitor エージェントをインストールする方法の例を示します。

    デバッグ

    OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK 用の操作のサンプルコードを動的に生成します。

    リクエストパラメーター

    パラメーター

    タイプ

    必須

    例

    説明

    Action

    String

    はい

    InstallMonitoringAgent

    実行する操作。値を InstallMonitoringAgent に設定します。

    Force

    Boolean

    いいえ

    true

    CloudMonitor エージェントをインストールするかどうかを指定します。有効な値：

    • true（デフォルト値）：はい

    • false：いいえ

    InstanceIds.N

    String

    いいえ

    i-m5e0k0bexac8tykr****

    ECS インスタンスの ID。

    N の有効な値：1 ～ 10。

    説明

    InstallCommand パラメーターまたは InstanceIds パラメーターのいずれかを指定する必要があります。

    InstallCommand

    String

    いいえ

    onlyInstallNotHasAgent

    現在の Alibaba Cloud アカウントに属するすべての ECS インスタンスに CloudMonitor エージェントをインストールするかどうかを指定します。有効な値：

    • onlyInstallNotHasAgent: エージェントがインストールされていない ECS インスタンスにのみ、最新バージョンの CloudMonitor エージェントをインストールします。

    • onlyUpgradeAgent: 以前のバージョンのエージェントがインストールされている ECS インスタンスについてのみ、CloudMonitor エージェントを最新バージョンにアップグレードします。

    • installAndUpgrade: エージェントがインストールされていない ECS インスタンスに最新バージョンの CloudMonitor エージェントをインストールし、以前のバージョンのエージェントがインストールされている ECS インスタンスについて CloudMonitor エージェントを最新バージョンにアップグレードします。

    説明

    InstallCommand パラメーターを設定した場合、InstanceIds パラメーターは無効になります。

    共通のリクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。

    レスポンスパラメーター

    パラメーター

    タイプ

    例

    説明

    Code

    String

    200

    HTTP ステータスコード。

    説明

    ステータスコード 200 は、呼び出しが成功したことを示します。

    Message

    String

    指定されたリソースが見つかりません。

    エラーメッセージ。

    RequestId

    String

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

    リクエストの ID。

    Success

    Boolean

    true

    呼び出しが成功したかどうかを示します。有効な値：

    • true：呼び出しは成功しました。

    • false：呼び出しは失敗しました。

    例

    リクエストの例

    http(s)://[Endpoint]/?Action=InstallMonitoringAgent
&Force=true
&InstallCommand=onlyInstallNotHasAgent
&<共通リクエストパラメーター>

    成功レスポンスの例

    XML 形式

    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 形式

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

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

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明

    404

    ResourceNotFound

    指定されたリソースが見つかりません。

    指定されたリソースが見つからないために返されたエラーメッセージ。

    エラーコードのリストについては、「サービスエラーコード」をご参照ください。