集群退役
1.0 版引入
集群退役操作增加了基于感知（awareness）的退役支持。这极大地有利于多区域部署，在这些部署中，诸如 zones 等感知属性可以帮助以受控方式对集群应用新升级。这在发生中断时特别有用，在这种情况下，您可以退役不健康的区域，以防止复制请求停滞并防止请求积压变得过大。
有关分配感知（allocation awareness）的更多信息，请参阅分片分配感知。
端点
PUT /_cluster/decommission/awareness/{awareness_attribute_name}/{awareness_attribute_value}
GET /_cluster/decommission/awareness/{awareness_attribute_name}/_status
DELETE /_cluster/decommission/awareness
路径参数
| 参数 | 类型 | 描述 |
|---|---|---|
| awareness_attribute_name | 字符串 | 感知属性的名称，通常是 zone。 |
| awareness_attribute_value | 字符串 | 感知属性的值。例如，如果您的分片分配在两个不同的区域，您可以为每个区域指定值 zone-a 或 zoneb。集群退役操作将退役方法中列出的区域。 |
示例请求
退役和重新启用区域
您可以使用以下示例请求来退役和重新启用区域
以下示例请求将退役 zone-a
PUT /_cluster/decommission/awareness/<zone>/<zone-a>
如果您想重新启用已退役的区域，可以使用 DELETE 方法
DELETE /_cluster/decommission/awareness
获取区域退役状态
以下示例请求返回所有区域的退役状态。
GET /_cluster/decommission/awareness/zone/_status
示例响应
以下示例响应显示了成功的区域退役
{
"acknowledged": true
}
获取区域退役状态
以下示例响应返回所有区域的退役状态
{
"zone-1": "INIT | DRAINING | IN_PROGRESS | SUCCESSFUL | FAILED"
}