Criar e atualizar rótulos para projetos

Este documento fornece detalhes sobre como criar e atualizar rótulos para projetos usando a API Resource Manager e o console do Google Cloud. Ele fornece detalhes sobre como entender os custos usando rótulos e os serviços compatíveis com eles.

Criar rótulos para projetos

Console

Para adicionar rótulos a um único projeto:

  1. Abra a página Marcadores 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.

REST

Para criar um novo projeto com um identificador, defina o campo labels ao criar o projeto.

Solicitação:

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

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

Saída:

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

Para adicionar marcadores a projetos existentes:

Depois de adicionar identificadores, é possível filtrar projetos com base neles. Para detalhes sobre como usar identificadores para filtrar projetos, consulte Como listar projetos.

Atualizar rótulos de projetos

Console

Para atualizar identificadores de um único projeto:

  1. Abra a página Marcadores 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 modificar e depois fazer 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 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.

REST

Para atualizar os identificadores de um projeto, faça o seguinte:

  • Consiga o objeto project usando o método projects.get().

  • Modifique os identificadores que você quer atualizar.

  • Chame o métodoprojects.patch

O exemplo a seguir atualiza o identificador color:blue:

O snippet de código a seguir muda o valor do identificador color de blue para red.

Solicitação:

PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NAME
{
  updateMask=labels
}

Em que PROJECT_NAME é o nome do projeto que você quer atualizar.

Solicitar corpo JSON:

{
    "labels":
      {
        "color": "red"
      }
}

Resposta:

{
    "projects": [
    {
        "name": "projects/123456789012",
        "parent": "folders/123456789012",
        "projectId": "my-project",
        "state": "ACTIVE",
        "displayName": "PROJECT_NAME"
        "createTime": "2013-11-13T20:31:53.308Z"
        "updateTime": "2013-11-13T20:35:42.308Z"
        "etag": "BwWUlZ6XEfY="
        "labels": {
            "color": "red"
        },
    }
    ]
}