Esta página descreve como editar os metadados de um segredo. Pode atualizar muitas propriedades de um segredo, como o tipo de encriptação, a política de rotação, a data de validade, as etiquetas e as notificações de eventos. Também pode adicionar anotações e configurar aliases para versões secretas. Não pode editar o nome nem o valor do segredo. Para adicionar um novo valor ao seu segredo, tem de criar uma nova versão do segredo.
Funções necessárias
Para receber as autorizações de que precisa para atualizar os metadados de um segredo,
peça ao seu administrador que lhe conceda a função de IAM
Administrador do Secret Manager (roles/secretmanager.admin
)
no segredo ou no projeto.
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.
Edite um segredo
Para editar um segredo, use um dos seguintes métodos:
Consola
-
Na Google Cloud consola, aceda à página Secret Manager.
-
Na página Secret Manager, clique no separador Segredos regionais.
-
Para editar um segredo, use uma das seguintes opções:
-
Localize o segredo na lista e clique no menu
Ações associado a esse segredo. No menu Ações, 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
Editar segredo.
-
-
Na página Editar chave secreta, atualize as propriedades da chave secreta conforme necessário e, de seguida, clique em Atualizar chave secreta.
gcloud
Certifique-se de que configurou o Secret Manager para usar um ponto final regional para gerir segredos regionais.Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:
- SECRET_ID: o ID do segredo ou o identificador totalmente qualificado do segredo
- LOCATION: a Google Cloud localização do segredo
- KEY: a chave da etiqueta
- VALUE: o valor correspondente da etiqueta
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud secrets update SECRET_ID --location=LOCATION \ --update-labels=KEY=VALUE
Windows (PowerShell)
gcloud secrets update SECRET_ID --location=LOCATION ` --update-labels=KEY=VALUE
Windows (cmd.exe)
gcloud secrets update SECRET_ID --location=LOCATION ^ --update-labels=KEY=VALUE
A resposta devolve a chave secreta atualizada.
REST
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- LOCATION: a Google Cloud localização do segredo
- PROJECT_ID: o Google Cloud ID do projeto
- SECRET_ID: o ID do segredo ou o identificador totalmente qualificado do segredo
- KEY: a chave da etiqueta
- VALUE: o valor correspondente da etiqueta
Método HTTP e URL:
PATCH https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID?updateMask=labels
Corpo JSON do pedido:
{'labels': {'KEY': 'VAL'}}
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=labels"
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=labels" | Select-Object -Expand Content
Deve receber uma resposta JSON semelhante à seguinte:
{ "name": "projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID", "createTime": "2024-09-02T07:14:00.281541Z", "labels": { "key": "value" }, "etag": "\"16211dc7d040b1\"" }
Go
Para executar este código, primeiro configure um ambiente de desenvolvimento Go e instale o SDK Go do Secret Manager. No Compute Engine ou no GKE, tem de autenticar-se com o âmbito cloud-platform.
Java
Para executar este código, primeiro configure um ambiente de desenvolvimento Java e instale o SDK Java do Secret Manager. No Compute Engine ou no GKE, tem de autenticar-se com o âmbito cloud-platform.
Node.js
Para executar este código, primeiro configure um ambiente de desenvolvimento do Node.js e instale o SDK do Node.js do Secret Manager. No Compute Engine ou no GKE, tem de autenticar-se com o âmbito cloud-platform.
Python
Para executar este código, primeiro configure um ambiente de desenvolvimento Python e instale o SDK Python do Secret Manager. No Compute Engine ou no GKE, tem de autenticar-se com o âmbito cloud-platform.
Edite autorizações e etiquetas para vários segredos
Pode editar autorizações e etiquetas para vários segredos através da Google Cloud consola.
-
Na Google Cloud consola, aceda à página Secret Manager.
-
Na página Secret Manager, clique no separador Segredos regionais e, de seguida, selecione os segredos para os quais quer editar as autorizações e as etiquetas.
-
Se o painel de informações estiver fechado, clique em Mostrar painel de informações para o apresentar.
-
As autorizações e as etiquetas configuradas para todos os segredos são apresentadas no Painel de informações nos respetivos separadores. Aceda aos separadores individuais e atualize os valores conforme necessário.
-
Clique em Guardar quando terminar.
O que se segue?
- Faça a gestão do acesso a segredos regionais
- Crie agendas de rotação
- Configure notificações num segredo regional