Crie e atualize etiquetas para projetos

Este documento fornece detalhes sobre como criar e atualizar etiquetas para projetos através da API Resource Manager e da Google Cloud consola. Fornece detalhes sobre como compreender os custos através de etiquetas e os serviços que suportam etiquetas.

Crie etiquetas para projetos

Consola

Para adicionar etiquetas a um único projeto:

  1. Abra a página Etiquetas na Google Cloud consola.

    Abra a página Etiquetas

  2. Selecione o seu projeto no menu pendente Selecionar um projeto.

  3. Para adicionar uma nova entrada de etiqueta, clique em + Adicionar etiqueta e introduza uma chave de etiqueta e um valor para cada etiqueta que quer adicionar.

  4. Quando terminar de adicionar etiquetas, clique em Guardar.

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

  1. Abra a página Gerir recursos na Google Cloud consola.

    Abra a página Gerir recursos

  2. Na página Gerir recursos, selecione os projetos aos quais quer adicionar etiquetas.

  3. No painel de informações, no separador Etiquetas, clique em + Adicionar etiqueta e introduza uma chave e um valor de etiqueta para cada etiqueta que quer adicionar.

  4. Quando terminar de adicionar etiquetas, clique em Guardar.

Depois de adicionar etiquetas, pode filtrar projetos escrevendo uma chave ou um valor de etiqueta na caixa de filtro acima da lista de projetos. A caixa de filtro sugere chaves e valores para que possa pré-visualizar os resultados.

REST

Para criar um projeto novo com uma etiqueta, defina o campo labels quando criar o projeto.

Pedido:

POST https://cloudresourcemanager.googleapis.com/v3/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",
}

Para adicionar etiquetas a projetos existentes:

Depois de adicionar etiquetas, pode filtrar projetos com base nas etiquetas. Para ver detalhes sobre a utilização de etiquetas para filtrar projetos, consulte o artigo Listar projetos.

Atualize as etiquetas dos projetos

Consola

Para atualizar as etiquetas de um único projeto:

  1. Abra a página Etiquetas na Google Cloud consola.

    Abra a página Etiquetas

  2. Selecione o seu projeto no menu pendente Selecionar um projeto.

  3. Atualize as etiquetas do seu projeto:

    1. Para editar uma etiqueta, clique no valor que quer editar e, de seguida, faça as alterações pretendidas.
    2. Para eliminar uma etiqueta, mantenha o ponteiro sobre a chave ou o valor e, de seguida, clique em .
  4. Quando terminar de atualizar as etiquetas, clique em Guardar.

Para atualizar as etiquetas de mais de um projeto em simultâneo:

  1. Abra a página Gerir recursos na Google Cloud consola.

    Abra a página Gerir recursos

  2. Na página Gerir recursos, selecione os projetos para os quais quer atualizar as etiquetas.

  3. No painel de informações, clique no separador Etiquetas e atualize as etiquetas dos projetos selecionados:

    1. Para editar uma etiqueta, clique no valor que quer editar e, de seguida, faça as alterações pretendidas.
    2. Para eliminar uma etiqueta, mantenha o ponteiro sobre a chave ou o valor e, de seguida, clique em .
  4. Quando terminar de atualizar as etiquetas, clique em Guardar.

REST

Para atualizar as etiquetas de um projeto, faça o seguinte:

  • Obtenha o objeto project através do método projects.get().

  • Modifique as etiquetas que quer atualizar.

  • Chame o método projects.patch.

O exemplo seguinte atualiza a etiqueta color:blue:

O seguinte fragmento de código altera o valor da etiqueta color de blue para red.

Pedido:

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

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

Corpo JSON do pedido:

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