Todos os produtos
Search
Central de documentação

Elasticsearch:ReinstallCollector

Última atualização: Jun 27, 2026

Use a API ReinstallCollector para reinstalar um collector cuja instalação falhou durante a criação.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta operação no OpenAPI Explorer. Após a execução, o OpenAPI Explorer gera dinamicamente exemplos de código da operação para diferentes SDKs.

Cabeçalho da requisição

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

Estrutura da requisição


     POST /openapi/collectors/[ResId]/actions/reinstall HTTP/1.1 
   

Parâmetros da requisição

Parâmetro

Tipo

Posição

Obrigatório

Exemplo

Descrição

ResId

String

Path

Sim

ct-cn-l871nd0u73c45****

ID do collector.

ClientToken

String

Query

Não

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

Garante a idempotência da requisição. O cliente gera esse valor, que deve ser único entre requisições distintas. O comprimento máximo é de 64 caracteres ASCII.

RequestBody

Preencha os seguintes parâmetros no RequestBody para especificar as informações da máquina em que se tentará reinstalar o collector.

**

Parâmetro

**

**

Tipo

**

**

Obrigatório

**

**

Exemplo

**

**

Descrição

**

nodes

List<String\>

Sim

["ecs-cn-abc"]

ID da instância ECS na qual se repetirá a instalação do collector.

restartType

String

Sim

nodeEcsId

Tipo de alvo para a nova tentativa de instalação. Atualmente, apenas nodeEcsId tem suporte, indicando uma instância ECS.

Exemplo:


     { "restartType": "nodeEcsId", "nodes":["i-bp1gyhphjaj73jsr****","i-bp10piq1mkfnyw9t****"] } 
   

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
RequestId String 5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****

ID da requisição.

Result Boolean true

Resultado da requisição:

  • true: Instalação bem-sucedida.
  • false: Falha na instalação.

Exemplos

Exemplos de requisição


     POST /openapi/collectors/ct-cn-l871nd0u73c45 **** /actions/reinstall HTTP/1.1 public request header {"restartType": "nodeEcsId", "nodes": ["i-bp1gyhphjaj73jsr****","i-bp10piq1mkfnyw9t****"] } 
   

Exemplos de resposta de sucesso

Formato JSON


     { "Result": true, "RequestId": "F18CF67E-633D-41E8-9172-7DE08052****" } 
   

Códigos de erro

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