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. Os rótulos permitem 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 pode ser atribuído às instâncias do Google Cloud Filestore. Eles ajudam a organizar esses recursos e gerenciar seus custos em escala, com a granularidade necessária. É possível anexar um rótulo a cada recurso e filtrar os recursos com base nesses rótulos. As informações sobre rótulos são encaminhadas ao sistema de faturamento, que permite detalhar as cobranças faturadas por rótulo. Com os relatórios de faturamento integrados, é possível filtrar e agrupar custos por rótulos de recursos. Também é possível usar rótulos para consultar as exportações de dados de faturamento.

Requisitos para rótulos

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

  • Cada recurso pode ter até 64 rótulos.
  • 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. As chaves precisam começar com uma letra minúscula ou um caractere internacional.
  • A parte principal de um rótulo de cluster precisa ser exclusiva em um único recurso. No entanto, é possível usar a mesma chave com vários recursos.

Esses limites se aplicam à chave e ao valor de cada rótulo e aos recursos individuais do Google Cloud que têm rótulos. Não há limite para a quantidade de rótulos que podem ser aplicados a todos os recursos em um projeto.

Usos comuns dos rótulos

Veja alguns casos de uso comum para 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.

  • Rótulos de propriedade: usados para identificar as equipes responsáveis pelas operações, por exemplo: team:shopping-cart.

Não recomendamos a criação de um grande número de rótulos exclusivos, como os relacionados a carimbos de data/hora ou valores individuais, para todas as chamadas de API. O problema com essa abordagem é que, quando os valores mudam com frequência ou com chaves que desordenam o catálogo, isso dificulta a filtragem e a geração de relatórios sobre os recursos.

Rótulos e tags

Os rótulos podem ser usados como anotações de consulta para recursos, mas não podem ser usados para definir condições em políticas. Com as tags, é possível permitir ou negar políticas condicionalmente com base em um recurso ter ou não uma tag específica, fornecendo controle refinado sobre as políticas. Para mais informações, consulte a Visão geral das tags.

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

É possível adicionar rótulos a uma instância do Filestore ao criar a instância. Após a criação de uma instância, é possível adicionar mais rótulos, bem como atualizar ou excluir rótulos existentes.

Console

  1. No console do Google Cloud, acesse a página "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.

  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

Execute o comando instances update para editar os rótulos de uma instância do Filestore. 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 Google 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

Serviços atuais que permitem marcadores

Os seguintes serviços do Google Cloud são compatíveis com rótulos atualmente:

  • AI Platform
  • App Engine (ambientes flexível e padrão)
  • Artifact Registry
  • BigQuery
  • Certificate Authority Service
  • Cloud Composer
  • Bigtable
  • Cloud Deployment Manager
  • Cloud Functions
  • API Cloud Healthcare
  • Cloud Key Management Service
  • Cloud Run
  • Spanner
  • Cloud SQL
  • Cloud Storage
  • Compute Engine
  • Dataflow
  • Dataproc
  • Filestore
  • Google Kubernetes Engine
  • Rede
  • Pub/Sub
  • Resource Manager (somente projetos)

A seguir

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