Todos os produtos
Search
Central de documentação

Elasticsearch:ModifyDeployMachine

Última atualização: Jun 27, 2026

Atualiza as instâncias ECS em que um coletor está instalado.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. Após a chamada, o OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Cabeçalho da requisição

Esta operação usa apenas cabeçalhos de requisição comuns. Para mais informações, consulte Parâmetros comuns de requisição.

Estrutura da requisição


     POST /openapi/collectors/[ResId]/actions/modify-deploy-machines HTTP/1.1 
   

Parâmetros da requisição

Parâmetro

Tipo

Posição

Obrigatório

Exemplo

Descrição

ResId

String

Path

Sim

ct-cn-xb1i7q79u65nk****

ID do coletor.

ClientToken

String

Query

Não

5A2CFF0E-5718-45B5-9D4D-70B3FF****

Token de cliente usado para garantir a idempotência da requisição. O cliente gera esse valor, que deve ser exclusivo entre requisições. Comprimento máximo: 64 caracteres ASCII.

RequestBody

Inclua os seguintes parâmetros no RequestBody para especificar a instância ECS de destino.

**

Parâmetro

**

**

Tipo

**

**

Obrigatório

**

**

Exemplo

**

**

Descrição

**

machines

List

Sim

Informações sobre as instâncias ECS de destino.

└instanceId

String

Sim

i-bp11u91xgubypcuz****

ID da instância ECS.

type

String

Sim

ECSInstanceId

Tipo de máquina em que o coletor será implantado. Apenas ECSInstanceId (instância ECS) é compatível.

configType

String

Sim

collectorDeployMachine

Tipo de configuração. Apenas collectorDeployMachine (máquina de implantação do coletor) é compatível.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
RequestId String C37CE536-6C0F-4778-9B59-6D94C7F7EB63

ID da requisição.

Result Boolean true

Indica se a atualização foi bem-sucedida:

  • true: Operação concluída com sucesso.
  • false: Falha na operação.

Exemplos

Exemplos de requisições


     POST /openapi/collectors/ct-cn-xb1i7q79u65nk **** /actions/modify-deploy-machines HTTP/1.1 public request header {"machines":[ {"instanceId":"i-bp1ei8ysh7orb6eq ****"}, {"instanceId":"i-bp12plyjhrv7eobp ****"} ], "type":"ECSInstanceId", "configType":"collectorDeployMachine"} 
   

Exemplos de respostas de sucesso

Formato JSON


     { "Result": true, "RequestId": "C37CE536-6C0F-4778-9B59-6D94C7F7EB63" } 
   

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros de API.