Como criar e gerenciar rótulos

O Cloud Bigtable oferece a opção de adicionar rótulos às instâncias. Rótulos são pares de chave-valor que você pode usar para agrupar instâncias relacionadas e armazenar metadados sobre uma instância.

Nesta página, explicamos como você pode usar rótulos com as instâncias do Cloud Bigtable. Nela também descrevemos como adicionar, atualizar e remover os rótulos de uma instância.

O que são rótulos?

Um rótulo é um par de chave-valor que ajuda você a organizar suas instâncias do Cloud Bigtable no Google Cloud Platform. É possível anexar um rótulo a cada recurso e filtrar os recursos com base nesses rótulos. As informações sobre os rótulos são encaminhadas ao sistema de faturamento para que você possa classificar as cobranças de faturamento por rótulo.

Usos comuns dos rótulos

Não recomendamos a criação de um grande número de rótulos exclusivos, como carimbos de data/hora ou valores individuais para todas as chamadas de API. Veja alguns casos de uso comum de rótulos:

  • Rótulos de equipe ou de centro de custos: adicione rótulos de acordo com a equipe ou o centro de custos para distinguir as instâncias do Cloud Bigtable que pertençam a equipes diferentes, por exemplo, team:research e team:analytics. Você pode usar esse tipo de rótulo para contabilidade de custos ou elaboração de orçamentos.

  • Rótulos de componentes: por exemplo, component:redis, component:frontend, component:ingest e component:dashboard.

  • Rótulos de ambiente ou estágio: por exemplo, environment:production e environment:test.

  • Rótulos de estado: por exemplo, state:active, state:readytodelete e state:archive.

Requisitos para rótulos

Os rótulos aplicados a um recurso precisam atender aos seguintes requisitos:

  • Cada recurso pode ter vários rótulos, até um máximo de 64.
  • Cada rótulo precisa ser um par de chave-valor.
  • As chaves têm comprimento mínimo de 1 e máximo de 63 caracteres. Além disso, elas não podem estar vazias. Os valores podem estar vazios e ter um comprimento máximo de 63 caracteres.
  • As chaves e os valores contêm apenas letras minúsculas, caracteres numéricos, sublinhados e traços. Todos os caracteres precisam usar a codificação UTF-8, e os caracteres internacionais são permitidos.
  • A parte da chave de um rótulo precisa ser única. No entanto, use a mesma chave com vários recursos.
  • As chaves precisam começar com uma letra minúscula ou um caractere internacional.

Como adicionar ou atualizar os rótulos de uma instância

Depois de criar uma instância do Cloud Bigtable, você poderá usar o console do Google Cloud Platform para adicionar rótulos à instância e atualizar os existentes. Outra maneira de fazer isso é usar uma API RPC Admin ou a API REST Admin.

Para adicionar ou atualizar rótulos a uma instância do Cloud Bigtable usando o console do GCP, siga estas etapas:

  1. Abra a lista de instâncias do Cloud Bigtable no console do GCP.

    Abrir a lista de instâncias

  2. Marque a caixa ao lado de cada instância com rótulos que você quer modificar.

  3. Se o painel Rótulos não estiver visível, clique em Mostrar painel de informações no canto superior direito para abri-lo.

  4. Adicione e atualize os rótulos conforme necessário.

    Para adicionar um novo rótulo, clique em Adicionar rótulo e digite a chave e o valor do rótulo.

    Para modificar um rótulo existente, atualize o valor dele. Não é possível alterar a chave de um rótulo existente.

  5. Clique em Salvar para salvar as alterações.

Como remover um rótulo de uma instância

Para remover um rótulo de uma instância do Cloud Bigtable usando o Console GCP, faça o seguinte:

  1. Abra a lista de instâncias do Cloud Bigtable no console do GCP.

    Abrir a lista de instâncias

  2. Marque a caixa ao lado de cada instância com rótulos que você quer remover.

  3. Se o painel Rótulos não estiver visível, clique em Mostrar painel de informações no canto superior direito para abri-lo.

  4. Clique no X ao lado de todos os rótulos que você quer remover.

  5. Clique em Salvar para salvar as alterações.

Próximas etapas

Saiba como modificar outras propriedades de uma instância do Cloud Bigtable.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Cloud Bigtable