From d961f5d023f373c3348b3f7bf021d615efc07e3e Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Wed, 11 Dec 2024 12:04:18 +0100 Subject: [PATCH] Adds ingest API request and response examples (#2996) (#3269) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Lisa Cawley (cherry picked from commit 204550525b924151f35a3aac1d6e9f070f3ade9f) Co-authored-by: István Zoltán Szabó --- .../get_pipeline/GetPipelineResponseExample1.yaml | 9 +++++++++ .../put_pipeline/PutPipelineRequestExample1.yaml | 9 +++++++++ .../put_pipeline/PutPipelineRequestExample2.yaml | 11 +++++++++++ .../simulate/SimulatePipelineRequestExample1.yaml | 12 ++++++++++++ .../SimulatePipelineResponseExample1.yaml | 15 +++++++++++++++ 5 files changed, 56 insertions(+) create mode 100644 specification/ingest/get_pipeline/GetPipelineResponseExample1.yaml create mode 100644 specification/ingest/put_pipeline/PutPipelineRequestExample1.yaml create mode 100644 specification/ingest/put_pipeline/PutPipelineRequestExample2.yaml create mode 100644 specification/ingest/simulate/SimulatePipelineRequestExample1.yaml create mode 100644 specification/ingest/simulate/SimulatePipelineResponseExample1.yaml diff --git a/specification/ingest/get_pipeline/GetPipelineResponseExample1.yaml b/specification/ingest/get_pipeline/GetPipelineResponseExample1.yaml new file mode 100644 index 0000000000..36dad4236d --- /dev/null +++ b/specification/ingest/get_pipeline/GetPipelineResponseExample1.yaml @@ -0,0 +1,9 @@ +summary: A successful response for retrieving information about an ingest pipeline. +# description: '' +# type: response +# response_code: 200 +value: + "{\n \"my-pipeline-id\" : {\n \"description\" : \"describe pipeline\",\n\ + \ \"version\" : 123,\n \"processors\" : [\n {\n \"set\" : {\n\ + \ \"field\" : \"foo\",\n \"value\" : \"bar\"\n }\n \ + \ }\n ]\n }\n}" diff --git a/specification/ingest/put_pipeline/PutPipelineRequestExample1.yaml b/specification/ingest/put_pipeline/PutPipelineRequestExample1.yaml new file mode 100644 index 0000000000..3a3870ce01 --- /dev/null +++ b/specification/ingest/put_pipeline/PutPipelineRequestExample1.yaml @@ -0,0 +1,9 @@ +summary: Create an ingest pipeline. +# method_request: PUT _ingest/pipeline/my-pipeline-id +# description: '' +# type: request +value: + "{\n \"description\" : \"My optional pipeline description\",\n \"processors\"\ + \ : [\n {\n \"set\" : {\n \"description\" : \"My optional processor\ + \ description\",\n \"field\": \"my-keyword-field\",\n \"value\": \"\ + foo\"\n }\n }\n ]\n}" diff --git a/specification/ingest/put_pipeline/PutPipelineRequestExample2.yaml b/specification/ingest/put_pipeline/PutPipelineRequestExample2.yaml new file mode 100644 index 0000000000..a36e912842 --- /dev/null +++ b/specification/ingest/put_pipeline/PutPipelineRequestExample2.yaml @@ -0,0 +1,11 @@ +summary: Create an ingest pipeline with metadata. +# method_request: PUT /_ingest/pipeline/my-pipeline-id +description: You can use the `_meta` parameter to add arbitrary metadata to a pipeline. +type: request +value: + "{\n \"description\" : \"My optional pipeline description\",\n \"processors\"\ + \ : [\n {\n \"set\" : {\n \"description\" : \"My optional processor\ + \ description\",\n \"field\": \"my-keyword-field\",\n \"value\": \"\ + foo\"\n }\n }\n ],\n \"_meta\": {\n \"reason\": \"set my-keyword-field\ + \ to foo\",\n \"serialization\": {\n \"class\": \"MyPipeline\",\n \"\ + id\": 10\n }\n }\n}" diff --git a/specification/ingest/simulate/SimulatePipelineRequestExample1.yaml b/specification/ingest/simulate/SimulatePipelineRequestExample1.yaml new file mode 100644 index 0000000000..40d368cd69 --- /dev/null +++ b/specification/ingest/simulate/SimulatePipelineRequestExample1.yaml @@ -0,0 +1,12 @@ +summary: Run an ingest pipeline against a set of provided documents. +# method_request: POST /_ingest/pipeline/_simulate +description: You can specify the used pipeline either in the request body or as a path parameter. +# type: request +value: + "{\n \"pipeline\" :\n {\n \"description\": \"_description\",\n \"processors\"\ + : [\n {\n \"set\" : {\n \"field\" : \"field2\",\n \ + \ \"value\" : \"_value\"\n }\n }\n ]\n },\n \"docs\": [\n {\n\ + \ \"_index\": \"index\",\n \"_id\": \"id\",\n \"_source\": {\n \ + \ \"foo\": \"bar\"\n }\n },\n {\n \"_index\": \"index\",\n\ + \ \"_id\": \"id\",\n \"_source\": {\n \"foo\": \"rab\"\n }\n\ + \ }\n ]\n}" diff --git a/specification/ingest/simulate/SimulatePipelineResponseExample1.yaml b/specification/ingest/simulate/SimulatePipelineResponseExample1.yaml new file mode 100644 index 0000000000..5a8077a5bd --- /dev/null +++ b/specification/ingest/simulate/SimulatePipelineResponseExample1.yaml @@ -0,0 +1,15 @@ +summary: A successful response for running an ingest pipeline against a set of provided documents. +# description: '' +# type: response +# response_code: 200 +value: + "{\n \"docs\": [\n {\n \"doc\": {\n \"_id\": \"id\"\ + ,\n \"_index\": \"index\",\n \"_version\": \"-3\",\n \ + \ \"_source\": {\n \"field2\": \"_value\",\n \"\ + foo\": \"bar\"\n },\n \"_ingest\": {\n \"timestamp\"\ + : \"2017-05-04T22:30:03.187Z\"\n }\n }\n },\n {\n \ + \ \"doc\": {\n \"_id\": \"id\",\n \"_index\": \"index\"\ + ,\n \"_version\": \"-3\",\n \"_source\": {\n \ + \ \"field2\": \"_value\",\n \"foo\": \"rab\"\n },\n \ + \ \"_ingest\": {\n \"timestamp\": \"2017-05-04T22:30:03.188Z\"\ + \n }\n }\n }\n ]\n}"