Atualiza um pipeline de um cluster Logstash.
Depuração
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:
|
| 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.