Create or Update Alias

Create or Update Alias

Introduced 1.0

The Create or Update Alias API adds a data stream or index to an alias or updates the settings for an existing alias. For more alias API operations, see Index aliases.

The Create or Update Alias API is distinct from the Alias API, which supports the addition and removal of aliases and the removal of alias indexes. In contrast, the following API only supports adding or updating an alias without updating the index itself. Each API also uses different request body parameters.

Path and HTTP methods

POST /<target>/_alias/<alias-name>
PUT /<target>/_alias/<alias-name>
POST /_alias/<alias-name>
PUT /_alias/<alias-name>
POST /<target>/_aliases/<alias-name>
PUT /<target>/_aliases/<alias-name>
POST /_aliases/<alias-name>
PUT /_aliases/<alias-name>
PUT /<target>/_alias
PUT /<target>/_aliases
PUT /_alias

Path parameters

Parameter	Type	Description
`target`	String	A comma-delimited list of data streams and indexes. Wildcard expressions () are supported. To target all data streams and indexes in a cluster, use `_all` or . Optional.
`alias-name`	String	The alias name to be created or updated. Optional.

Query parameters

All query parameters are optional.

Parameter	Type	Description
`cluster_manager_timeout`	Time	The amount of time to wait for a response from the cluster manager node. Default is `30s`.
`timeout`	Time	The amount of time to wait for a response from the cluster. Default is `30s`.

Request body

In the request body, you can specify the index name, the alias name, and the settings for the alias. All fields are optional.

Field	Type	Description
`index`	String	A comma-delimited list of data streams or indexes that you want to associate with the alias. If this field is set, it will override the index name specified in the URL path.
`alias`	String	The name of the alias. If this field is set, it will override the alias name specified in the URL path.
`is_write_index`	Boolean	Specifies whether the index should be a write index. An alias can only have one write index at a time. If a write request is submitted to an alias that links to multiple indexes, then OpenSearch runs the request only on the write index.
`routing`	String	Assigns a custom value to a shard for specific operations.
`index_routing`	String	Assigns a custom value to a shard only for index operations.
`search_routing`	String	Assigns a custom value to a shard only for search operations.
`filter`	Object	A filter to use with the alias so that the alias points to a filtered part of the index.

Example request

The following example request adds a sample alias with a custom routing value:

POST sample-index/_alias/sample-alias
{
  "routing":"test"
}

copy

Example response

{
    "acknowledged": true
}

For more alias API operations, see Index aliases.