Adicione etiquetas a segredos

Esta página oferece uma vista geral das etiquetas, descreve como adicionar etiquetas a um segredo e como ver e atualizar etiquetas anexadas a um segredo.

O que são etiquetas?

Uma etiqueta é um par de chave-valor que pode atribuir a Google Cloud segredos do Secret Manager. Ajudam a organizar estes recursos e a gerir os custos em grande escala, com a granularidade de que precisa. Pode anexar uma etiqueta a cada recurso e, em seguida, filtrar os recursos com base nas respetivas etiquetas. As informações sobre as etiquetas são encaminhadas para o sistema de faturação que lhe permite discriminar os custos faturados por etiqueta. Com os relatórios de faturação integrados, pode filtrar e agrupar os custos por etiquetas de recursos. Também pode usar etiquetas para consultar exportações de dados de faturação.

Requisitos para etiquetas

As etiquetas aplicadas a um recurso têm de cumprir os seguintes requisitos:

  • Cada recurso pode ter até 64 etiquetas.
  • Cada etiqueta tem de ser um par chave-valor.
  • As chaves têm um comprimento mínimo de 1 caráter e um comprimento máximo de 63 carateres, e não podem estar vazias. Os valores podem estar vazios e ter um comprimento máximo de 63 carateres.
  • As chaves e os valores só podem conter letras minúsculas, carateres numéricos, sublinhados e travessões. Todos os carateres têm de usar a codificação UTF-8, e são permitidos carateres internacionais. As chaves têm de começar com uma letra minúscula ou um caráter internacional.
  • A parte da chave de uma etiqueta tem de ser exclusiva num único recurso. No entanto, pode usar a mesma chave com vários recursos.

Estes limites aplicam-se à chave e ao valor de cada etiqueta, bem como aos recursos Google Cloud individuais que têm etiquetas. Não existe um limite para o número de etiquetas que pode aplicar a todos os recursos num projeto.

Utilizações comuns das etiquetas

Seguem-se alguns exemplos de utilização comuns das etiquetas:

  • Etiquetas de equipa ou centro de custos: adicione etiquetas com base na equipa ou no centro de custos para distinguir os segredos do Secret Manager pertencentes a diferentes equipas (por exemplo, team:research e team:analytics). Pode usar este tipo de etiqueta para contabilidade de custos ou orçamentação.

  • Etiquetas de componentes: por exemplo, component:redis, component:frontend, component:ingest e component:dashboard.

  • Etiquetas de ambiente ou fase: por exemplo, environment:production e environment:test.

  • Etiquetas de estado: por exemplo, state:active,state:readytodelete e state:archive.

  • Etiquetas de propriedade: usadas para identificar as equipas responsáveis pelas operações, por exemplo: team:shopping-cart.

Não recomendamos a criação de um grande número de etiquetas únicas, como para carimbos de data/hora ou valores individuais para cada chamada da API. O problema desta abordagem é que, quando os valores mudam frequentemente ou com chaves que desorganizam o catálogo, torna-se difícil filtrar e gerar relatórios sobre os recursos de forma eficaz.

Etiquetas e marcadores

As etiquetas podem ser usadas como anotações consultáveis para recursos, mas não podem ser usadas para definir condições nas políticas. As etiquetas oferecem uma forma de permitir ou negar condicionalmente políticas com base no facto de um recurso ter uma etiqueta específica, oferecendo um controlo detalhado sobre as políticas. Para mais informações, consulte a Vista geral das etiquetas.

Crie um segredo com etiquetas

Para adicionar uma etiqueta ao criar o segredo, siga estes passos:

Consola

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

    Aceda ao Secret Manager

  2. Na página Secret Manager, clique em Criar segredo.

  3. Na página Criar segredo, 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. Aceda à secção Etiquetas e, de seguida, clique em Adicionar etiqueta.

  6. Introduza a chave e o valor correspondente para criar uma etiqueta.

  7. Clique em Criar segredo.

Veja etiquetas num segredo

Para ver as etiquetas atribuídas, siga estes passos:

Consola

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

    Aceda ao Secret Manager

  2. Na página Secret Manager, selecione o segredo cujas etiquetas quer ver.

  3. Se o painel de informações estiver fechado, clique em Mostrar painel de informações para o apresentar.

  4. No painel, clique no separador Etiquetas. São apresentadas todas as etiquetas adicionadas ao segredo.

Atualize etiquetas

Para atualizar as etiquetas, siga estes passos:

Consola

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

    Aceda ao Secret Manager

  2. Selecione o segredo que quer editar.

  3. Abra o Painel de informações e, de seguida, clique no separador Etiquetas.

  4. Atualize o valor existente de uma etiqueta e clique em Guardar.

    Também pode eliminar uma etiqueta existente ou adicionar uma nova. Para editar a chave de uma etiqueta, adicione uma nova etiqueta com o mesmo nome da chave e, em seguida, elimine a etiqueta antiga.

Remova marcadores

Para remover etiquetas, siga estes passos:

Consola

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

    Aceda ao Secret Manager

  2. Selecione o segredo que quer editar.

  3. Abra o Painel de informações e, de seguida, clique no separador Etiquetas.

  4. Clique em Eliminar para remover as etiquetas de que já não precisa.

  5. Clique em Guardar.

O que se segue?