[Документация 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. В открывшемся окне нажмите кнопку **Удалить**.

- 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 delete --help
     ```

  1. Запросите список секретов:

     ```bash
     yc lockbox secret list --cloud-id <идентификатор_облака> --folder-name <имя_каталога>
     ```

	 Результат:

	 ```text
	 +----------------------+------------------+------------+---------------------+----------------------+--------+
     |          ID          |       NAME       | KMS KEY ID |     CREATED AT      |  CURRENT VERSION ID  | STATUS |
     +----------------------+------------------+------------+---------------------+----------------------+--------+
     | e6q942hj2r5n******** | <имя_секрета_1>  |            | 2021-11-09 13:07:12 | e2r9pdm39tn2******** | ACTIVE |
     | e4qkyo469mu2******** | <имя_секрета_2>  |            | 2021-12-09 06:50:37 | e6fpq386othp******** | ACTIVE |
     +----------------------+------------------+------------+---------------------+----------------------+--------+
	 ```

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

     ```bash
     yc lockbox secret delete --id e4qkyo469mu2********
     ```

     Результат:

     ```text
     id: e4qkyo469mu2********
     folder_id: b1ulgko2th57********
     created_at: "2021-11-08T17:13:48.393Z"
     ...
       status: ACTIVE
       payload_entry_keys:
       - <ключ>
     ```

  1. Проверьте, что секрета нет в списке:

     ```bash
     yc lockbox secret list --cloud-id <идентификатор_облака> --folder-name <имя_каталога>
     ```

     Результат:

     ```text
     +----------------------+-----------------+------------+---------------------+----------------------+--------+
     |          ID          |      NAME       | KMS KEY ID |     CREATED AT      |  CURRENT VERSION ID  | STATUS |
     +----------------------+-----------------+------------+---------------------+----------------------+--------+
     | e6q942hj2r5n******** | <имя_секрета_1> |            | 2021-11-09 13:07:12 | e2r9pdm39tn2******** | ACTIVE |
     +----------------------+-----------------+------------+---------------------+----------------------+--------+
     ```

- Terraform {#tf}

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

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

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

     ```hcl
     ...
     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 list
    ```

- API {#api}

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

{% endlist %}

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

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