› › ›

创建或更新别名 API

创建或更新别名 API编辑

将数据流或索引添加到别名。

response = client.indices.put_alias(
  index: 'my-data-stream',
  name: 'my-alias'
)
puts response

PUT my-data-stream/_alias/my-alias

POST <target>/_alias/<alias>

POST <target>/_aliases/<alias>

PUT <target>/_alias/<alias>

PUT <target>/_aliases/<alias>

master_timeout: （可选，时间单位）等待主节点的时间段。如果在超时到期之前主节点不可用，则请求失败并返回错误。默认为 30s。也可以设置为 -1 以指示请求永不超时。
timeout: （可选，时间单位）等待响应的时间段。如果在超时到期之前未收到任何响应，则请求失败并返回错误。默认为 30s。

filter

（可选，查询 DSL 对象）用于限制别名可以访问的文档的查询。

index_routing

（可选，字符串）用于将索引操作路由到特定分片的值。如果指定，这将覆盖索引操作的 routing 值。数据流别名不支持此参数。

is_hidden

（可选，布尔值）如果为 true，则别名隐藏。默认为 false。别名的所有数据流或索引必须具有相同的 is_hidden 值。

is_write_index

（可选，布尔值）如果为 true，则设置别名的写入索引或数据流。

如果别名指向多个索引或数据流并且未设置 is_write_index，则别名将拒绝写入请求。如果索引别名指向一个索引并且未设置 is_write_index，则该索引将自动充当写入索引。即使别名指向一个数据流，数据流别名也不会自动设置写入数据流。

must_exist

（可选，布尔值）影响尝试删除不存在的别名时的行为。如果为 true，则删除不存在的别名将导致所有操作失败。如果为 false，则删除不存在的别名将仅导致该删除失败。默认为 false。

routing

（可选，字符串）用于将索引和搜索操作路由到特定分片的值。数据流别名不支持此参数。

search_routing

（可选，字符串）用于将搜索操作路由到特定分片的值。如果指定，这将覆盖搜索操作的 routing 值。数据流别名不支持此参数。