Instale o Agent - : Central de Documentação do Alibaba Cloud

Esta operação importa uma instância ECS para o EDAS sem reinstalar o sistema operacional. Recomendamos usar esta operação para importar instâncias ECS.

Depuração

Execute esta operação no OpenAPI Explorer para evitar o cálculo de assinaturas. Após uma chamada bem-sucedida, o OpenAPI Explorer gera automaticamente um código SDK de exemplo.

Cabeçalhos da requisição

Esta operação usa cabeçalhos de requisição comuns. Não são necessários cabeçalhos especiais. Para mais informações, consulte Parâmetros comuns de requisição.

Sintaxe da requisição

POST /pop/v5/ecss/install_agent HTTP/1.1

Parâmetros da requisição

Nome	Tipo	Localização	Obrigatório	Exemplo	Descrição
ClusterId	String	Query	Sim	b3e3f77b-462e---bec8727a4dc8	O ID do cluster.
InstanceIds	String	Query	Sim	2ze7s2v0b789k60pk1af	Os IDs das instâncias. Especifique vários IDs separados por vírgulas (,). Exemplo: instanceId1,instanceId2.
DoAsync	Boolean	Query	Não	true	Este parâmetro está obsoleto.

Dados retornados

Nome	Tipo	Exemplo	Descrição
Code	Integer	200	Código
Message	String	success	Informação
RequestId	String	b197-40ab-9155-7ca7	O ID exclusivo da requisição.
ExecutionResultList	Array of ExecutionResult		Os resultados da execução.
ExecutionResult
Status	String	OK	O status de execução do comando.
FinishedTime	String	20**-11-10T07:02:17Z	O horário de conclusão da instalação.
InstanceId	String	i-2ze7s2v0b789k***	O ID da instância.
InvokeRecordStatus	String	Finished	O status da instalação.
Success	Boolean	true	Indica se a instalação foi bem-sucedida.

Exemplos

Exemplo de requisição

POST /pop/v5/ecss/install_agent HTTP/1.1
Common request headers
{
  "ClusterId": "b3e3f77b-462e-****-****-bec8727a4dc8",
  "InstanceIds": "2ze7s2v0b789k60pk1af"
}

Exemplos de resposta

Formato XML

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

<ExecutionResultList>
    <ExecutionResult>
        <InvokeRecordStatus>Finished</InvokeRecordStatus>
        <Status>OK</Status>
        <FinishedTime>2019-11-10T07:02:17Z</FinishedTime>
        <InstanceId>i-2ze7s2v0b789k60pk1af</InstanceId>
        <Success>true</Success>
    </ExecutionResult>
</ExecutionResultList>
<Message>success</Message>
<Code>200</Code>

Formato JSON

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

{
  "ExecutionResultList" : {
    "ExecutionResult" : [ {
      "InvokeRecordStatus" : "Finished",
      "Status" : "OK",
      "FinishedTime" : "2019-11-10T07:02:17Z",
      "InstanceId" : "i-2ze7s2v0b789k60pk1af",
      "Success" : true
    } ]
  },
  "Message" : "success",
  "Code" : 200
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o Error Center.

Observações

Ao chamar esta operação, o cliente pode atingir o tempo limite durante a conexão com a API Gateway. O tempo limite padrão é de 10 segundos. Defina manualmente o tempo limite de leitura dos dados retornados pela API Gateway. Recomendamos definir esse período como 30 segundos, pois o tempo máximo de processamento da API Gateway até o serviço de backend é de 30 segundos.

Se usar o Alibaba Cloud SDK for Java, defina o tempo limite de leitura no código do cliente da seguinte forma:

java
InstallAgentRequest request = new InstallAgentRequest();
request.setSysReadTimeout(30000);  // The timeout period for the client to wait for a response from API Gateway. Unit: milliseconds.
request.setClusterId(clusterId);
........

Se usar o Alibaba Cloud SDK for Python, defina o tempo limite de leitura no código do cliente conforme abaixo:
```
python
request = InstallAgentRequest()
request.set_read_timeout(30000)
request.set_ClusterId(clusterId)
```