InstallMonitoringAgent - - Centre de documentation Alibaba Cloud

Prérequis

Le client Cloud Assistant est installé sur l'instance ECS. Pour savoir comment installer le client Cloud Assistant, consultez la rubrique Présentation.

Contexte

Cette opération API s'applique uniquement aux instances ECS.

Le taux de réussite de l'installation de l'agent CloudMonitor via cet appel API est d'environ 95 %. En cas d'échec, installez manuellement l'agent sur l'instance ECS. Pour plus d'informations sur l'installation de l'agent CloudMonitor, consultez la rubrique Installation et désinstallation de l'agent CloudMonitor pour C++.

Notes d'utilisation

Cette rubrique explique comment installer la dernière version de l'agent CloudMonitor sur une instance ECS dont l'ID est i-m5e0k0bexac8tykr****.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. Celui-ci génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	InstallMonitoringAgent	L'opération à effectuer. Définissez la valeur sur InstallMonitoringAgent.
Force	Boolean	Non	true	Indique s'il faut installer l'agent CloudMonitor. Valeurs possibles : true (valeur par défaut) : oui false : non
InstanceIds.N	String	Non	i-m5e0k0bexac8tykr****	Les ID des instances ECS. Valeurs valides de N : 1 à 10. Remarque Vous devez spécifier le paramètre `InstallCommand` ou le paramètre `InstanceIds`.
InstallCommand	String	Non	onlyInstallNotHasAgent	Spécifie s'il faut installer l'agent CloudMonitor sur toutes les instances ECS appartenant au compte Alibaba Cloud actuel. Valeurs possibles : `onlyInstallNotHasAgent` : installe la dernière version de l'agent CloudMonitor uniquement sur les instances ECS où l'agent n'est pas installé. `onlyUpgradeAgent` : met à niveau l'agent CloudMonitor vers la dernière version uniquement sur les instances ECS où une version antérieure de l'agent est installée. `installAndUpgrade` : installe la dernière version de l'agent CloudMonitor sur les instances ECS où l'agent n'est pas installé, et met à niveau l'agent vers la dernière version sur les instances où une version antérieure est présente. Remarque Si vous définissez le paramètre InstallCommand, le paramètre `InstanceIds` ne prend pas effet.

Pour plus d'informations sur les paramètres de requête communs, consultez la rubrique Paramètres communs.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Code	String	200	Le code d'état HTTP. Remarque Le code d'état 200 indique que l'appel a réussi.
Message	String	The specified resource is not found.	Le message d'erreur.
RequestId	String	0BDAF8A8-04DC-5F0C-90E4-724D42C41945	L'ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. Valeurs possibles : true : L'appel a réussi. false : L'appel a échoué.

Exemples

Exemple de requête

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

Exemple de réponse réussie

Format 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>

Format JSON

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

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

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
404	ResourceNotFound	The specified resource is not found.	La ressource spécifiée est introuvable.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur du service.