› › ›

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

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

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

Запрос

GET _nodes/shutdown

GET _nodes/<node-id>/shutdown

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

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

Описание

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

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

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

Параметры запроса

master_timeout: (Необязательно, единицы времени) Время ожидания подключения к мастер-узлу. Если ответ не получен до истечения таймаута, запрос завершается неудачно и возвращается ошибка. По умолчанию 30s.
timeout: (Необязательно, единицы времени) Время ожидания ответа. Если ответ не получен до истечения таймаута, запрос завершается неудачно и возвращается ошибка. По умолчанию 30s.

Примеры

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

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

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

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/7.17/get-shutdown.html