Create Logstash pipeline API

edit

[preview] This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Create a centrally-managed Logstash pipeline, or update an existing pipeline.

Request

edit

PUT /api/logstash/pipeline/<id>

Path parameters

edit
id
(Required, string) The pipeline ID. Only alphanumeric characters, hyphens, and underscores are supported.

Request body

edit
description
(Optional, string) The pipeline description.
pipeline
(Required, string) The pipeline definition.
settings
(Optional, object) The pipeline settings. Supported settings, represented as object keys, are pipeline.workers, pipeline.batch.size, pipeline.batch.delay, queue.type, queue.max_bytes, and queue.checkpoint.writes.

Response code

edit
204 No Content
Indicates a successful call.

Example

edit
PUT api/logstash/pipeline/hello-world
{
  "pipeline": "input { stdin {} } output { stdout {} }",
  "settings": {
    "queue.type": "persisted"
  }
}