[Документация Yandex Cloud](../../../index.md) > [Yandex Resource Manager](../../index.md) > [Пошаговые инструкции](../index.md) > Облако > Переименование облака

# Переименование облака

Чтобы переименовать облако, у вас должна быть роль [`editor`](../../../iam/roles-reference.md#editor) или выше на это облако. Переименовать заблокированное облако нельзя. Если вы не можете выполнить эту операцию, обратитесь к [администратору](../../../iam/roles-reference.md#admin) или [владельцу облака](../../concepts/resources-hierarchy.md#owner).

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. В [консоли управления](https://kz.console.yandex.cloud) на панели сверху нажмите ![image](../../../_assets/console-icons/layout-side-content-left.svg) или ![image](../../../_assets/console-icons/chevron-down.svg) и выберите нужное облако.
  1. В правом верхнем углу страницы нажмите значок ![horizontal-ellipsis](../../../_assets/console-icons/ellipsis.svg) и выберите **Редактировать**.
  1. В открывшемся окне введите новое имя облака. Требования к имени:

	 * длина — от 3 до 63 символов;
  * может содержать строчные буквы латинского алфавита, цифры и дефисы;
  * первый символ — буква, последний — не дефис.

  1. Нажмите **Сохранить**.

- CLI {#cli}

  Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../../../cli/quickstart.md#install).

  1. Посмотрите описание команды для изменения облака:

      ```bash
      yc resource-manager cloud update --help
      ```

  1. Посмотрите список доступных облаков:

      ```bash
      yc resource-manager cloud list
      ```

      Результат:

      ```text
      +----------------------+------------------+----------------------+--------+
      |          ID          |       NAME       |   ORGANIZATION ID    | LABELS |
      +----------------------+------------------+----------------------+--------+
      | b1go33ek97iq******** | my-cloud         | bpf2c65rqcl8******** |        |
      | b1gbi30tq0m9******** | my-new-cloud     | bpfaidqca8vd******** |        |
      +----------------------+------------------+----------------------+--------+
      ```

  1. Выполните команду, чтобы переименовать облако:

      ```bash
      yc resource-manager cloud update \
        --name <текущее_имя_облака> \
        --new-name <новое_имя_облака>
      ```

      Где:

      * `--name` — текущее имя облака, которое требуется изменить. Вместо имени облака вы можете передать его [идентификатор](get-id.md) в параметре `--id`.
      * `--new-name` — новое имя облака.

          * длина — от 3 до 63 символов;
          * может содержать строчные буквы латинского алфавита, цифры и дефисы;
          * первый символ — буква, последний — не дефис.

      Результат:

      ```text
      id: b1go33ek97iq********
      created_at: "2024-12-10T09:25:22Z"
      name: my-old-cloud
      organization_id: bpf2c65rqcl8********
      ```

- Terraform {#tf}

  Если у вас еще нет Terraform, [установите его и настройте провайдер Yandex Cloud](../../../tutorials/infrastructure-management/terraform-quickstart.md#install-terraform).
  
  
  Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, [аутентифицируйтесь](../../../terraform/authentication.md) соответствующим способом.

  Чтобы переименовать облако, созданное с помощью Terraform:

  1. Откройте файл конфигурации Terraform и измените значение параметра `name` во фрагменте с описанием облака.

      {% cut "Пример описания облака в конфигурации Terraform" %}

      ```hcl
      ...
      resource "yandex_resourcemanager_cloud" "cloud1" {
        name            = "cloud-main"
        organization_id = "bpf7nhb9hkph********"
      }
      ...
      ```

      {% endcut %}

      Подробнее о параметрах ресурса `yandex_resourcemanager_cloud` в Terraform читайте в [документации провайдера](../../../terraform/resources/resourcemanager_cloud.md).
  1. В командной строке перейдите в папку, где вы отредактировали конфигурационный файл.
  1. Проверьте корректность конфигурационного файла с помощью команды:

      ```bash
      terraform validate
      ```

      Если конфигурация является корректной, появится сообщение:
     
      ```bash
      Success! The configuration is valid.
      ```

  1. Выполните команду:

      ```bash
      terraform plan
      ```

      В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
  1. Примените изменения конфигурации:

      ```bash
      terraform apply
      ```

  1. Подтвердите изменения: введите в терминале слово `yes` и нажмите **Enter**.

      Проверить измененное имя облака можно в [консоли управления](https://kz.console.yandex.cloud) или с помощью команды [CLI](../../../cli/quickstart.md):

      ```bash
      yc resource-manager cloud list
      ```

- API {#api}

  Чтобы переименовать облако, воспользуйтесь методом REST API [update](../../api-ref/Cloud/update.md) для ресурса [Cloud](../../api-ref/Cloud/index.md) или вызовом gRPC API [CloudService/Update](../../api-ref/grpc/Cloud/update.md).

{% endlist %}