› › ›

API получения состояния подготовки к завершению работы

Эта функция предназначена для косвенного использования Elasticsearch Service, Elastic Cloud Enterprise и Elastic Cloud on Kubernetes. Прямое использование не поддерживается.

Получает статус узла, который готовится к завершению работы.

Запрос

GET _nodes/shutdown

GET _nodes/<node-id>/shutdown

Предварительные условия

Если включены средства безопасности Elasticsearch, для использования этого API необходимо иметь право доступа к кластеру.
Если включена функция прав оператора, для использования этого API необходимо быть оператором.

Описание

Указывает, готов ли узел к завершению работы, или подготовка к завершению все еще продолжается или заблокирована. Возвращает информацию о статусе каждого этапа процесса завершения работы. Используйте для отслеживания процесса завершения работы после вызова put shutdown.

Параметры пути

<node-id>: (Необязательно, строка) Идентификатор узла, который готовится к завершению работы. Если идентификатор не указан, возвращается статус всех узлов, которые готовятся к завершению работы.

Примеры

Подготовка узла к перезапуску:

resp = client.shutdown.put_node(
    node_id="USpTGYaBSIKbgSUJR2Z9lg",
    type="restart",
    reason="Demonstrating how the node shutdown API works",
    allocation_delay="10m",
)
print(resp)

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

const response = await client.shutdown.putNode({
  node_id: "USpTGYaBSIKbgSUJR2Z9lg",
  type: "restart",
  reason: "Demonstrating how the node shutdown API works",
  allocation_delay: "10m",
});
console.log(response);

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

Получение статуса подготовки к завершению работы:

resp = client.shutdown.get_node(
    node_id="USpTGYaBSIKbgSUJR2Z9lg",
)
print(resp)

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

const response = await client.shutdown.getNode({
  node_id: "USpTGYaBSIKbgSUJR2Z9lg",
});
console.log(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"
            }
        }
    ]
}

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/get-shutdown.html