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:
Abra a página Etiquetas na Google Cloud consola.
Selecione o seu projeto no menu pendente Selecionar um projeto.
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.
Quando terminar de adicionar etiquetas, clique em Guardar.
Para adicionar etiquetas a mais de um projeto ao mesmo tempo:
Abra a página Gerir recursos na Google Cloud consola.
Na página Gerir recursos, selecione os projetos aos quais quer adicionar etiquetas.
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.
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:
- Obtenha o projeto através do método
projects.get()
. - Modifique o campo
labels
. - Atualize o projeto com o método
projects.patch()
.
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:Abra a página Etiquetas na Google Cloud consola.
Selecione o seu projeto no menu pendente Selecionar um projeto.
Atualize as etiquetas do seu projeto:
- Para editar uma etiqueta, clique no valor que quer editar e, de seguida, faça as alterações pretendidas.
- Para eliminar uma etiqueta, mantenha o ponteiro sobre a chave ou o valor e, de seguida, clique em .
Quando terminar de atualizar as etiquetas, clique em Guardar.
Para atualizar as etiquetas de mais de um projeto em simultâneo:
Abra a página Gerir recursos na Google Cloud consola.
Na página Gerir recursos, selecione os projetos para os quais quer atualizar as etiquetas.
No painel de informações, clique no separador Etiquetas e atualize as etiquetas dos projetos selecionados:
- Para editar uma etiqueta, clique no valor que quer editar e, de seguida, faça as alterações pretendidas.
- Para eliminar uma etiqueta, mantenha o ponteiro sobre a chave ou o valor e, de seguida, clique em .
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étodoprojects.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"
},
}
]
}