› › ›

获取关闭 API

编辑

获取关闭 API编辑

此功能专为间接使用而设计，例如 Elasticsearch Service、Elastic Cloud Enterprise 和 Elastic Cloud on Kubernetes。不支持直接使用。

检索正在准备关闭的节点的状态。

请求编辑

GET _nodes/shutdown

GET _nodes/<node-id>/shutdown

先决条件编辑

如果启用了 Elasticsearch 安全功能，则您必须具有 manage 集群权限才能使用此 API。
如果启用了操作员权限功能，则您必须是操作员才能使用此 API。

描述编辑

指示节点是否已准备好关闭，或者关闭准备工作是否仍在进行中或已停止。返回关闭过程每个部分的状态信息。用于在调用放置关闭后监控关闭过程。

路径参数编辑

<node-id>: （可选，字符串）正在准备关闭的节点的 ID。如果未指定 ID，则返回正在准备关闭的所有节点的状态。

查询参数编辑

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

示例编辑

准备要重启的节点

response = client.shutdown.put_node(
  node_id: 'USpTGYaBSIKbgSUJR2Z9lg',
  body: {
    type: 'restart',
    reason: 'Demonstrating how the node shutdown API works',
    allocation_delay: '10m'
  }
)
puts response

PUT /_nodes/USpTGYaBSIKbgSUJR2Z9lg/shutdown
{
  "type": "restart",
  "reason": "Demonstrating how the node shutdown API works",
  "allocation_delay": "10m"
}

获取关闭准备工作的状态

response = client.shutdown.get_node(
  node_id: 'USpTGYaBSIKbgSUJR2Z9lg'
)
puts response

GET /_nodes/USpTGYaBSIKbgSUJR2Z9lg/shutdown

响应显示有关关闭准备工作的信息，包括分片迁移、任务迁移和插件清理的状态

{
    "nodes": [
        {
            "node_id": "USpTGYaBSIKbgSUJR2Z9lg",
            "type": "RESTART",
            "reason": "Demonstrating how the node shutdown API works",
            "shutdown_startedmillis": 1624406108685,
            "allocation_delay": "10m",
            "status": "COMPLETE",
            "shard_migration": {
                "status": "COMPLETE",
                "shard_migrations_remaining": 0,
                "explanation": "no shard relocation is necessary for a node restart"
            },
            "persistent_tasks": {
                "status": "COMPLETE"
            },
            "plugins": {
                "status": "COMPLETE"
            }
        }
    ]
}

« 放置关闭 API 删除关闭 API »