mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-04-26 08:07:27 -04:00
255c9a7f95
**Problem:** For historical reasons, source files for the Elasticsearch Guide's security, watcher, and Logstash API docs are housed in the `x-pack/docs` directory. This can confuse new contributors who expect Elasticsearch Guide docs to be located in `docs/reference`. **Solution:** - Move the security, watcher, and Logstash API doc source files to the `docs/reference` directory - Update doc snippet tests to use security Rel: https://github.com/elastic/platform-docs-team/issues/208
74 lines
1.9 KiB
Text
74 lines
1.9 KiB
Text
[role="xpack"]
|
|
[[logstash-api-delete-pipeline]]
|
|
=== Delete {ls} pipeline API
|
|
++++
|
|
<titleabbrev>Delete {ls} pipeline</titleabbrev>
|
|
++++
|
|
|
|
This API deletes a pipeline used for
|
|
{logstash-ref}/logstash-centralized-pipeline-management.html[{ls} Central
|
|
Management].
|
|
|
|
[[logstash-api-delete-pipeline-request]]
|
|
==== {api-request-title}
|
|
|
|
`DELETE _logstash/pipeline/<pipeline_id>`
|
|
|
|
[[logstash-api-delete-pipeline-prereqs]]
|
|
==== {api-prereq-title}
|
|
|
|
* If the {es} {security-features} are enabled, you must have the
|
|
`manage_logstash_pipelines` cluster privilege to use this API.
|
|
|
|
[[logstash-api-delete-pipeline-desc]]
|
|
==== {api-description-title}
|
|
|
|
Deletes a {ls} pipeline.
|
|
|
|
[[logstash-api-delete-pipeline-params]]
|
|
==== {api-path-parms-title}
|
|
|
|
`<pipeline_id>`::
|
|
(Required, string) Identifier for the Pipeline.
|
|
|
|
[[logstash-api-delete-pipeline-example]]
|
|
==== {api-examples-title}
|
|
|
|
The following example deletes the Pipeline named `my_pipeline`:
|
|
|
|
//////////////////////////
|
|
|
|
[source,console]
|
|
--------------------------------------------------
|
|
PUT _logstash/pipeline/my_pipeline
|
|
{
|
|
"description": "Sample Pipeline for illustration purposes",
|
|
"last_modified": "2021-01-02T02:50:51.250Z",
|
|
"pipeline_metadata": {
|
|
"type": "logstash_pipeline",
|
|
"version": "1"
|
|
},
|
|
"username": "elastic",
|
|
"pipeline": "input {}\n filter { grok {} }\n output {}",
|
|
"pipeline_settings": {
|
|
"pipeline.workers": 1,
|
|
"pipeline.batch.size": 125,
|
|
"pipeline.batch.delay": 50,
|
|
"queue.type": "memory",
|
|
"queue.max_bytes": "1gb",
|
|
"queue.checkpoint.writes": 1024
|
|
}
|
|
}
|
|
--------------------------------------------------
|
|
|
|
//////////////////////////
|
|
|
|
[source,console]
|
|
--------------------------------------------------
|
|
DELETE _logstash/pipeline/my_pipeline
|
|
--------------------------------------------------
|
|
// TEST[continued]
|
|
|
|
|
|
If the request succeeds, you receive an empty response with an appropriate
|
|
status code.
|