[9.0] Fix alias examples (#5331)

specification/_doc_ids/table.csv

@@ -2,8 +2,9 @@ doc_id,doc_url,legacy_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/v9/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/v9/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/v9/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/v9/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,,

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: [

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"
+            }
+          }
+        ]
+      }
+    }
+  }

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
+  }

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"
+  }