Criar e atualizar identificadores de projetos

Com os rótulos, é possível organizar seus projetos do Google Cloud e acompanhar os custos em equipes ou ambientes. Para gerenciar rótulos de projeto, use o console doGoogle Cloud , a Google Cloud CLI ou a API Cloud Resource Manager.

Os rótulos se aplicam apenas a projetos. As pastas e os recursos da organização não aceitam rótulos, e os rótulos anexados a um projeto não são propagados automaticamente para os recursos filhos. Para aplicar ou atualizar rótulos em recursos de serviço específicos, como instâncias do Compute Engine ou buckets do Cloud Storage, consulte a documentação do recurso ou Serviços que aceitam rótulos. Por exemplo, o Pub/Sub é compatível com rótulos para faturamento de capacidade de tópicos e assinaturas, mas as SKUs de faturamento de saída não são compatíveis com rótulos.

Criar rótulos para projetos

Console

Para adicionar rótulos a um único projeto:

  1. Abra a página Rótulos no console do Google Cloud .

    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 Google Cloud .

    Abrir a página "Gerenciar recursos"

  2. Na página Gerenciar recursos, selecione os projetos em que você quer adicionar identificadores.

  3. No painel de informações, na guia Identificadores, clique em + Adicionar rótulo e insira um valor e uma chave para cada identificador 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.

gcloud

Para criar um novo projeto com rótulos usando a CLI gcloud, use o comando gcloud projects create com a flag --labels:

gcloud projects create PROJECT_ID \
    --labels=KEY1=VALUE1,KEY2=VALUE2

Para adicionar rótulos a um projeto existente, use o comando gcloud projects update com a flag --update-labels:

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

Em que:

  • PROJECT_ID é o ID do projeto que você quer criar ou atualizar.
  • KEY1=VALUE1 é um par de chave-valor para o rótulo que você quer adicionar.

REST

Para criar um novo projeto com um rótulo, inclua o campo labels ao fazer uma solicitação POST para o método projects.create:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "PROJECT_ID",
    "displayName": "PROJECT_NAME",
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects"

Para adicionar rótulos a um projeto existente, use o método projects.patch:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

Atualizar rótulos de projetos

Console

Para atualizar identificadores de um único projeto:

  1. Abra a página Rótulos no console do Google Cloud .

    Abrir a página "Marcadores"

  2. Selecione seu projeto na lista suspensa Sel. projeto.

  3. Atualize os identificadores do projeto:

    1. Para editar um rótulo, clique no valor que você quer editar e faça as alterações desejadas.
    2. Para excluir um identificador, mantenha o ponteiro do mouse sobre a chave ou o valor e clique em .

  4. Ao terminar de adicioná-los, clique em Salvar.

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

  1. Abra a página Gerenciar recursos no console do Google Cloud .

    Abrir a página "Gerenciar recursos"

  2. Na página Gerenciar recursos, selecione os projetos com os identificadores que você quer atualizar.

  3. No painel de informações, clique na guia Identificadores e atualize os identificadores dos projetos selecionados:

    1. Para editar um rótulo, clique no valor que você quer editar e faça as alterações desejadas.
    2. Para excluir um identificador, mantenha o ponteiro do mouse sobre a chave ou o valor e clique em .

  4. Ao terminar de adicioná-los, clique em Salvar.

gcloud

Para atualizar os rótulos de um projeto usando a CLI gcloud, use o comando gcloud projects update com a flag --update-labels, --remove-labels ou --clear-labels.

Para adicionar ou atualizar rótulos:

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

Para remover rótulos específicos:

gcloud projects update PROJECT_ID \
    --remove-labels=KEY1,KEY2

Para remover todos os rótulos de um projeto:

gcloud projects update PROJECT_ID \
    --clear-labels

REST

Para atualizar os rótulos de um projeto usando a API, envie uma solicitação PATCH para o método projects.patch:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "color": "red"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

Em que PROJECT_ID é o ID do projeto que você quer atualizar.