Como gerenciar rótulos

Nesta página, mostramos como usar rótulos com as instâncias do Filestore. Ela também descreve como adicionar, atualizar e excluir os rótulos de uma instância. Use rótulos para agrupar instâncias relacionadas e armazenar metadados sobre uma instância.

O que são rótulos?

Um rótulo é um par de chave-valor que ajuda a organizar as instâncias do Google Cloud Filestore. É 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 custo: adicione rótulos com base em equipe ou centro de custo para distinguir instâncias do Filestore pertencentes a equipes diferentes (por exemplo, team:research e team:analytics). Você pode usar esse tipo de rótulo para contabilização de custos ou orçamento.

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

  • Rótulos de ambientes ou de estágios: 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 Filestore, será possível adicionar rótulos a ela, bem como atualizar ou excluir os existentes.

Console

  1. No Console do Cloud, acesse a página de instâncias do Filestore.

    Acessar a página de instâncias do Filestore

  2. Marque a caixa de seleção ao lado de cada instância que contenha os rótulos você quer modificar.

  3. Clique em Mostrar painel de informações no canto superior direito para abri-lo.

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

    Operação Instruções
    Adicione um marcador Clique em Adicionar rótulo e digite a chave e o valor do rótulo.
    Atualizar um rótulo Atualize o campo Valor. Não é possível atualizar a Chave de um rótulo existente.
    Excluir um rótulo Clique em Excluir item ao lado do rótulo.
  5. Clique em Salvar para salvar as alterações quando terminar de atualizar suas atualizações.

gcloud

Para editar os rótulos de uma instância do Filestore, execute o comando instances update. Para adicionar novos rótulos ou alterar os valores dos rótulos atuais, use a sinalização --update-labels. Para excluir um ou mais rótulos, use a sinalização --remove-labels. A sinalização --clear-labels remove todos os rótulos de uma instância.

gcloud filestore instances update instance-id \
    --project=project-id \
    --zone=zone \
    --update-labels key=value,[key=value,…] \
    --remove-labels key,[key,…] \
    --clear-labels

onde:

  • instance-id é o ID da instância que você quer editar.
  • project-id é o ID do projeto do Cloud que contém a instância do Filestore. É possível ignorar essa sinalização se a instância do Filestore estiver no projeto padrão gcloud. Para definir o projeto padrão, execute:

     gcloud config set project project-id
    
  • zone é a zona em que a instância do Filestore reside. Execute o comando gcloud filestore zones list para ver uma lista de zonas compatíveis. Pule essa sinalização se a instância do Filestore estiver na zona padrão gcloud. Para definir a zona padrão, execute:

     gcloud config set filestore/zone zone
    
  • key é um novo rótulo ou um rótulo atual que você quer alterar ou remover.

  • value é o valor de um rótulo.

Exemplo

O exemplo a seguir atualiza a instância do nfs-server adicionando o rótulo de status, atualizando o valor do rótulo de dept e removendo o rótulo de administrador.

gcloud filestore instances update nfs-server \
    --project=myproject \
    --zone=us-central1-c \
    --update-labels status=active \
    --update-labels dept=accounting \
    --remove-labels admin

A seguir

Saiba como editar outras propriedades de uma instância do Filestore.