Destruir uma versão de secret

Nesta página, descrevemos como destruir uma versão secreta. No estado destruído, o conteúdo da versão do secret é descartado. A destruição de uma versão do secret é uma ação permanente. Depois que uma versão é destruída, não é possível acessar os dados secretos nem restaurar a versão para outro estado.

Antes de destruir uma versão do secret, desative-a e observe o comportamento do seu aplicativo. É possível reativar a versão do secret se você encontrar problemas inesperados.

Quando você desativa ou destrói um secret ou uma versão do secret, a alteração leva tempo para ser propagada pelo sistema. Se necessário, você pode revogar o acesso ao secret. As alterações nas permissões do IAM se tornam consistentes em questão de segundos.

Funções exigidas

Para receber as permissões necessárias para destruir uma versão secreta, peça ao administrador para conceder a você o papel do IAM Gerenciador de versões secretas do Secret Manager (roles/secretmanager.secretVersionManager) em um secret. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Destruir uma versão de secret

Para destruir uma versão secreta, use um dos seguintes métodos:

Console

  1. No console do Google Cloud , acesse a página Secret Manager.

    Acessar o Secret Manager

  2. Na página Secret Manager, clique em um secret para acessar as versões dele.

  3. Na página de detalhes do secret, na guia Versões, selecione a versão do secret que você quer destruir.

  4. Clique em Ações e em Destruir.

  5. Na caixa de diálogo de confirmação, digite o ID do secret para confirmar e clique em Destruir versões selecionadas.

gcloud

Antes de usar os dados do comando abaixo, faça estas substituições:

  • VERSION_ID: o nome do recurso da versão do secret
  • SECRET_ID: o ID do secret

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud secrets versions destroy VERSION_ID --secret=SECRET_ID

Windows (PowerShell)

gcloud secrets versions destroy VERSION_ID --secret=SECRET_ID

Windows (cmd.exe)

gcloud secrets versions destroy VERSION_ID --secret=SECRET_ID

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto Google Cloud
  • SECRET_ID: o ID do secret
  • VERSION_ID: o ID da versão do secret

Método HTTP e URL: 

POST https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID:destroy

Corpo JSON da solicitação:

{}

Para enviar a solicitação, escolha uma destas opções:

curl

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID:destroy"

PowerShell

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }