Como usar marcadores

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

O que são rótulos?

Um rótulo é uma ferramenta que ajuda você a organizar os recursos do Google Cloud Platform. É possível anexar um rótulo aos recursos. Por exemplo, você pode rotular recursos por ambiente (teste ou produção) e proprietário (Alice ou Bob) e depois filtrá-los com base no objetivo do uso e em quem são os proprietários. A filtragem com rótulos ajuda a encontrar facilmente os recursos que você está procurando.

Uma entidade de rótulo é um par chave:valor que você pode anexar a um projeto ou uma máquina virtual (VM, na sigla em inglês). As tags de VM que você definiu no passado também serão exibidas como rótulos sem valor.

Usos comuns dos rótulos

Eis algumas maneiras típicas para usar rótulos:

  • Rótulos baseados em equipe ou centro de custo. Adicione rótulos baseados em equipe ou centro de custo para distinguir projetos pertencentes a equipes diferentes. Isso pode ser usado na contabilidade de custos ou preparação de orçamentos. Por exemplo, team:marketing e team:research.

  • Rótulos baseados em componente. Por exemplo, component:redis e component:frontend.

  • Rótulos baseados em ambiente ou cenário. Por exemplo, environment:prod e environment:test.

  • Rótulos baseados em proprietário ou contato. Adicione rótulos com base no proprietário ou em um contato principal, se houver um indivíduo que seja responsável por um recurso e seja o contato principal do recurso.

  • Rótulos baseados em estado. Por exemplo, state:inuse e state:readyfordeletion.

Os rótulos aplicados aos recursos que geram métricas de uso são encaminhados para o sistema de faturamento. Assim, é possível dividir as cobranças de acordo com os critérios dos rótulos. Há alguns limites no sistema que, quando atingidos, resultam no descarte dos dados dos rótulos. Especificamente, para um determinado serviço de relatório e projeto, o número de mapas de rótulos distintos que serão preservados dentro do período de uma hora é 1.000. Por exemplo, o serviço do Compute Engine informa métricas em instâncias de VM. Se você implantar um projeto com 2.000 VMs, cada uma com um rótulo diferente, somente os primeiros 1.000 mapas de rótulos vistos dentro do período de uma hora serão preservados.

Como criar e gerenciar rótulos por meio da Resource Manager API

Para criar um novo projeto com um rótulo, basta definir 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",
}

Biblioteca de cliente do Python

...

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

...


Para adicionar rótulos para projetos existentes:

  • Receba o projeto usando o método get().
  • Modifique o campo label.
  • Atualize o projeto usando o método update().

Para informações e snippets de código sobre projetos de atualização, consulte Atualização de um projeto.

Uma das principais vantagens dos rótulos é que eles permitem filtrar projetos. Para informações e snippets de código sobre projetos de filtragem em rótulos, consulte Listagem de projetos.

Como criar e gerenciar marcadores por meio do Console do GCP

Para adicionar marcadores a um único projeto, siga as seguintes etapas:

  1. Abra a página "IAM e administrador" no Console do GCP.

    Abrir a página do IAM

  2. Selecione o projeto na caixa suspensa Selecionar um projeto e clique em Continuar.
  3. No barra de navegação à esquerda, clique em Rótulos.
  4. Clique em + Adicionar item.
  5. Adicione um valor e uma chave do rótulo e clique em Salvar. É possível adicionar mais valores de rótulo clicando em + Adicionar item.

Para adicionar marcadores a mais de um projeto ao mesmo tempo, siga as seguintes etapas:

  1. Abra a página "Projetos do IAM e administrador" no Console do GCP.

    Abrir a página "Projetos do IAM e administrador"

  2. No painel central, selecione os projetos para os quais você deseja adicionar rótulos.
  3. No painel direito, clique na guia Rótulos.
  4. Clique em + Adicionar item.
  5. Digite o valor e a chave do rótulo e clique em Salvar.

É possível filtrar projetos usando os rótulos adicionados. Basta digitar uma chave ou um valor na caixa de pesquisa acima da lista de projetos. A caixa de pesquisa sugere automaticamente as consultas corretas e possibilita a visualização dos resultados.

Serviços atuais compatíveis com marcadores

No momento, estes são os seguintes serviços do GCP compatíveis com marcadores:

  • Cloud Functions
  • Rede
  • Cloud SQL
  • Compute Engine
  • Kubernetes Engine
  • Cloud Storage
  • Cloud Dataproc
  • Cloud Spanner
  • Cloud Dataflow
  • BigQuery
  • Resource Manager
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Resource Manager