Como criar e gerenciar rótulos

Nesta página, apresentamos uma breve visão geral dos marcadores e explicamos como criar e gerenciar marcadores usando a Resource Manager API e o Console do Google Cloud Platform.

O que são rótulos?

Um rótulo é um par de valores-chave que ajuda você a organizar suas instâncias do 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

Veja alguns casos de uso comum para rótulos:

  • Rótulos de equipe ou centro de custo: adicione rótulos com base na equipe ou no centro de custo para distinguir instâncias pertencentes a equipes diferentes (por exemplo, team:research e team:analytics). Esse tipo de rótulo pode ser usado 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 ambientes ou etapas: 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 um e máximo de 63 caracteres, e 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.

Para um determinado projeto e serviço de geração de relatórios, o número de combinações distintas de pares de chave-valor que serão mantidas em um período de uma hora é de 1.000. Por exemplo, o serviço do Compute Engine relata as métricas nas instâncias de máquina virtual (VM, na sigla em inglês). Se você implantar um projeto com 2.000 VMs, cada uma com um marcador diferente, as métricas dos relatórios do serviço serão mantidas apenas para os primeiros 1.000 marcadores existentes nesse período de uma hora.

Como criar e gerenciar marcadores por meio da Resource Manager API

Para gerar um novo projeto com um marcador, defina o campo label 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:

  • Acesse o projeto usando o método get().
  • Modifique o campo label.
  • 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.

Como criar e gerenciar marcadores usando o Console do GCP

Para adicionar marcadores a um único projeto:

  1. Abra a página Marcadores no Console do GCP.
    Abrir a página "Marcadores"
  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 GCP.
    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

No momento, estes são os serviços do GCP compatíveis com rótulos:

  • BigQuery
  • Cloud Bigtable
  • Cloud Dataflow
  • Cloud Dataproc
  • Cloud Deployment Manager
  • Cloud Functions
  • Cloud Key Management Service
  • Cloud Pub/Sub
  • Cloud Spanner
  • Cloud SQL
  • Cloud Storage
  • Compute Engine
  • Google Kubernetes Engine
  • Rede
  • Resource Manager
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Resource Manager