2018-06-08 13:59:39 +02:00
[[logstash-configuration-management-api-create]]
2019-09-06 18:09:57 +02:00
=== Create Logstash pipeline API
++++
2019-10-16 22:10:40 +02:00
<titleabbrev>Create Logstash pipeline</titleabbrev>
2019-09-06 18:09:57 +02:00
++++
2018-06-08 13:59:39 +02:00
2019-09-18 17:54:28 +02:00
experimental[] Create a centrally-managed Logstash pipeline, or update an existing pipeline.
2018-12-05 22:20:58 +01:00
2019-09-06 18:09:57 +02:00
[[logstash-configuration-management-api-create-request]]
2018-06-08 13:59:39 +02:00
==== Request
2020-03-20 22:33:20 +01:00
`PUT <kibana host>:<port>/api/logstash/pipeline/<id>`
2018-06-08 13:59:39 +02:00
2019-09-06 18:09:57 +02:00
[[logstash-configuration-management-api-create-params]]
==== Path parameters
2018-06-08 13:59:39 +02:00
2019-09-06 18:09:57 +02:00
`id`::
(Required, string) The pipeline ID. Only alphanumeric characters, hyphens, and underscores are supported.
2018-06-08 13:59:39 +02:00
2019-09-06 18:09:57 +02:00
[[logstash-configuration-management-api-create-request-body]]
==== Request body
2018-06-08 13:59:39 +02:00
2020-07-14 23:25:31 +02:00
`id`::
(Required, string) The pipeline ID.
2019-09-06 18:09:57 +02:00
`description`::
(Optional, string) The pipeline description.
2018-06-08 13:59:39 +02:00
2019-09-06 18:09:57 +02:00
`pipeline`::
(Required, string) The pipeline definition.
2018-06-08 13:59:39 +02:00
2019-09-06 18:09:57 +02:00
`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`.
2018-06-08 13:59:39 +02:00
2019-09-06 18:09:57 +02:00
[[logstash-configuration-management-api-create-codes]]
==== Response code
2018-06-08 13:59:39 +02:00
2019-09-06 18:09:57 +02:00
`204 No Content`::
Indicates a successful call.
2018-06-08 13:59:39 +02:00
[float]
2019-09-06 18:09:57 +02:00
[[logstash-configuration-management-api-create-example]]
==== Example
2018-06-08 13:59:39 +02:00
2020-03-20 22:33:20 +01:00
[source,sh]
2018-06-08 13:59:39 +02:00
--------------------------------------------------
2020-07-14 21:59:21 +02:00
$ curl -X PUT api/logstash/pipeline/hello-world
2018-06-08 13:59:39 +02:00
{
"pipeline": "input { stdin {} } output { stdout {} }",
"settings": {
2019-04-02 20:47:42 +02:00
"queue.type": "persisted"
2018-06-08 13:59:39 +02:00
}
}
--------------------------------------------------
// KIBANA