From 0dee3e7ecd486d9c43d172a9b4526280550ccfc1 Mon Sep 17 00:00:00 2001 From: lcawl Date: Mon, 22 Sep 2025 15:19:10 -0700 Subject: [PATCH 1/3] Fix alias API examples --- specification/_doc_ids/table.csv | 1 + .../put_alias/IndicesPutAliasRequest.ts | 1 + .../indicesPutAliasRequestExample1.yaml | 47 ++++++++++--------- .../indicesPutAliasRequestExample2.yaml | 8 ++++ .../indicesPutAliasRequestExample3.yaml | 8 ++++ 5 files changed, 43 insertions(+), 22 deletions(-) create mode 100644 specification/indices/put_alias/examples/request/indicesPutAliasRequestExample2.yaml create mode 100644 specification/indices/put_alias/examples/request/indicesPutAliasRequestExample3.yaml diff --git a/specification/_doc_ids/table.csv b/specification/_doc_ids/table.csv index 349933ca9a..f46d873cdb 100644 --- a/specification/_doc_ids/table.csv +++ b/specification/_doc_ids/table.csv @@ -5,6 +5,7 @@ add-nodes,https://www.elastic.co/docs/deploy-manage/maintenance/add-and-remove-e 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,https://www.elastic.co/docs/manage-data/data-store/aliases,https://www.elastic.co/guide/en/elasticsearch/reference/8.19/aliases.html,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.18/indices-aliases.html, 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,, 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..da5a0d5633 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" + } + } + ] + } + } + } \ No newline at end of file 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..45e599f51c --- /dev/null +++ b/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample2.yaml @@ -0,0 +1,8 @@ +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 + } \ No newline at end of file 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..5d7056118c --- /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" + } \ No newline at end of file From b12826aa0cefdaf25080ea9fbf3adef60b081f72 Mon Sep 17 00:00:00 2001 From: lcawl Date: Mon, 22 Sep 2025 15:30:05 -0700 Subject: [PATCH 2/3] Generate output --- output/openapi/elasticsearch-openapi.json | 34 ++++++++++++++++++- .../elasticsearch-serverless-openapi.json | 34 ++++++++++++++++++- output/schema/schema.json | 27 ++++++++++++--- specification/_doc_ids/table.csv | 6 ++-- .../indicesPutAliasRequestExample1.yaml | 4 +-- .../indicesPutAliasRequestExample2.yaml | 2 +- .../indicesPutAliasRequestExample3.yaml | 2 +- 7 files changed, 95 insertions(+), 14 deletions(-) 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 f46d873cdb..9fcc724b7b 100644 --- a/specification/_doc_ids/table.csv +++ b/specification/_doc_ids/table.csv @@ -4,9 +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,https://www.elastic.co/docs/manage-data/data-store/aliases,https://www.elastic.co/guide/en/elasticsearch/reference/8.19/aliases.html,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.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/examples/request/indicesPutAliasRequestExample1.yaml b/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample1.yaml index da5a0d5633..e91356509f 100644 --- a/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample1.yaml +++ b/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample1.yaml @@ -2,7 +2,7 @@ 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: |- +value: |- { "filter": { "bool": { @@ -23,4 +23,4 @@ value: |- ] } } - } \ No newline at end of file + } diff --git a/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample2.yaml b/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample2.yaml index 45e599f51c..aed37b342e 100644 --- a/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample2.yaml +++ b/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample2.yaml @@ -5,4 +5,4 @@ description: You can use is_write_index to specify a write index or data stream value: |- { "is_write_index": true - } \ No newline at end of file + } diff --git a/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample3.yaml b/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample3.yaml index 5d7056118c..feb3b68657 100644 --- a/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample3.yaml +++ b/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample3.yaml @@ -5,4 +5,4 @@ description: Use the routing option to route requests for an alias to a specific value: |- { "routing": "1" - } \ No newline at end of file + } From 0b72609cfe30578ebcda9cf6a7b0f7be48b7bc0b Mon Sep 17 00:00:00 2001 From: lcawl Date: Mon, 22 Sep 2025 15:32:02 -0700 Subject: [PATCH 3/3] Format yaml --- .../examples/request/indicesPutAliasRequestExample2.yaml | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample2.yaml b/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample2.yaml index aed37b342e..3325f25f1e 100644 --- a/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample2.yaml +++ b/specification/indices/put_alias/examples/request/indicesPutAliasRequestExample2.yaml @@ -1,6 +1,8 @@ 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. +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: |- {