diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json index e55cff53d4..181ed6b5d2 100644 --- a/output/openapi/elasticsearch-openapi.json +++ b/output/openapi/elasticsearch-openapi.json @@ -15168,6 +15168,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": [ { @@ -15205,6 +15210,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": [ { @@ -15318,6 +15328,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": [ { @@ -15355,6 +15370,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": [ { @@ -146264,7 +146284,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 31ee8671e9..8b00a2935b 100644 --- a/output/openapi/elasticsearch-serverless-openapi.json +++ b/output/openapi/elasticsearch-serverless-openapi.json @@ -8441,6 +8441,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": [ { @@ -8478,6 +8483,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": [ { @@ -8591,6 +8601,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": [ { @@ -8628,6 +8643,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": [ { @@ -89129,7 +89149,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 59afa0a176..977cf2c5e5 100644 --- a/output/schema/schema.json +++ b/output/schema/schema.json @@ -8565,7 +8565,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", @@ -9619,7 +9622,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", @@ -159930,8 +159933,22 @@ "language": "curl" } ], - "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": { @@ -160000,7 +160017,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 349933ca9a..9fcc724b7b 100644 --- a/specification/_doc_ids/table.csv +++ b/specification/_doc_ids/table.csv @@ -4,8 +4,9 @@ apis,https://www.elastic.co/docs/api/doc/elasticsearch,, add-nodes,https://www.elastic.co/docs/deploy-manage/maintenance/add-and-remove-elasticsearch-nodes,, ai21-api-models,https://docs.ai21.com/docs/jamba-foundation-models,, ai21-rate-limit,https://docs.ai21.com/reference/api-rate-limits,, -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" + }