Ver e atualizar projetos

Nesta página, explicamos como recuperar metadados do projeto e modificar as configurações atuais. Também é possível pesquisar projetos específicos na hierarquia de recursos com base no estado ou nos nomes de exibição.

Encontrar o nome, o número e o ID do projeto

Para interagir com os recursos do Google Cloud , você precisa fornecer as informações de identificação do projeto para cada solicitação. Um projeto é identificado pelo ID do projeto e número do projeto.

Console

Acesse a página Boas-vindas no console do Google Cloud .
Acessar "Boas-vindas"
No seletor de projetos na parte de cima da página, selecione seu projeto.

Observação: até 4.000 recursos podem ser mostrados no seletor de projetos. Se você não encontrar um recurso que deveria aparecer, acesse a página Gerenciar recursos e filtre a lista usando o nome dele.

O nome, o número e o ID do projeto aparecem depois do título Bem-vindo.

Acessar um projeto existente

Para acessar os metadados detalhados de um projeto Google Cloud específico, como o estado do ciclo de vida, o horário de criação e o recurso pai, use a Google Cloud CLI ou a API.

É necessário ter o status de proprietário do projeto ou as permissões da função de navegador (roles/browser) para acessar os detalhes do projeto.

gcloud

Antes de usar os dados do comando abaixo, faça estas substituições:

PROJECT_ID: o ID do projeto Google Cloud

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud projects describe PROJECT_ID

Windows (PowerShell)

gcloud projects describe PROJECT_ID

Windows (cmd.exe)

gcloud projects describe PROJECT_ID

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

PROJECT_ID: o ID do projeto Google Cloud

Método HTTP e URL:

GET https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID

Corpo JSON da solicitação:

{}

Para enviar a solicitação, escolha uma destas opções:

curl

Observação: o comando a seguir pressupõe que você tenha feito login na gcloud CLI com sua conta de usuário executando gcloud init ou gcloud auth login ou usando o Cloud Shell, que faz login automaticamente na gcloud CLI. Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID"

PowerShell

Observação: o comando a seguir pressupõe que você fez login na gcloud CLI com sua conta de usuário executando gcloud init ou gcloud auth login. Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
    "projectNumber": "464036093014",
    "projectId": "our-project-123",
    "lifecycleState": "ACTIVE",
    "name": "my project",
    "labels": {
        "mylabel": "prod"
    },
    "createTime": "2016-01-07T21:59:43.314Z"
}

Listar todos os projetos em um recurso

Para listar todos os projetos que são filhos diretos de um recurso, use o método v3 projects.list e especifique o recurso pai na consulta:

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

FOLDER_ID: o ID da pasta Google Cloud

Método HTTP e URL:

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

Corpo JSON da solicitação:

{
    "parent": "folders/662951040570"
}

Para enviar a solicitação, escolha uma destas opções:

curl

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/projects"

PowerShell

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/projects" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
    "projectNumber": "464036093014",
    "projectId": "our-project-123",
    "lifecycleState": "ACTIVE",
    "name": "my project",
    "labels": {
        "mylabel": "prod"
    },
    "createTime": "2016-01-07T21:59:43.314Z"
}

Pesquisar projetos

Para encontrar projetos que correspondam a critérios específicos, como um prefixo de nome de exibição ou um estado de ciclo de vida específico, use o método projects.search ou o comando gcloud alpha resource-manager projects search.

O escopo da pesquisa inclui todos os projetos para os quais você tem a permissão resourcemanager.projects.get.

Sintaxe da consulta

É possível filtrar sua pesquisa usando a flag --query (gcloud) ou o parâmetro query (API). Os filtros de pesquisa comuns incluem:

displayName: o nome fácil de usar do projeto.
state: o estado do ciclo de vida do projeto, por exemplo, ACTIVE ou DELETE_REQUESTED
parent.type e parent.id: filtram os resultados por uma organização ou pasta específica.

Permissões

Se você especificar um elemento principal na consulta (por exemplo, parent:folders/123), precisará ter permissões de resourcemanager.projects.list nesse elemento. Se você tiver essa permissão, todos os projetos do pai serão retornados depois que os filtros restantes forem aplicados.

Se você não tiver essa permissão, todos os projetos para os quais você tem a permissão resourcemanager.projects.get serão retornados após a aplicação dos filtros restantes.

Se você não especificar um recurso pai, os resultados vão incluir todos os projetos em que você tem permissões de resourcemanager.projects.get.

gcloud

Antes de usar os dados do comando abaixo, faça estas substituições:

PROJECT_ID: o ID do projeto Google Cloud

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud alpha projects search --query="name:z*"

Windows (PowerShell)

gcloud alpha projects search --query="name:z*"

Windows (cmd.exe)

gcloud alpha projects search --query="name:z*"

Você receberá uma resposta semelhante a esta

The response contains the projects with names starting with 'z'

REST

Método HTTP e URL:

GET https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain

Corpo JSON da solicitação:

{}

Para enviar a solicitação, escolha uma destas opções:

curl

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain"

PowerShell

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
      "projects": [
        {
          "name": "projects/951040570662",
          "parent": "folders/662951040570",
          "projectId": "tokyo-rain-123",
          "state": "ACTIVE",
          "displayName": "Tokyo Rain",
          "createTime": "2013-11-13T20:31:53.308Z",
          "updateTime": "2013-11-13T20:31:53.308Z",
          "etag": "BwWUlZ6XEfY="
        }
      ]
}

Atualizar projetos

É possível alterar o nome, os rótulos e as tags do projeto. Para mais informações sobre como atualizar projetos, consulte a página de referência da API do projeto. Para atualizar projetos, use um dos seguintes métodos:

Console

Para atualizar o nome ou os identificadores de um projeto usando o Google Cloud console, faça o seguinte:

No Google Cloud console, acesse a página Configurações do IAM e do administrador.
Acessar as configurações do IAM e do administrador

As etapas restantes aparecem no console do Google Cloud .
Na parte superior da tela, clique na lista suspensa de seleção de projetos.
Na janela Selecionar exibida, clique na lista suspensa da organização e escolha sua organização. Se você é um usuário de avaliação sem custo financeiro, pule esta etapa, já que a lista de organização não aparece.
Selecione seu projeto na lista que aparecer.
Para alterar o nome do projeto, edite o Nome do projeto e clique em Salvar.
Para adicionar ou editar tags, acesse a seção Tags na página e clique em Gerenciar tags. Para informações sobre como adicionar ou atualizar chaves e valores de tag, consulte Criar e gerenciar tags.
Para mudar os rótulos, clique em Rótulos na navegação à esquerda.
Saiba mais sobre o Uso dos rótulos.

gcloud

No console do Google Cloud , ative o Cloud Shell.

Ativar o Cloud Shell

Na parte de baixo do console Google Cloud , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.
Para atualizar o nome ou os rótulos de um projeto, use o comando gcloud alpha projects update:
```
gcloud alpha projects update PROJECT_ID \
   --name=NAME \
   --update-labels=KEY=VALUE, ...
```
Substitua:
- PROJECT_ID: o ID do projeto que você quer atualizar.
- NAME: o novo nome que você quer atribuir ao projeto.
- KEY: a chave de um rótulo que você quer atualizar.
- VALUE: o valor de um rótulo que você quer atualizar.
Para mais informações e flags adicionais que podem ser usadas com esse comando, consulte o SDK da CLI do Google Cloud.

REST

Para atualizar um projeto, faça o seguinte:

Consiga o objeto project usando o método projects.get.
Os campos que você quer atualizar.
Chame o método projects.patch.

O exemplo a seguir atualiza o nome de exibição do projeto para myproject e define o rótulo color como red:

Solicitação:

PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NUMBER?updateMask=displayName,labels

Em que PROJECT_NUMBER é o ID numérico do projeto que você quer atualizar.

Corpo JSON da solicitação:

{
  "displayName": "myproject",
  "labels": {
    "color": "red"
  }
}

Resposta:

{
  "projects": [
    {
      "name": "projects/951054970012",
      "parent": "folders/662951040570",
      "projectId": "Osaka-rain-234",
      "state": "ACTIVE",
      "displayName": "myproject",
      "createTime": "2013-11-13T20:31:53.308Z",
      "updateTime": "2013-11-13T20:35:42.308Z",
      "etag": "BwWUlZ6XEfY=",
      "labels": {
        "color": "red"
      }
    }
  ]
}

A seguir

Saiba como mover um projeto na hierarquia de recursos.
Saiba como migrar um projeto de um recurso de organização para outro.

Ver e atualizar projetos Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Encontrar o nome, o número e o ID do projeto

Console

Acessar um projeto existente

gcloud

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

curl

PowerShell

Listar todos os projetos em um recurso

REST

curl

PowerShell

Pesquisar projetos

gcloud

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

curl

PowerShell

Atualizar projetos

Console

gcloud

REST

A seguir

Ver e atualizar projetos