---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.4
alternate:
  - https://ydb.tech/docs/en/reference/ydb-cli/commands/bridge/failover.md
  - https://ydb.tech/docs/ru/reference/ydb-cli/commands/bridge/failover.md
sourcePath: ru/core/reference/ydb-cli/commands/bridge/failover.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# admin cluster bridge failover

<!-- source: ru/_includes/feature_enterprise.md -->
{% note info "Функциональность Корпоративной СУБД Яндекса" %}

Данная функциональность доступна только в [Корпоративной СУБД Яндекса](https://ydb.tech/docs/ru/downloads/yandex-enterprise-database.md). В open-source версии YDB она отсутствует.

{% endnote %}
<!-- endsource: ru/_includes/feature_enterprise.md -->

С помощью команды `admin cluster bridge failover` можно выполнить [аварийное отключение](https://ydb.tech/docs/ru/concepts/bridge.md#failover) pile, когда он недоступен. При необходимости можно указать pile, который станет новым `PRIMARY`.

<!-- source: ru/reference/ydb-cli/commands/_includes/danger-warning.md -->
{% note alert %}

Команды из этого раздела могут нанести вред вашему кластеру при неправильном использовании. Из-за потенциально опасного характера этих команд **ВСЕ** глобальные параметры должны быть заданы явно. Профили отключены по умолчанию и используются только при явном указании (`--profile <имя-профиля>`). Некоторые команды не требуют глобальных опций, которые в противном случае являются обязательными.

{% endnote %}
<!-- endsource: ru/reference/ydb-cli/commands/_includes/danger-warning.md -->

Общий вид команды:

```bash
ydb [global options...] admin cluster bridge failover [options...]
```

* `global options` — [глобальные параметры](https://ydb.tech/docs/ru/reference/ydb-cli/commands/global-options.md) CLI.
* `options` — [параметры подкоманды](#options).

Просмотр справки по команде:

```bash
ydb admin cluster bridge failover --help
```

## Параметры подкоманды {#options}

#|
|| Имя | Описание ||
|| `--pile <pile>` | Имя недоступного pile. ||
|| `--new-primary <pile>` | Имя pile, который должен стать новым `PRIMARY` pile. Укажите, если недоступный pile был `PRIMARY`. ||
|#

## Требования {#requirements}

- Если недоступен текущий `PRIMARY`, обязательно укажите `--new-primary` и выберите pile в состоянии `SYNCHRONIZED`. При отсутствии `--new-primary` или выборе pile в состоянии, отличном от `SYNCHRONIZED`, команда вернёт ошибку без каких‑либо изменений.
- Кластер не перейдёт в невалидное состояние: при нарушении требований команда ничего не изменяет и сообщает об ошибке.
- Если pile не вышел из строя, но его нужно отключить, используйте [плановое отключение](https://ydb.tech/docs/ru/concepts/bridge.md#takedown) — команду [`takedown`](https://ydb.tech/docs/ru/reference/ydb-cli/commands/bridge/takedown.md).

## Примеры {#examples}

Выполнение аварийного отключения для недоступного pile под названием `pile-a`:

```bash
ydb admin cluster bridge failover --pile pile-a
```

Выполнение аварийного отключения для недоступного `PRIMARY` pile и назначение новым `PRIMARY` синхронизированного pile:

```bash
ydb admin cluster bridge failover --pile pile-a --new-primary pile-b
```

### Проверка результата {#verify}

С помощью команды [list](https://ydb.tech/docs/ru/reference/ydb-cli/commands/bridge/list.md) проверьте, что недоступный pile переведён в состояние `DISCONNECTED` и (если был указан `--new-primary`) выбран новый `PRIMARY` pile :

```bash
ydb admin cluster bridge list

pile-a: DISCONNECTED
pile-b: PRIMARY
```