Crie e faça a gestão de etiquetas de instâncias

O Bigtable oferece a opção de adicionar etiquetas às suas instâncias. As etiquetas são pares de chave-valor que pode usar para agrupar instâncias relacionadas e armazenar metadados sobre uma instância.

Esta página explica como pode usar etiquetas com as suas instâncias do Bigtable. Também descreve como adicionar, atualizar e remover as etiquetas de uma instância.

O que são etiquetas?

Uma etiqueta é um par de chave-valor que pode atribuir a Google Cloud instâncias. 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 encargos 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 instâncias 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 criar 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.

Adicionar ou atualizar as etiquetas de uma instância

Depois de criar uma instância do Bigtable, pode usar a consola para adicionar etiquetas à instância e atualizar as etiquetas existentes. Google Cloud Também pode usar a API Admin RPC ou a API Admin REST para adicionar ou atualizar etiquetas.

Para adicionar ou atualizar etiquetas para uma instância do Bigtable através da Google Cloud consola:

  1. Abra a lista de instâncias do Bigtable na Google Cloud consola.

    Abra a lista de instâncias

  2. Selecione a caixa junto a cada instância cujos marcadores quer modificar.

  3. Se o painel Etiquetas não estiver visível, clique em Mostrar painel de informações no canto superior direito para o abrir.

  4. Adicione e atualize etiquetas conforme necessário.

    Para adicionar uma nova etiqueta, clique em Adicionar etiqueta e, de seguida, escreva a chave e o valor da etiqueta.

    Para modificar uma etiqueta existente, atualize o respetivo valor. Não pode alterar a chave de uma etiqueta existente.

  5. Clique em Guardar para guardar as alterações.

Remova uma etiqueta de uma instância

Para remover uma etiqueta de uma instância do Bigtable através da Google Cloud consola:

  1. Abra a lista de instâncias do Bigtable na Google Cloud consola.

    Abra a lista de instâncias

  2. Selecione a caixa junto a cada instância cujas etiquetas quer remover.

  3. Se o painel Etiquetas não estiver visível, clique em Mostrar painel de informações no canto superior direito para o abrir.

  4. Clique no X junto a cada etiqueta que quer remover.

  5. Clique em Guardar para guardar as alterações.

O que se segue?