diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json index 68498e0257..48bcbfd4b0 100644 --- a/output/openapi/elasticsearch-openapi.json +++ b/output/openapi/elasticsearch-openapi.json @@ -7576,7 +7576,8 @@ "tags": [ "eql" ], - "summary": "Returns the current status and available results for an async EQL search or a stored synchronous EQL search", + "summary": "Get async EQL search results", + "description": "Get the current status and available results for an async EQL search or a stored synchronous EQL search.", "operationId": "eql-get", "parameters": [ { @@ -7629,8 +7630,8 @@ "tags": [ "eql" ], - "summary": "Deletes an async EQL search or a stored synchronous EQL search", - "description": "The API also deletes results for the search.", + "summary": "Delete an async EQL search", + "description": "Delete an async EQL search or a stored synchronous EQL search.\nThe API also deletes results for the search.", "operationId": "eql-delete", "parameters": [ { @@ -7665,7 +7666,8 @@ "tags": [ "eql" ], - "summary": "Returns the current status for an async EQL search or a stored synchronous EQL search without returning results", + "summary": "Get the async EQL status", + "description": "Get the current status for an async EQL search or a stored synchronous EQL search without returning results.", "operationId": "eql-get-status", "parameters": [ { @@ -7728,7 +7730,11 @@ "tags": [ "eql" ], - "summary": "Returns results matching a query expressed in Event Query Language (EQL)", + "summary": "Get EQL search results", + "description": "Returns search results for an Event Query Language (EQL) query.\nEQL assumes each document in a data stream or index corresponds to an event.", + "externalDocs": { + "url": "https://www.elastic.co/guide/en/elasticsearch/reference/current/eql.html" + }, "operationId": "eql-search", "parameters": [ { @@ -7767,7 +7773,11 @@ "tags": [ "eql" ], - "summary": "Returns results matching a query expressed in Event Query Language (EQL)", + "summary": "Get EQL search results", + "description": "Returns search results for an Event Query Language (EQL) query.\nEQL assumes each document in a data stream or index corresponds to an event.", + "externalDocs": { + "url": "https://www.elastic.co/guide/en/elasticsearch/reference/current/eql.html" + }, "operationId": "eql-search-1", "parameters": [ { diff --git a/output/openapi/elasticsearch-serverless-openapi.json b/output/openapi/elasticsearch-serverless-openapi.json index 2f460e5736..26615e6781 100644 --- a/output/openapi/elasticsearch-serverless-openapi.json +++ b/output/openapi/elasticsearch-serverless-openapi.json @@ -4735,7 +4735,8 @@ "tags": [ "eql" ], - "summary": "Returns the current status and available results for an async EQL search or a stored synchronous EQL search", + "summary": "Get async EQL search results", + "description": "Get the current status and available results for an async EQL search or a stored synchronous EQL search.", "operationId": "eql-get", "parameters": [ { @@ -4788,8 +4789,8 @@ "tags": [ "eql" ], - "summary": "Deletes an async EQL search or a stored synchronous EQL search", - "description": "The API also deletes results for the search.", + "summary": "Delete an async EQL search", + "description": "Delete an async EQL search or a stored synchronous EQL search.\nThe API also deletes results for the search.", "operationId": "eql-delete", "parameters": [ { @@ -4824,7 +4825,8 @@ "tags": [ "eql" ], - "summary": "Returns the current status for an async EQL search or a stored synchronous EQL search without returning results", + "summary": "Get the async EQL status", + "description": "Get the current status for an async EQL search or a stored synchronous EQL search without returning results.", "operationId": "eql-get-status", "parameters": [ { @@ -4887,7 +4889,11 @@ "tags": [ "eql" ], - "summary": "Returns results matching a query expressed in Event Query Language (EQL)", + "summary": "Get EQL search results", + "description": "Returns search results for an Event Query Language (EQL) query.\nEQL assumes each document in a data stream or index corresponds to an event.", + "externalDocs": { + "url": "https://www.elastic.co/guide/en/elasticsearch/reference/current/eql.html" + }, "operationId": "eql-search", "parameters": [ { @@ -4926,7 +4932,11 @@ "tags": [ "eql" ], - "summary": "Returns results matching a query expressed in Event Query Language (EQL)", + "summary": "Get EQL search results", + "description": "Returns search results for an Event Query Language (EQL) query.\nEQL assumes each document in a data stream or index corresponds to an event.", + "externalDocs": { + "url": "https://www.elastic.co/guide/en/elasticsearch/reference/current/eql.html" + }, "operationId": "eql-search-1", "parameters": [ { diff --git a/output/schema/schema.json b/output/schema/schema.json index 04c7b94a24..98665528d8 100644 --- a/output/schema/schema.json +++ b/output/schema/schema.json @@ -4606,7 +4606,7 @@ "stability": "stable" } }, - "description": "Deletes an async EQL search or a stored synchronous EQL search.\nThe API also deletes results for the search.", + "description": "Delete an async EQL search.\nDelete an async EQL search or a stored synchronous EQL search.\nThe API also deletes results for the search.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/eql-search-api.html", "name": "eql.delete", "request": { @@ -4641,7 +4641,7 @@ "stability": "stable" } }, - "description": "Returns the current status and available results for an async EQL search or a stored synchronous EQL search.", + "description": "Get async EQL search results.\nGet the current status and available results for an async EQL search or a stored synchronous EQL search.", "docId": "eql-async-search-api", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/get-async-eql-search-api.html", "name": "eql.get", @@ -4677,7 +4677,7 @@ "stability": "stable" } }, - "description": "Returns the current status for an async EQL search or a stored synchronous EQL search without returning results.", + "description": "Get the async EQL status.\nGet the current status for an async EQL search or a stored synchronous EQL search without returning results.", "docId": "eql-async-search-status-api", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/get-async-eql-status-api.html", "name": "eql.get_status", @@ -4713,8 +4713,10 @@ "stability": "stable" } }, - "description": "Returns results matching a query expressed in Event Query Language (EQL)", + "description": "Get EQL search results.\nReturns search results for an Event Query Language (EQL) query.\nEQL assumes each document in a data stream or index corresponds to an event.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/eql-search-api.html", + "extDocId": "eql", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/eql.html", "name": "eql.search", "request": { "name": "Request", @@ -117468,7 +117470,7 @@ "body": { "kind": "no_body" }, - "description": "Deletes an async EQL search or a stored synchronous EQL search.\nThe API also deletes results for the search.", + "description": "Delete an async EQL search.\nDelete an async EQL search or a stored synchronous EQL search.\nThe API also deletes results for the search.", "inherits": { "type": { "name": "RequestBase", @@ -117494,7 +117496,7 @@ } ], "query": [], - "specLocation": "eql/delete/EqlDeleteRequest.ts#L23-L39" + "specLocation": "eql/delete/EqlDeleteRequest.ts#L23-L40" }, { "kind": "response", @@ -117522,7 +117524,7 @@ "body": { "kind": "no_body" }, - "description": "Returns the current status and available results for an async EQL search or a stored synchronous EQL search.", + "description": "Get async EQL search results.\nGet the current status and available results for an async EQL search or a stored synchronous EQL search.", "inherits": { "type": { "name": "RequestBase", @@ -117573,7 +117575,7 @@ } } ], - "specLocation": "eql/get/EqlGetRequest.ts#L24-L50" + "specLocation": "eql/get/EqlGetRequest.ts#L24-L51" }, { "kind": "response", @@ -117616,7 +117618,7 @@ "body": { "kind": "no_body" }, - "description": "Returns the current status for an async EQL search or a stored synchronous EQL search without returning results.", + "description": "Get the async EQL status.\nGet the current status for an async EQL search or a stored synchronous EQL search without returning results.", "inherits": { "type": { "name": "RequestBase", @@ -117642,7 +117644,7 @@ } ], "query": [], - "specLocation": "eql/get_status/EqlGetStatusRequest.ts#L23-L35" + "specLocation": "eql/get_status/EqlGetStatusRequest.ts#L23-L36" }, { "kind": "response", @@ -117977,7 +117979,7 @@ } ] }, - "description": "Returns results matching a query expressed in Event Query Language (EQL)", + "description": "Get EQL search results.\nReturns search results for an Event Query Language (EQL) query.\nEQL assumes each document in a data stream or index corresponds to an event.", "inherits": { "type": { "name": "RequestBase", @@ -118079,7 +118081,7 @@ } } ], - "specLocation": "eql/search/EqlSearchRequest.ts#L28-L125" + "specLocation": "eql/search/EqlSearchRequest.ts#L28-L129" }, { "kind": "response", diff --git a/specification/eql/delete/EqlDeleteRequest.ts b/specification/eql/delete/EqlDeleteRequest.ts index a25a673f7b..98178c64d2 100644 --- a/specification/eql/delete/EqlDeleteRequest.ts +++ b/specification/eql/delete/EqlDeleteRequest.ts @@ -21,7 +21,8 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' /** - * Deletes an async EQL search or a stored synchronous EQL search. + * Delete an async EQL search. + * Delete an async EQL search or a stored synchronous EQL search. * The API also deletes results for the search. * @rest_spec_name eql.delete * @availability stack since=7.9.0 stability=stable diff --git a/specification/eql/get/EqlGetRequest.ts b/specification/eql/get/EqlGetRequest.ts index 9e492feeff..40210d77bf 100644 --- a/specification/eql/get/EqlGetRequest.ts +++ b/specification/eql/get/EqlGetRequest.ts @@ -22,7 +22,8 @@ import { Id } from '@_types/common' import { Duration } from '@_types/Time' /** - * Returns the current status and available results for an async EQL search or a stored synchronous EQL search. + * Get async EQL search results. + * Get the current status and available results for an async EQL search or a stored synchronous EQL search. * @doc_id eql-async-search-api * @rest_spec_name eql.get * @availability stack since=7.9.0 stability=stable diff --git a/specification/eql/get_status/EqlGetStatusRequest.ts b/specification/eql/get_status/EqlGetStatusRequest.ts index 8195defc13..2510f61214 100644 --- a/specification/eql/get_status/EqlGetStatusRequest.ts +++ b/specification/eql/get_status/EqlGetStatusRequest.ts @@ -21,7 +21,8 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' /** - * Returns the current status for an async EQL search or a stored synchronous EQL search without returning results. + * Get the async EQL status. + * Get the current status for an async EQL search or a stored synchronous EQL search without returning results. * @doc_id eql-async-search-status-api * @rest_spec_name eql.get_status * @availability stack since=7.9.0 stability=stable diff --git a/specification/eql/search/EqlSearchRequest.ts b/specification/eql/search/EqlSearchRequest.ts index efb4fea993..325db1fdb1 100644 --- a/specification/eql/search/EqlSearchRequest.ts +++ b/specification/eql/search/EqlSearchRequest.ts @@ -26,9 +26,13 @@ import { Duration } from '@_types/Time' import { ResultPosition } from './types' /** + * Get EQL search results. + * Returns search results for an Event Query Language (EQL) query. + * EQL assumes each document in a data stream or index corresponds to an event. * @rest_spec_name eql.search * @availability stack since=7.9.0 stability=stable * @availability serverless stability=stable visibility=public + * @ext_doc_id eql */ export interface Request extends RequestBase { path_parts: {