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:
Abra a página Rótulos no console do Google Cloud.
Selecione seu projeto na lista suspensa Sel. projeto.
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.
Ao terminar de adicioná-los, clique em Salvar.
Para adicionar marcadores a mais de um projeto ao mesmo tempo:
Abra a página Gerenciar recursos no console do Google Cloud.
Na página Gerenciar recursos, selecione os projetos em que você quer adicionar identificadores.
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.
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:
- Consiga o projeto usando o método
projects.get()
. - Modifique o campo
labels
. - Atualize o projeto usando o método
projects.patch()
.
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
Abra a página Rótulos no console do Google Cloud.
Selecione seu projeto na lista suspensa Sel. projeto.
Atualize os identificadores do projeto:
- Para editar um identificador, clique no valor que você quer editar e faça as alterações pretendidas.
- Para excluir um identificador, mantenha o ponteiro do mouse sobre a chave ou o valor e clique em .
Ao terminar de adicioná-los, clique em Salvar.
Para adicionar identificadores a mais de um projeto ao mesmo tempo:
Abra a página Gerenciar recursos no console do Google Cloud.
Na página Gerenciar recursos, selecione os projetos com os identificadores que você quer atualizar.
No painel de informações, clique na guia Identificadores e atualize os identificadores dos projetos selecionados:
- Para editar um identificador, clique no valor que você quer editar e faça as alterações pretendidas.
- Para excluir um identificador, mantenha o ponteiro do mouse sobre a chave ou o valor e clique em .
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étodoprojects.get()
.Modifique os identificadores que você quer atualizar.
Chame o método
projects.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"
},
}
]
}