Criar e atualizar identificadores de 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

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.

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 identificadores de projetos

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

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"
        },
    }
    ]
}