diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json index 29e508ec6c..38c58a9428 100644 --- a/output/openapi/elasticsearch-openapi.json +++ b/output/openapi/elasticsearch-openapi.json @@ -15428,6 +15428,11 @@ ], "summary": "Create or update an alias", "description": "Adds a data stream or index to an alias.", + "externalDocs": { + "description": "Aliases", + "url": "https://www.elastic.co/docs/manage-data/data-store/aliases", + "x-previousVersionUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-add-alias.html" + }, "operationId": "indices-put-alias", "parameters": [ { @@ -15465,6 +15470,11 @@ ], "summary": "Create or update an alias", "description": "Adds a data stream or index to an alias.", + "externalDocs": { + "description": "Aliases", + "url": "https://www.elastic.co/docs/manage-data/data-store/aliases", + "x-previousVersionUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-add-alias.html" + }, "operationId": "indices-put-alias-1", "parameters": [ { @@ -15578,6 +15588,11 @@ ], "summary": "Create or update an alias", "description": "Adds a data stream or index to an alias.", + "externalDocs": { + "description": "Aliases", + "url": "https://www.elastic.co/docs/manage-data/data-store/aliases", + "x-previousVersionUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-add-alias.html" + }, "operationId": "indices-put-alias-2", "parameters": [ { @@ -15615,6 +15630,11 @@ ], "summary": "Create or update an alias", "description": "Adds a data stream or index to an alias.", + "externalDocs": { + "description": "Aliases", + "url": "https://www.elastic.co/docs/manage-data/data-store/aliases", + "x-previousVersionUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-add-alias.html" + }, "operationId": "indices-put-alias-3", "parameters": [ { @@ -145970,7 +145990,19 @@ }, "examples": { "indicesPutAliasRequestExample1": { - "value": "{\n \"actions\": [\n {\n \"add\": {\n \"index\": \"my-data-stream\",\n \"alias\": \"my-alias\"\n }\n }\n ]\n}" + "summary": "Filter an alias", + "description": "The filter option uses Query DSL to limit the documents an alias can access.", + "value": "{\n \"filter\": {\n \"bool\": {\n \"filter\": [\n {\n \"range\": {\n \"@timestamp\": {\n \"gte\": \"now-1d/d\",\n \"lt\": \"now/d\"\n }\n }\n },\n {\n \"term\": {\n \"user.id\": \"kimchy\"\n }\n }\n ]\n }\n }\n}" + }, + "indicesPutAliasRequestExample2": { + "summary": "Write index", + "description": "You can use is_write_index to specify a write index or data stream for an alias. Elasticsearch routes any write requests for the alias to this index or data stream.", + "value": "{\n \"is_write_index\": true\n}" + }, + "indicesPutAliasRequestExample3": { + "summary": "Routing", + "description": "Use the routing option to route requests for an alias to a specific shard.", + "value": "{\n \"routing\": \"1\"\n}" } } } diff --git a/output/openapi/elasticsearch-serverless-openapi.json b/output/openapi/elasticsearch-serverless-openapi.json index 8366e33fce..4f0e2a5c1f 100644 --- a/output/openapi/elasticsearch-serverless-openapi.json +++ b/output/openapi/elasticsearch-serverless-openapi.json @@ -8366,6 +8366,11 @@ ], "summary": "Create or update an alias", "description": "Adds a data stream or index to an alias.", + "externalDocs": { + "description": "Aliases", + "url": "https://www.elastic.co/docs/manage-data/data-store/aliases", + "x-previousVersionUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-add-alias.html" + }, "operationId": "indices-put-alias", "parameters": [ { @@ -8403,6 +8408,11 @@ ], "summary": "Create or update an alias", "description": "Adds a data stream or index to an alias.", + "externalDocs": { + "description": "Aliases", + "url": "https://www.elastic.co/docs/manage-data/data-store/aliases", + "x-previousVersionUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-add-alias.html" + }, "operationId": "indices-put-alias-1", "parameters": [ { @@ -8516,6 +8526,11 @@ ], "summary": "Create or update an alias", "description": "Adds a data stream or index to an alias.", + "externalDocs": { + "description": "Aliases", + "url": "https://www.elastic.co/docs/manage-data/data-store/aliases", + "x-previousVersionUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-add-alias.html" + }, "operationId": "indices-put-alias-2", "parameters": [ { @@ -8553,6 +8568,11 @@ ], "summary": "Create or update an alias", "description": "Adds a data stream or index to an alias.", + "externalDocs": { + "description": "Aliases", + "url": "https://www.elastic.co/docs/manage-data/data-store/aliases", + "x-previousVersionUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-add-alias.html" + }, "operationId": "indices-put-alias-3", "parameters": [ { @@ -87978,7 +87998,19 @@ }, "examples": { "indicesPutAliasRequestExample1": { - "value": "{\n \"actions\": [\n {\n \"add\": {\n \"index\": \"my-data-stream\",\n \"alias\": \"my-alias\"\n }\n }\n ]\n}" + "summary": "Filter an alias", + "description": "The filter option uses Query DSL to limit the documents an alias can access.", + "value": "{\n \"filter\": {\n \"bool\": {\n \"filter\": [\n {\n \"range\": {\n \"@timestamp\": {\n \"gte\": \"now-1d/d\",\n \"lt\": \"now/d\"\n }\n }\n },\n {\n \"term\": {\n \"user.id\": \"kimchy\"\n }\n }\n ]\n }\n }\n}" + }, + "indicesPutAliasRequestExample2": { + "summary": "Write index", + "description": "You can use is_write_index to specify a write index or data stream for an alias. Elasticsearch routes any write requests for the alias to this index or data stream.", + "value": "{\n \"is_write_index\": true\n}" + }, + "indicesPutAliasRequestExample3": { + "summary": "Routing", + "description": "Use the routing option to route requests for an alias to a specific shard.", + "value": "{\n \"routing\": \"1\"\n}" } } } diff --git a/output/schema/schema.json b/output/schema/schema.json index 2154a9c540..8842951619 100644 --- a/output/schema/schema.json +++ b/output/schema/schema.json @@ -8516,7 +8516,10 @@ "description": "Create or update an alias.\nAdds a data stream or index to an alias.", "docId": "alias-update", "docUrl": "https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-alias", - "extPreviousVersionDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/8.18/indices-add-alias.html", + "extDocDescription": "Aliases", + "extDocId": "aliases", + "extDocUrl": "https://www.elastic.co/docs/manage-data/data-store/aliases", + "extPreviousVersionDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-add-alias.html", "name": "indices.put_alias", "request": { "name": "Request", @@ -9527,7 +9530,7 @@ "description": "Create or update an alias.\nAdds a data stream or index to an alias.", "docId": "aliases-update", "docUrl": "https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-update-aliases", - "extPreviousVersionDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/8.18/indices-aliases.html", + "extPreviousVersionDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-aliases.html", "name": "indices.update_aliases", "request": { "name": "Request", @@ -159859,8 +159862,22 @@ "language": "Java" } ], - "method_request": "POST _aliases", - "value": "{\n \"actions\": [\n {\n \"add\": {\n \"index\": \"my-data-stream\",\n \"alias\": \"my-alias\"\n }\n }\n ]\n}" + "description": "The filter option uses Query DSL to limit the documents an alias can access.", + "method_request": "POST /my-index-2099.05.06-000001/_alias/my-alias", + "summary": "Filter an alias", + "value": "{\n \"filter\": {\n \"bool\": {\n \"filter\": [\n {\n \"range\": {\n \"@timestamp\": {\n \"gte\": \"now-1d/d\",\n \"lt\": \"now/d\"\n }\n }\n },\n {\n \"term\": {\n \"user.id\": \"kimchy\"\n }\n }\n ]\n }\n }\n}" + }, + "indicesPutAliasRequestExample2": { + "description": "You can use is_write_index to specify a write index or data stream for an alias. Elasticsearch routes any write requests for the alias to this index or data stream.", + "method_request": "POST /logs-my_app-default/_alias/logs", + "summary": "Write index", + "value": "{\n \"is_write_index\": true\n}" + }, + "indicesPutAliasRequestExample3": { + "description": "Use the routing option to route requests for an alias to a specific shard.", + "method_request": "POST /my-index-2099.05.06-000001/_alias/my-alias", + "summary": "Routing", + "value": "{\n \"routing\": \"1\"\n}" } }, "inherits": { @@ -159929,7 +159946,7 @@ } } ], - "specLocation": "indices/put_alias/IndicesPutAliasRequest.ts#L25-L103" + "specLocation": "indices/put_alias/IndicesPutAliasRequest.ts#L25-L104" }, { "kind": "response", diff --git a/specification/_doc_ids/table.csv b/specification/_doc_ids/table.csv index 6f0b278ef9..54c511b5bb 100644 --- a/specification/_doc_ids/table.csv +++ b/specification/_doc_ids/table.csv @@ -2,8 +2,9 @@ doc_id,doc_url,previous_version_doc_url,description ack-watch, https://www.elastic.co/docs/explore-analyze/alerts-cases/watcher/actions#example,, apis,https://www.elastic.co/docs/api/doc/elasticsearch,, add-nodes,https://www.elastic.co/docs/deploy-manage/maintenance/add-and-remove-elasticsearch-nodes,, -alias-update,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-alias,https://www.elastic.co/guide/en/elasticsearch/reference/8.18/indices-add-alias.html, -aliases-update,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-update-aliases,https://www.elastic.co/guide/en/elasticsearch/reference/8.18/indices-aliases.html, +alias-update,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-alias,https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-add-alias.html,Create or update an alias +aliases,https://www.elastic.co/docs/manage-data/data-store/aliases,,Aliases +aliases-update,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-update-aliases,https://www.elastic.co/guide/en/elasticsearch/reference/8.19/indices-aliases.html,Create or update aliases alibabacloud-api-keys,https://opensearch.console.aliyun.com/cn-shanghai/rag/api-key,, analysis-analyzers,https://www.elastic.co/docs/reference/text-analysis/analyzer-reference,, amazonbedrock-models,https://docs.aws.amazon.com/bedrock/latest/userguide/models-supported.html,, diff --git a/specification/indices/put_alias/IndicesPutAliasRequest.ts b/specification/indices/put_alias/IndicesPutAliasRequest.ts index efefc114ae..b45196c063 100644 --- a/specification/indices/put_alias/IndicesPutAliasRequest.ts +++ b/specification/indices/put_alias/IndicesPutAliasRequest.ts @@ -29,6 +29,7 @@ import { Duration } from '@_types/Time' * @availability stack stability=stable * @availability serverless stability=stable visibility=public * @doc_id alias-update + * @ext_doc_id aliases */ export interface Request extends RequestBase { urls: [ diff --git a/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample1.yaml b/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample1.yaml index 0fb6621d7c..e91356509f 100644 --- a/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample1.yaml +++ b/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample1.yaml @@ -1,23 +1,26 @@ -# summary: indices/aliases.asciidoc:10 -method_request: POST _aliases -# description: '' +summary: Filter an alias +method_request: POST /my-index-2099.05.06-000001/_alias/my-alias +description: The filter option uses Query DSL to limit the documents an alias can access. # type: request -value: "{ - - \ \"actions\": [ - - \ { - - \ \"add\": { - - \ \"index\": \"my-data-stream\", - - \ \"alias\": \"my-alias\" - - \ } - - \ } - - \ ] - - }" +value: |- + { + "filter": { + "bool": { + "filter": [ + { + "range": { + "@timestamp": { + "gte": "now-1d/d", + "lt": "now/d" + } + } + }, + { + "term": { + "user.id": "kimchy" + } + } + ] + } + } + } diff --git a/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample2.yaml b/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample2.yaml new file mode 100644 index 0000000000..3325f25f1e --- /dev/null +++ b/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample2.yaml @@ -0,0 +1,10 @@ +summary: Write index +method_request: POST /logs-my_app-default/_alias/logs +description: + You can use is_write_index to specify a write index or data stream for an alias. Elasticsearch routes any write + requests for the alias to this index or data stream. +# type: request +value: |- + { + "is_write_index": true + } diff --git a/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample3.yaml b/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample3.yaml new file mode 100644 index 0000000000..feb3b68657 --- /dev/null +++ b/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample3.yaml @@ -0,0 +1,8 @@ +summary: Routing +method_request: POST /my-index-2099.05.06-000001/_alias/my-alias +description: Use the routing option to route requests for an alias to a specific shard. +# type: request +value: |- + { + "routing": "1" + }