Criar e atualizar identificadores de projetos

Este documento fornece detalhes sobre como criar e atualizar rótulos para projetos usando a CLI gcloud, a API Cloud Resource Manager e o Google Cloud console.

Criar rótulos para projetos

Console

Para adicionar rótulos a um único projeto:

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

    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 do rótulo 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 Google Cloud console.

    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 uma chave do rótulo e um valor para cada identificador que você quer adicionar.

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

Depois de adicionar os rótulos, você poderá filtrar os projetos digitando a chave do rótulo ou o valor 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 para projetos

Console

Para atualizar identificadores de um único projeto:

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

    Abrir a página "Marcadores"

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

  3. Atualize os identificadores do projeto:

    1. Para editar um identificador, clique no valor que você quer editar e faça as alterações pretendidas.
    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 Google Cloud console.

    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 identificador, clique no valor que você quer editar e faça as alterações pretendidas.
    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 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.