[Документация Yandex Cloud](../../index.md) > [Yandex Lockbox](../index.md) > [Пошаговые инструкции](index.md) > Изменить секрет

# Изменить секрет

Чтобы изменить секрет:

{% list tabs group=instructions %}

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

    1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, которому принадлежит секрет.
    1. Перейдите в сервис **Lockbox**.
    1. В меню слева выберите **Секреты**.
    1. Напротив секрета нажмите ![image](../../_assets/console-icons/ellipsis.svg) и выберите **Редактировать**.
    1. Скорректируйте имя и описание секрета, отметьте опцию **Запретить удаление секрета** при необходимости.
    1. Измените тип секрета и укажите ключ и значение, либо параметры генерации значения.
        
        При изменении типа секрета, ключа или параметров генерации будет создана новая версия.
    1. Нажмите кнопку **Сохранить**.

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

  По умолчанию используется каталог, указанный при [создании](../../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

  1. Посмотрите описание команды CLI для добавления ресурсов в секрет:
     ```bash
     yc lockbox secret update --help
     ```

  1. Выполните команду, указав имя или идентификатор секрета:
     ```bash
     yc lockbox secret update \
       --id <идентификатор_секрета> \
       --new-name <новое_имя_секрета> \
       --description <новое_описание_секрета>
     ```

     Результат:
     ```
     id: e6q2ig0u9b97********
     folder_id: b1gyggt2th59********
     created_at: "2021-11-08T19:23:00.383Z"
     name: <новое_имя_секрета>
     description: <новое_описание_секрета>
     status: ACTIVE
     current_version:
       id: e6q8ma3b6pd1********
       secret_id: e6q2ug0o9b24********
       created_at: "2021-11-08T19:23:00.383Z"
       status: ACTIVE
       payload_entry_keys:
       - <ключ>
     ```

- Terraform {#tf}

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

  1. Откройте файл конфигурации Terraform и измените фрагмент с описанием секрета:

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

     ```
     ...
     resource "yandex_lockbox_secret" "my_secret" {
       name                = "My secret"
       description         = "test secret from tf"
       folder_id           = "b1gmitvfx321d3********"
       kms_key_id          = "abjp8q2fjfg0s********"
       deletion_protection = true
       labels              = {
         tf-label    = "tf-label-value",
         empty-label = ""
       }
     }
     ...
     ```

     {% endcut %}

  1. Примените изменения:

      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 lockbox secret get <имя_секрета>
    ```

- API {#api}

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

{% endlist %}

#### Полезные ссылки {#see-also}

[Секреты в Yandex Lockbox](../concepts/secret.md)