* [DOCS] API intro * Logstash configuration management * Reformatting * Comments from Josh * Commets from Gail * Fixed broken things
53 lines
1.4 KiB
Plaintext
53 lines
1.4 KiB
Plaintext
[[logstash-configuration-management-api-create]]
|
|
=== Create Logstash pipeline API
|
|
++++
|
|
<titleabbrev>Create Logstash pipeline</titleabbrev>
|
|
++++
|
|
|
|
experimental[] Create a centrally-managed Logstash pipeline, or update an existing pipeline.
|
|
|
|
[[logstash-configuration-management-api-create-request]]
|
|
==== Request
|
|
|
|
`PUT /api/logstash/pipeline/<id>`
|
|
|
|
[[logstash-configuration-management-api-create-params]]
|
|
==== Path parameters
|
|
|
|
`id`::
|
|
(Required, string) The pipeline ID. Only alphanumeric characters, hyphens, and underscores are supported.
|
|
|
|
[[logstash-configuration-management-api-create-request-body]]
|
|
==== Request body
|
|
|
|
`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`.
|
|
|
|
[[logstash-configuration-management-api-create-codes]]
|
|
==== Response code
|
|
|
|
`204 No Content`::
|
|
Indicates a successful call.
|
|
|
|
[float]
|
|
[[logstash-configuration-management-api-create-example]]
|
|
==== Example
|
|
|
|
[source,js]
|
|
--------------------------------------------------
|
|
PUT api/logstash/pipeline/hello-world
|
|
{
|
|
"pipeline": "input { stdin {} } output { stdout {} }",
|
|
"settings": {
|
|
"queue.type": "persisted"
|
|
}
|
|
}
|
|
--------------------------------------------------
|
|
// KIBANA
|