---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ydb.tech/docs/en/reference/ydb-cli/commands/bridge.md?version=v26.1
  - https://ydb.tech/docs/ru/reference/ydb-cli/commands/bridge.md?version=v26.1
  - href: en/reference/ydb-cli/commands/bridge/index.md
    type: text/markdown
    title: Markdown version
  - href: ../../../../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: en/core/reference/ydb-cli/commands/bridge/index.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/en/llms.txt

# Bridge cluster management commands

<!-- source: en/_includes/feature_enterprise.md -->
{% note info "Feature of Yandex Enterprise Database" %}

This functionality is available only in the [Yandex Enterprise Database](https://ydb.tech/docs/en/downloads/yandex-enterprise-database.md?version=v26.1). In the open-source version of YDB it is absent.

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

Commands for managing the cluster in [bridge mode](https://ydb.tech/docs/en/concepts/bridge.md?version=v26.1) let you view [pile](https://ydb.tech/docs/en/concepts/glossary.md?version=v26.1#pile) state, perform planned and emergency PRIMARY change, temporarily take a pile out for maintenance, and return it to the cluster.

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

Commands in this section can harm your cluster if used incorrectly. Due to the potentially dangerous nature of these commands, **ALL** global parameters must be specified explicitly. Profiles are disabled by default and are only used when explicitly specified (`--profile <profile-name>`). Some commands do not require global options that are otherwise mandatory.

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

General syntax for bridge cluster management commands:

```bash
ydb [global options...] admin cluster bridge [command options...] <subcommand>
```

where:

- `ydb` — command to launch YDB CLI from the operating system command line;
- `[global options]` — global parameters common to all YDB CLI commands;
- `admin cluster bridge` — cluster configuration management command;
- `[command options]` — parameters specific to each command and subcommand;
- `<subcommand>` — subcommand.

## Commands {#list}

Below is the list of available subcommands for bridge cluster management. You can run any command with the `--help` option for help.

Command / subcommand | Brief description
--- | ---
[admin cluster bridge list](./list.md) | List pile state
[admin cluster bridge switchover](./switchover.md) | Planned PRIMARY change
[admin cluster bridge failover](./failover.md) | Emergency failover
[admin cluster bridge takedown](./takedown.md) | Take pile out of cluster
[admin cluster bridge rejoin](./rejoin.md) | Return pile to cluster