InstallMonitoringAgent - : Central de Documentação do Alibaba Cloud

Pré-requisitos

O cliente do Cloud Assistant deve estar instalado na instância do ECS. Para obter mais informações sobre como instalar o cliente do Cloud Assistant, consulte Visão geral.

Informações gerais

Esta operação de API é aplicável apenas a instâncias do ECS.

A taxa de sucesso na instalação do agente do CloudMonitor por meio desta operação de API é de aproximadamente 95%. Se a instalação falhar, instale o agente manualmente na instância do ECS. Para obter mais informações sobre como instalar o agente do CloudMonitor, consulte Instalar e desinstalar o agente do CloudMonitor para C++.

Notas de uso

Este tópico apresenta um exemplo de como instalar a versão mais recente do agente do CloudMonitor em uma instância do ECS cujo ID é i-m5e0k0bexac8tykr****.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para facilitar o uso, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de requisição

Parameter	Type	Required	Example	Description
Action	String	Yes	InstallMonitoringAgent	A operação que você deseja executar. Defina o valor como InstallMonitoringAgent.
Force	Boolean	No	true	Especifica se o agente do CloudMonitor deve ser instalado. Valores válidos: true (valor padrão): sim false: não
InstanceIds.N	String	No	i-m5e0k0bexac8tykr****	Os IDs das instâncias do ECS. Valores válidos de N: 1 a 10. Nota Especifique o parâmetro `InstallCommand` ou o parâmetro `InstanceIds`.
InstallCommand	String	No	onlyInstallNotHasAgent	Especifica se o agente do CloudMonitor deve ser instalado em todas as instâncias do ECS pertencentes à conta atual da Alibaba Cloud. Valores válidos: `onlyInstallNotHasAgent`: instala a versão mais recente do agente do CloudMonitor somente nas instâncias do ECS em que o agente não está instalado. `onlyUpgradeAgent`: atualiza o agente do CloudMonitor para a versão mais recente somente nas instâncias do ECS em que uma versão anterior do agente está instalada. `installAndUpgrade`: instala a versão mais recente do agente do CloudMonitor nas instâncias sem o agente e atualiza o agente para a versão mais recente nas instâncias que têm uma versão anterior instalada. Nota Se o parâmetro InstallCommand for definido, o parâmetro `InstanceIds` não terá efeito.

Para obter mais informações sobre parâmetros comuns de requisição, consulte Parâmetros comuns.

Parâmetros de resposta

Parameter	Type	Example	Description
Code	String	200	O código de status HTTP. Nota O código de status 200 indica que a chamada foi bem-sucedida.
Message	String	The specified resource is not found.	A mensagem de erro.
RequestId	String	0BDAF8A8-04DC-5F0C-90E4-724D42C41945	O ID da requisição.
Success	Boolean	true	Indica se a chamada foi bem-sucedida. Valores válidos: true: a chamada foi bem-sucedida. false: a chamada falhou.

Exemplos

Exemplos de requisição

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

Exemplos de resposta bem-sucedida

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

Formato JSON

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

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

Códigos de erro

HTTP status code	Error code	Error message	Description
404	ResourceNotFound	The specified resource is not found.	The error message returned because the specified resource is not found.

Para ver a lista de códigos de erro, consulte Códigos de erro do serviço.