Todos os produtos
Search
Central de documentação

Elasticsearch:UpdatePipelines

Última atualização: Jun 27, 2026

Atualiza um pipeline de um cluster Logstash.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Cabeçalhos da requisição

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

Sintaxe da requisição

PUT /openapi/logstashes/{InstanceId}/pipelines HTTP/1.1

Parâmetros da requisição

Parâmetro

Tipo

Posição

Obrigatório

Exemplo

Descrição

InstanceId

String

Path

Sim

ls-cn-oew1qbgl****

ID do cluster Logstash.

trigger

Boolean

Query

Não

false

Defina se a aplicação será implantada imediatamente após a criação.

clientToken

String

Query

Não

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

Token do cliente usado para garantir a idempotência da requisição. Gere o token no cliente e garanta que seja único entre requisições diferentes. O token aceita apenas caracteres ASCII e não pode exceder 64 caracteres.

String

Body

Não

[ { "pipelineId": "test", "config": "input {\n\n}\nfilter {\n\n}\noutput {\n \n}" } ]

Especifique as informações atualizadas do pipeline.

RequestBody

Insira também um array de pipelines em formato JSON no parâmetro RequestBody para especificar as informações atualizadas do pipeline.

**

Parâmetro

**

**

Tipo

**

**

Obrigatório

**

**

Exemplo

**

**

Descrição

**

pipelineId

String

Sim

pipeline-test

ID do pipeline a ser atualizado.

description

String

Não

this is a test

Descrição do pipeline.

config

String

Sim

input { } filter { } output { }

Configurações do pipeline.

workers

Integer

Não

2

Número de threads de trabalho do pipeline.

batchSize

Integer

Não

125

Tamanho do lote do pipeline.

batchDelay

Integer

Não

50

Atraso do lote do pipeline. Unidade: milissegundos.

queueType

String

Não

MEMORY

Tipo da fila. Valores suportados: MEMORY e PERSISTED.

pipelineStatus

String

Não

RUNNING

Status do pipeline. Este parâmetro é obrigatório quando o parâmetro trigger está definido como true. Valores válidos: NOT_DEPLOYED, RUNNING e DELETED.

queueMaxBytes

Integer

Não

1024

Número máximo de bytes na fila.

queueCheckPointWrites

Integer

Não

1024

Número de gravações de ponto de verificação da fila.

Exemplo de instrução:


[
    {
        "pipelineId": "test",
        "config": "input {\n\n}\nfilter {\n\n}\noutput {\n \n}"
    }
]

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
Result Boolean true

Resultado retornado:

  • true: atualização bem-sucedida.
  • false: falha na atualização.
RequestId String 5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****

ID da requisição.

Exemplos

Exemplos de requisições

PUT /openapi/logstashes/ls-cn-oew1qbgl****/pipelines?clientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF****&trigger=false HTTP/1.1
Common request parameters
[
{"pipelineId":"test", "config":"input {\n\n}\nfilter {\n\n}\noutput {\n \n}"},

{"pipelineId":"test1", "config":"input {\n\n}\nfilter {\n\n}\noutput {\n  \n}"}
]

Exemplos de respostas de sucesso

Formato JSON

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

{
  "Result" : true,
  "RequestId" : "734F9DEC-74AC-4D6E-B97F-FFDAA90B****"
}

Código de status HTTP

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.