[DOCS] Update alias API docs for data stream aliases (#73419)

Updates the docs for several alias APIs for data stream aliases. Also
removes some redundant examples now covered in the [aliases guide][0].

[0]: https://www.elastic.co/guide/en/elasticsearch/reference/master/alias.html

Author: jrodewig

docs/reference/alias.asciidoc

@@ -45,9 +45,8 @@ POST _aliases
 ----
 // TEST[s/^/PUT _data_stream\/logs-nginx.access-prod\n/]
 
-The API's `index` and `indices` parameters support wildcards (`*`). If a
-wildcard pattern matches both data streams and indices, the action only uses
-matching data streams.
+The API's `index` and `indices` parameters support wildcards (`*`). Wildcard
+patterns that match both data streams and indices return an error.
 
 [source,console]
 ----

docs/reference/indices/add-alias.asciidoc

@@ -8,158 +8,47 @@ Adds a data stream or index to an <<alias,alias>>.
 
 [source,console]
 ----
-PUT /my-index-000001/_alias/alias1
+PUT my-data-stream/_alias/my-alias
 ----
-// TEST[setup:my_index]
-
+// TEST[setup:my_data_stream]
+// TEST[teardown:data_stream_cleanup]
 
 [[add-alias-api-request]]
 ==== {api-request-title}
 
-`PUT /<index>/_alias/<alias>`
+`POST <target>/_alias/<alias>`
 
-`POST /<index>/_alias/<alias>`
+`POST <target>/_aliases/<alias>`
 
-`PUT /<index>/_aliases/<alias>`
+`PUT <target>/_alias/<alias>`
 
-`POST /<index>/_aliases/<alias>`
+`PUT <target>/_aliases/<alias>`
 
 [[add-alias-api-prereqs]]
 ==== {api-prereq-title}
 
 * If the {es} {security-features} are enabled, you must have the `manage`
-<<privileges-list-indices,index privilege>> for both the index and index alias.
+<<privileges-list-indices,index privilege>> for the alias and its data streams
+or indices.
 
 [[add-alias-api-path-params]]
 ==== {api-path-parms-title}
 
-`<index>`::
-(Required, string)
-Comma-separated list or wildcard expression of index names
-to add to the alias.
-+
-To add all indices in the cluster to the alias,
-use a value of `_all`.
-+
-NOTE: You cannot add <<data-streams,data streams>> to an index alias.
-
 `<alias>`::
-(Required, string)
-Name of the index alias to create or update. Supports
-<<date-math-index-names,date math>>.
+(Required, string) Alias to update. If the alias doesn't exist, the request
+creates it. Index alias names support <<date-math-index-names,date math>>.
 
+`<target>`::
+(Required, string) Comma-separated list of data streams or indices to add.
+Supports wildcards (`*`). Wildcard patterns that match both data streams and
+indices return an error.
 
 [[add-alias-api-query-params]]
 ==== {api-query-parms-title}
 
 include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=timeoutparms]
 
-
 [[add-alias-api-request-body]]
 ==== {api-request-body-title}
 
-`filter`::
-(Optional, query object)
-include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=index-alias-filter]
-
-include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=routing]
-
-[[add-alias-api-example]]
-==== {api-examples-title}
-
-[[alias-date-math-support]]
-===== Date math support
-
-Index alias names support <<date-math-index-names,date math>>.
-
-[source,console]
-----
-# POST /logs/_alias/<logs_{now/M}>
-POST /logs/_alias/%3Clogs_%7Bnow%2FM%7D%3E
-----
-// TEST[s/^/PUT logs\n/]
-
-[[alias-adding]]
-===== Add a time-based alias
-
-The following request creates an alias, `2030`,
-for the `logs_20302801` index.
-
-[source,console]
---------------------------------------------------
-PUT /logs_20302801/_alias/2030
---------------------------------------------------
-// TEST[s/^/PUT logs_20302801\n/]
-
-[[add-alias-api-user-ex]]
-===== Add a user-based alias
-
-First, create an index, `users`,
-with a mapping for the `user_id` field:
-
-[source,console]
---------------------------------------------------
-PUT /users
-{
-  "mappings" : {
-    "properties" : {
-      "user_id" : {"type" : "integer"}
-    }
-  }
-}
---------------------------------------------------
-
-Then add the index alias for a specific user, `user_12`:
-
-[source,console]
---------------------------------------------------
-PUT /users/_alias/user_12
-{
-  "routing" : "12",
-  "filter" : {
-    "term" : {
-      "user_id" : 12
-    }
-  }
-}
---------------------------------------------------
-// TEST[continued]
-
-[[alias-index-creation]]
-===== Add an alias during index creation
-
-You can use the <<create-index-aliases,create index API>>
-to add an index alias during index creation.
-
-[source,console]
---------------------------------------------------
-PUT /logs_20302801
-{
-  "mappings": {
-    "properties": {
-      "year": { "type": "integer" }
-    }
-  },
-  "aliases": {
-    "current_day": {},
-    "2030": {
-      "filter": {
-        "term": { "year": 2030 }
-      }
-    }
-  }
-}
---------------------------------------------------
-
-The create index API also supports <<date-math-index-names,date math>> in index
-alias names.
-
-[source,console]
-----
-PUT /logs
-{
-  "aliases": {
-    "<logs_{now/M}>": {}
-  }
-}
-----
+include::aliases.asciidoc[tag=alias-options]

docs/reference/indices/alias-exists.asciidoc

@@ -8,35 +8,38 @@ Checks if an <<alias,alias>> exists.
 
 [source,console]
 ----
-HEAD /_alias/alias1
+HEAD _alias/my-alias
 ----
-// TEST[setup:my_index]
-// TEST[s/^/PUT my-index-000001\/_alias\/alias1\n/]
-
+// TEST[setup:my_data_stream]
+// TEST[s/^/PUT my-data-stream\/_alias\/my-alias\n/]
+// TEST[teardown:data_stream_cleanup]
 
 [[alias-exists-api-request]]
 ==== {api-request-title}
 
-`HEAD /_alias/<alias>`
+`HEAD _alias/<alias>`
 
-`HEAD /<index>/_alias/<alias>`
+`HEAD <target>/_alias/<alias>`
 
 [[alias-exists-api-prereqs]]
 ==== {api-prereq-title}
 
 * If the {es} {security-features} are enabled, you must have the
 `view_index_metadata` or `manage` <<privileges-list-indices,index privilege>>
-for the index alias. If you specify an index, you must also have
-`view_index_metadata` or `manage` index privilege for the index.
+for the alias. If you specify a target, you must also have the
+`view_index_metadata` or `manage` index privilege for the target.
 
 [[alias-exists-api-path-params]]
 ==== {api-path-parms-title}
 
 `<alias>`::
-(Required, string)
-include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=index-alias]
+(Optional, string) Comma-separated list of aliases to check. Supports wildcards
+(`*`).
 
-include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=index]
+`<target>`::
+(Optional, string) Comma-separated list of data streams or indices used to limit
+the request. Supports wildcards (`*`). To target all data streams and indices,
+omit this parameter or use `*` or `_all`.
 
 [[alias-exists-api-query-params]]
 ==== {api-query-parms-title}
@@ -45,28 +48,17 @@ include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=expand-wildcards]
 +
 Defaults to `all`.
 
-include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=index-ignore-unavailable]
+`ignore_unavailable`::
+(Optional, Boolean) If `false`, requests that include a missing data stream or
+index in the `<target>` return an error. Defaults to `false`.
 
 include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=local]
 
-
 [[alias-exists-api-response-codes]]
 ==== {api-response-codes-title}
 
 `200`::
-Indicates all specified index aliases exist.
-
- `404`::
-Indicates one or more specified index aliases **do not** exist.
-
+All specified aliases exist.
 
-[[alias-exists-api-example]]
-==== {api-examples-title}
-
-[source,console]
-----
-HEAD /_alias/2030
-HEAD /_alias/20*
-HEAD /logs_20302801/_alias/*
-----
-// TEST[s/^/PUT logs_20302801\nPUT logs_20302801\/_alias\/2030\n/]
+`404`::
+One or more of the specified aliases don't exist.