Atrasar a destruição de versões do segredo regional

Esta página explica como configurar a destruição atrasada de versões secretas, atualizar ou remover a duração do atraso na destruição e restaurar versões secretas agendadas para destruição.

Por predefinição, quando um utilizador opta por destruir uma versão do Secret no Secret Manager, o material do Secret é destruído imediatamente e de forma permanente. No entanto, os utilizadores com a função de administrador do Secret Manager podem configurar a destruição atrasada de versões secretas, o que garante que a versão secreta não é destruída imediatamente após o pedido e permanece recuperável durante um período configurável.

Quando a destruição atrasada está ativada no código secreto e destrói uma versão do código secreto, ocorre o seguinte:

• A versão está desativada, o que impede a sua utilização.

• O sistema agenda a versão para destruição permanente no final do período de atraso.

• Após o período de atraso expirar, a versão do segredo é destruída permanentemente e irrevogavelmente.

Vantagens

Esta funcionalidade oferece as seguintes vantagens:

• Uma camada adicional de proteção contra a destruição acidental ou maliciosa de material secreto crítico. Qualquer utilizador com a função de gestor da versão do Secret do Secret Manager pode destruir uma versão do Secret. Esta ação é irreversível. Ao configurar a destruição atrasada, pode impedir a destruição imediata das versões secretas. Pode conceder aos utilizadores o acesso mínimo necessário para gerir o ciclo de vida das versões de segredos, de modo a poder monitorizar e impedir qualquer destruição acidental de dados confidenciais.

• A destruição de uma versão secreta aciona uma SECRET_VERSION_DESTROY_SCHEDULED notificação para os tópicos do Pub/Sub configurados no segredo. Os utilizadores com a função de administrador do Secret Manager podem cancelar a destruição agendada e restaurar a versão secreta ativando ou desativando a versão secreta.

Antes de começar

1. Enable the Secret Manager API.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the API

2. Configurar autenticação.

   Select the tab for how you plan to use the samples on this page:

   Console

   When you use the Cloud de Confiance console to access Cloud de Confiance by S3NS services and APIs, you don't need to set up authentication.

   gcloud

   Instale a CLI Google Cloud e, em seguida, inicie sessão na CLI gcloud com a sua identidade federada. Depois de iniciar sessão, inicialize a CLI gcloud executando o seguinte comando:

   gcloud init

   REST

   Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

   Instale a CLI Google Cloud e, em seguida, inicie sessão na CLI gcloud com a sua identidade federada. Depois de iniciar sessão, inicialize a CLI gcloud executando o seguinte comando:

   gcloud init

   Para mais informações, consulte o artigo Autenticar para usar REST na Cloud de Confiance documentação de autenticação.

   Funções necessárias

   Para receber as autorizações de que precisa para configurar a destruição atrasada de versões secretas, peça ao seu administrador para lhe conceder a função de IAM Administrador do Gestor Secreto (roles/secretmanager.admin) num segredo. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

   Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

   Configure a destruição atrasada

   Pode ativar a destruição atrasada de uma versão secreta quando cria o segredo ou quando o atualiza. Para configurar a destruição atrasada, use um dos seguintes métodos:

   Consola

   1. Na Cloud de Confiance consola, aceda à página Secret Manager.

      Aceda ao Secret Manager

   2. Na página Secret Manager, clique no separador Segredos regionais e, de seguida, clique em Criar segredo regional.

   3. Na página Crie um segredo regional, introduza um nome para o segredo no campo Nome.

   4. Introduza um valor para o segredo (por exemplo, abcd1234). Também pode carregar um ficheiro de texto que contenha o valor do segredo através da opção Carregar ficheiro. Esta ação cria automaticamente a versão do Secret.

   5. Escolha a localização onde quer que o seu segredo regional seja armazenado na lista Região.

   6. Aceda à secção Atrasar a destruição da versão do segredo e, de seguida, selecione a caixa de verificação Definir duração para a destruição atrasada.

   7. No campo Duração do atraso na destruição, introduza a duração em dias. O valor mínimo que pode introduzir é de 1 dia e o valor máximo é de 1000 dias.

   8. Clique em Criar segredo.

      Para ativar esta funcionalidade num segredo existente, aceda à página Editar segredo e, de seguida, configure a duração do atraso de destruição.

   gcloud

   Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

   • SECRET_ID: o ID do segredo.
   • LOCATION: a Cloud de Confiance by S3NS localização do segredo.
   • TTL_DURATION: a duração do atraso na destruição para as versões do secret. Pode introduzir a duração em qualquer formato, por exemplo, dias, horas ou segundos. A duração mínima necessária é de 1 dia, enquanto a duração máxima pode ser definida como 1000 dias.

   Execute o seguinte comando:

   Linux, macOS ou Cloud Shell

   gcloud secrets create SECRET_ID --location=LOCATION --version-destroy-ttl=TTL_DURATION

   Windows (PowerShell)

   gcloud secrets create SECRET_ID --location=LOCATION --version-destroy-ttl=TTL_DURATION

   Windows (cmd.exe)

   gcloud secrets create SECRET_ID --location=LOCATION --version-destroy-ttl=TTL_DURATION

   A resposta contém o secret recém-criado.

   REST

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • LOCATION: a Cloud de Confiance by S3NS localização do segredo.
   • PROJECT_ID: o Cloud de Confiance by S3NS ID do projeto.
   • SECRET_ID: o ID do segredo.
   • TTL_DURATION: a duração do atraso na destruição das versões do secret. Introduza a duração em segundos. Tenha em atenção que a duração mínima necessária é de 1 dia, enquanto a duração máxima pode ser definida para 1000 dias.

   Método HTTP e URL:

   POST https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets?secretId=SECRET_ID

   Corpo JSON do pedido:

   {
     "version_destroy_ttl":"TTL_DURATION"
   }
   

   Para enviar o seu pedido, escolha uma destas opções:

   curl

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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

   PowerShell

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets?secretId=SECRET_ID" | Select-Object -Expand Content

   Deve receber uma resposta JSON semelhante à seguinte:

   {
     "name": "projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID",
     "createTime": "2024-09-04T06:34:32.995517Z",
     "etag": "\"1621455df3febd\"",
     "versionDestroyTtl": "TTL_DURATION"
   }
   

   A destruição atrasada não se aplica nos seguintes cenários:

   • Quando um segredo é eliminado, todo o material secreto e as versões secretas relacionadas são eliminados imediatamente.

   • Quando é definida uma data de validade no segredo e o segredo expira, todas as versões do segredo são destruídas imediatamente, mesmo que a destruição atrasada esteja ativada no segredo.

   Atualize a duração do atraso na destruição

   Para atualizar a duração do atraso na destruição, use um dos seguintes métodos:

   Consola

   1. Na Cloud de Confiance consola, aceda à página Secret Manager.

      Aceda ao Secret Manager

   2. Na página Secret Manager, clique no separador Segredos regionais.

   3. Para editar um segredo, use um dos seguintes métodos:

      • Clique em more_vertAções para o segredo que quer editar e, de seguida, clique em Editar.

      • Clique no nome do segredo para aceder à página de detalhes do segredo. Na página de detalhes do segredo, clique em editEditar segredo.

   4. Na página Editar segredo, aceda à secção Atrasar destruição da versão do segredo. Atualize a duração do atraso conforme necessário e, de seguida, clique em Atualizar chave secreta.

   gcloud

   Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

   • SECRET_ID: o ID do segredo
   • LOCATION: a Cloud de Confiance by S3NS localização do segredo
   • TTL_DURATION: a duração do atraso de destruição para as versões do secret

   Execute o seguinte comando:

   Linux, macOS ou Cloud Shell

   gcloud secrets update SECRET_ID --location=LOCATION --version-destroy-ttl=TTL_DURATION

   Windows (PowerShell)

   gcloud secrets update SECRET_ID --location=LOCATION --version-destroy-ttl=TTL_DURATION

   Windows (cmd.exe)

   gcloud secrets update SECRET_ID --location=LOCATION --version-destroy-ttl=TTL_DURATION

   A resposta contém o secret recém-criado.

   REST

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • LOCATION: a Cloud de Confiance by S3NS localização do segredo
   • PROJECT_ID: o Cloud de Confiance by S3NS ID do projeto
   • SECRET_ID: o ID do segredo
   • TTL_DURATION: a duração do atraso de destruição para as versões do secret

   Método HTTP e URL:

   PATCH https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID?updateMask=version_destroy_ttl

   Corpo JSON do pedido:

   {
     "version_destroy_ttl":"TTL_DURATION"
   }
   

   Para enviar o seu pedido, escolha uma destas opções:

   curl

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID?updateMask=version_destroy_ttl"

   PowerShell

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID?updateMask=version_destroy_ttl" | Select-Object -Expand Content

   Deve receber uma resposta JSON semelhante à seguinte:

   {
     "name": "projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID",
     "createTime": "2024-09-04T06:34:32.995517Z",
     "etag": "\"16214561a80d09\"",
     "versionDestroyTtl": "TTL_DURATION"
   }
   

   As versões secretas afetadas pela duração do atraso de destruição dependem do seguinte:

   • Quando a destruição atrasada é definida pela primeira vez no segredo, a duração do atraso de destruição afeta todas as versões ativas (ativadas e desativadas) do segredo.

   • Quando a duração do atraso de destruição é atualizada ou removida, as alterações refletem-se apenas nas novas versões secretas nas quais a ação de destruição é tentada. As versões do Secret já agendadas para destruição continuam a ser destruídas na hora de destruição agendada.

   Desative a destruição atrasada

   Para desativar a destruição atrasada de versões, use um dos seguintes métodos:

   Consola

   1. Na Cloud de Confiance consola, aceda à página Secret Manager.

      Aceda ao Secret Manager

   2. Na página Secret Manager, clique no separador Segredos regionais.

   3. Para editar um segredo, use um dos seguintes métodos:

      • Clique em more_vertAções para o segredo que quer editar e, de seguida, clique em Editar.

      • Clique no nome do segredo para aceder à página de detalhes do segredo. Na página de detalhes do segredo, clique em editEditar segredo.

   4. Na página Editar segredo, aceda à secção Atrasar destruição da versão do segredo. Desmarque a caixa de verificação Definir duração para destruição atrasada e, de seguida, clique em Atualizar Secret.

   gcloud

   Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

   • SECRET_ID: o ID do segredo
   • LOCATION: a Cloud de Confiance by S3NS localização do segredo

   Execute o seguinte comando:

   Linux, macOS ou Cloud Shell

   gcloud secrets update SECRET_ID --location=LOCATION --remove-version-destroy-ttl

   Windows (PowerShell)

   gcloud secrets update SECRET_ID --location=LOCATION --remove-version-destroy-ttl

   Windows (cmd.exe)

   gcloud secrets update SECRET_ID --location=LOCATION --remove-version-destroy-ttl

   REST

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • LOCATION: a Cloud de Confiance by S3NS localização do segredo
   • PROJECT_ID: o Cloud de Confiance by S3NS ID do projeto
   • SECRET_ID: o ID do segredo

   Método HTTP e URL:

   PATCH https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID?updateMask=version_destroy_ttl

   Corpo JSON do pedido:

   {}
   

   Para enviar o seu pedido, escolha uma destas opções:

   curl

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID?updateMask=version_destroy_ttl"

   PowerShell

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID?updateMask=version_destroy_ttl" | Select-Object -Expand Content

   Deve receber uma resposta JSON semelhante à seguinte:

   {
     "name": "projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID",
     "createTime": "2024-09-04T06:34:32.995517Z",
     "etag": "\"16214564f18f19\""
   }
   

   Agende versões do Secret para destruição atrasada

   Para agendar uma versão secreta para destruição atrasada, use um dos seguintes métodos:

   Consola

   1. Na Cloud de Confiance consola, aceda à página Secret Manager.

      Aceda ao Secret Manager

   2. Na página Secret Manager, clique no separador Segredos regionais e, de seguida, clique num segredo para aceder às respetivas versões. A destruição atrasada de versões tem de ser configurada neste segredo.

   3. Na página de detalhes do segredo, no separador Versões, selecione a versão do segredo que quer destruir.

   4. Clique em more_vertAções e, de seguida, clique em Destruir.

   5. Na caixa de diálogo de confirmação apresentada, introduza o ID do segredo para confirmar e, de seguida, clique em Agendar versões selecionadas para destruição.

   gcloud

   Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

   • SECRET_VERSION_ID: o ID da versão ou o identificador totalmente qualificado da versão
   • SECRET_ID: o ID do segredo
   • LOCATION: a Cloud de Confiance by S3NS localização do segredo

   Execute o seguinte comando:

   Linux, macOS ou Cloud Shell

   gcloud secrets versions destroy SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION

   Windows (PowerShell)

   gcloud secrets versions destroy SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION

   Windows (cmd.exe)

   gcloud secrets versions destroy SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION

   REST

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • LOCATION: a Cloud de Confiance by S3NS localização do segredo
   • PROJECT_ID: o Cloud de Confiance by S3NS ID do projeto
   • SECRET_ID: o ID do segredo
   • VERSION_ID: o ID da versão ou o identificador totalmente qualificado da versão

   Método HTTP e URL:

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

   Corpo JSON do pedido:

   {}
   

   Para enviar o seu pedido, escolha uma destas opções:

   curl

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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

   PowerShell

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:destroy" | Select-Object -Expand Content

   Deve receber uma resposta JSON semelhante à seguinte:

   {
     "name": "projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID",
     "createTime": "2024-09-04T06:41:57.859674Z",
     "state": "DISABLED",
     "etag": "\"16214579184a2c\"",
     "scheduledDestroyTime": "2024-09-05T13:15:28.357251843Z"
   }
   

   A versão do segredo é imediatamente desativada e agendada para destruição após a expiração do período de atraso da destruição. Pode ver a data e a hora exatas em que a versão vai ser destruída na coluna Agendado para destruição a na tabela Versões.

   Restaure versões do Secret

   Pode restaurar uma versão do Secret agendada para destruição ativando ou desativando a versão do Secret.

   Ative uma versão secreta agendada para destruição

   Para ativar uma versão secreta agendada para destruição, use um dos seguintes métodos:

   Consola

   1. Na Cloud de Confiance consola, aceda à página Secret Manager.

      Aceda ao Secret Manager

   2. Na página Secret Manager, clique no separador Segredos regionais e, de seguida, clique num segredo para aceder às respetivas versões.

   3. Na página de detalhes do Secret, no separador Versões, selecione a versão do Secret agendada para destruição.

   4. Clique em more_vertAções e, de seguida, em Ativar.

   5. Na caixa de diálogo de confirmação apresentada, clique em Ativar versões selecionadas.

   gcloud

   Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

   • SECRET_VERSION_ID: o ID da versão ou o identificador totalmente qualificado da versão
   • SECRET_ID: o ID do segredo
   • LOCATION: a Cloud de Confiance by S3NS localização do segredo

   Execute o seguinte comando:

   Linux, macOS ou Cloud Shell

   gcloud secrets versions enable SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION

   Windows (PowerShell)

   gcloud secrets versions enable SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION

   Windows (cmd.exe)

   gcloud secrets versions enable SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION

   REST

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • LOCATION: a Cloud de Confiance by S3NS localização do segredo
   • PROJECT_ID: o Cloud de Confiance by S3NS ID do projeto
   • SECRET_ID: o ID do segredo
   • VERSION_ID: o ID da versão ou o identificador totalmente qualificado da versão

   Método HTTP e URL:

   POST https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:enable

   Corpo JSON do pedido:

   {}
   

   Para enviar o seu pedido, escolha uma destas opções:

   curl

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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

   PowerShell

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:enable" | Select-Object -Expand Content

   Deve receber uma resposta JSON semelhante à seguinte:

   {
     "name": "projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID",
     "createTime": "2024-09-04T06:41:57.859674Z",
     "state": "ENABLED",
     "etag": "\"1621457b3c1459\""
   }
   

   Desative uma versão do Secret agendada para destruição

   Para desativar uma versão secreta agendada para destruição, use um dos seguintes métodos:

   Consola

   1. Na Cloud de Confiance consola, aceda à página Secret Manager.

      Aceda ao Secret Manager

   2. Na página Secret Manager, clique no separador Segredos regionais e, de seguida, clique num segredo para aceder às respetivas versões.

   3. Na página de detalhes do Secret, no separador Versões, selecione a versão do Secret agendada para destruição.

   4. Clique em more_vertAções e, de seguida, em Desativar.

   5. Na caixa de diálogo de confirmação apresentada, clique em Desativar versões selecionadas.

   gcloud

   Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

   • SECRET_VERSION_ID: o ID da versão ou o identificador totalmente qualificado da versão
   • SECRET_ID: o ID do segredo
   • LOCATION: a Cloud de Confiance by S3NS localização do segredo

   Execute o seguinte comando:

   Linux, macOS ou Cloud Shell

   gcloud secrets versions disable SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION

   Windows (PowerShell)

   gcloud secrets versions disable SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION

   Windows (cmd.exe)

   gcloud secrets versions disable SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION

   A resposta contém a versão desativada do segredo.

   REST

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • LOCATION: a Cloud de Confiance by S3NS localização do segredo
   • PROJECT_ID: o Cloud de Confiance by S3NS ID do projeto
   • SECRET_ID: o ID do segredo
   • VERSION_ID: o ID da versão ou o identificador totalmente qualificado da versão

   Método HTTP e URL:

   POST https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:disable

   Corpo JSON do pedido:

   {}
   

   Para enviar o seu pedido, escolha uma destas opções:

   curl

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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

   PowerShell

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:disable" | Select-Object -Expand Content

   Deve receber uma resposta JSON semelhante à seguinte:

   {
     "name": "projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID",
     "createTime": "2024-09-04T06:41:57.859674Z",
     "state": "DISABLED",
     "etag": "\"1621457b3c1459\""
   }
   

   O que se segue?

   • Saiba como garantir a integridade dos dados.
   • Saiba mais acerca das práticas recomendadas.