Como criar e gerenciar rótulos

Esta página fornece uma breve visão geral dos rótulos e explica como criar e gerenciar rótulos usando a API Resource Manager e o Console do Google Cloud.

O que são rótulos?

Um rótulo é um par de chave-valor que ajuda a organizar suas instâncias do Google Cloud. É 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 centro de custo ou de equipe: adiciona rótulos com base na equipe ou no centro de custo para distinguir as instâncias pertencentes a equipes diferentes (por exemplo, team:research e team:analytics). Você pode usar esse tipo de rótulo para contabilidade de custo 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 máquina virtual: um rótulo pode ser anexado a uma máquina virtual. As tags de máquina virtual definidas no passado serão exibidas como um rótulo sem um valor.

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 criar e gerenciar marcadores por meio da API Resource Manager

Para criar um novo projeto com um rótulo, defina o campo labels ao criar o projeto.

REST

Solicitação:

POST https://cloudresourcemanager.googleapis.com/v1beta1/projects

{
 "labels": {
  "color": "red"
 },
 "name": "myproject",
 "projectId": "our-project-123"
}
Resposta:

{
 "projectNumber": "333197460082",
 "projectId": "our-project-123",
 "lifecycleState": "ACTIVE",
 "name": "myproject",
 "labels": {
  "color": "red"
 },
 "createTime": "2016-01-12T22:18:28.633Z",
}

Python

...

  project = crm.projects().create(
    body={
        'project_id': flags.projectId,
        'name': 'myproject',
        labels.color: "red"
}).execute()

...


Para adicionar marcadores a projetos existentes:

  • Consiga o projeto usando o método get().
  • Modifique o campo labels.
  • Atualize o projeto usando o método update().

Para detalhes sobre como atualizar os marcadores de um projeto, consulte Como atualizar um projeto.

Para detalhes sobre como usar marcadores para filtrar projetos, consulte Como listar projetos.

Permissões

É possível adicionar ou modificar um rótulo chamando o método projects.update(). Isso exige a permissão resourcemanager.projects.update.

É possível ver o rótulo de um projeto, chamando o método projects.get(). Isso exige a permissão resourcemanager.projects.get.

Como criar e gerenciar rótulos usando o Console do Cloud

Para adicionar rótulos a um único projeto:

  1. Abra a página Rótulos no Console do Cloud.
    Abrir a página Rótulos
  2. Selecione seu projeto na lista suspensa Sel. projeto.
  3. Para adicionar uma nova entrada de rótulo, clique em + Adicionar rótulo e insira a chave e o valor para cada rótulo que você quer adicionar.
  4. Ao terminar de adicioná-los, clique em Salvar.

Para adicionar marcadores a mais de um projeto ao mesmo tempo:

  1. Abra a página Gerenciar recursos no Console do Cloud.
    Abrir a página Gerenciar recursos
  2. Na página Gerenciar recursos, selecione a organização e os projetos aos quais você quer adicionar rótulos.
  3. No painel direito, na guia Rótulos, clique em + Adicionar rótulo e insira a chave e o valor para cada rótulo que você quer adicionar.
  4. Ao terminar de adicioná-los, clique em Salvar.

Depois de adicionar os marcadores, você poderá filtrar os projetos digitando a chave ou o valor do marcador na caixa de filtro acima da lista de projetos. A caixa de filtro faz a sugestão de chaves e valores para que você possa visualizar os resultados.

Serviços atuais que permitem marcadores

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

  • BigQuery
  • Cloud Bigtable
  • Dataflow
  • Dataproc
  • Cloud Deployment Manager
  • Cloud Functions
  • API Cloud Healthcare
  • Cloud Key Management Service
  • Pub/Sub
  • Cloud Spanner
  • Cloud SQL
  • Cloud Storage
  • Compute Engine
  • Google Kubernetes Engine
  • Cloud Run (totalmente gerenciado)
  • Rede
  • Resource Manager
  • App Engine (ambientes flexível e padrão)