OsGoogle Cloud projetos formam a base para criar, ativar e usar todos os Google Cloud serviços, incluindo a gestão de APIs, a ativação da faturação, a adição e a remoção de colaboradores, e a gestão de autorizações para Google Cloud recursos.
Esta página explica como criar e gerir Google Cloud projetos através da API Cloud Resource Manager e da Google Cloud consola.
Antes de começar
Leia acerca do recurso de projeto na vista geral da hierarquia de recursos. Para orientações sobre a configuração da hierarquia de recursos, consulte o artigo Decida uma hierarquia de recursos para a sua Google Cloud zona de destino.
Os seguintes elementos são usados para identificar o seu projeto:
Nome do projeto: um nome legível para o seu projeto.
O nome do projeto não é usado por nenhuma API Google. Pode editar o nome do projeto em qualquer altura durante ou após a criação do projeto. Os nomes dos projetos não têm de ser únicos.
ID do projeto: um identificador globalmente exclusivo do seu projeto.
Um ID do projeto é uma string exclusiva usada para diferenciar o seu projeto de todos os outros no Google Cloud. Depois de introduzir um nome de projeto, a Google Cloud consola gera um ID do projeto exclusivo que pode ser uma combinação de letras, números e hífenes. Recomendamos que use o ID do projeto gerado, mas pode editá-lo durante a criação do projeto. Depois de criar o projeto, o ID do projeto é permanente.
Um ID do projeto tem os seguintes requisitos:
- Tem de ter entre 6 e 30 carateres.
- Só pode conter letras minúsculas, números e hífenes.
- Tem de começar com uma letra.
- Não pode terminar com um hífen.
- Não pode estar em utilização nem ter sido usado anteriormente, incluindo projetos eliminados.
- Não pode conter strings restritas, como
googleessl. Recomendamos que não use as stringsundefinedenullnum ID do projeto.
Número do projeto: um identificador exclusivo gerado automaticamente para o seu projeto.
Não inclua informações confidenciais, como informações de identificação pessoal (IIP) ou dados de segurança, no nome do projeto, no ID do projeto ou noutros nomes de recursos. O ID do projeto é usado no nome de muitos outros Google Cloud recursos, e qualquer referência ao projeto ou a recursos relacionados expõe o ID do projeto e o nome do recurso.
Criar um projeto
Para criar um projeto, tem de ter a autorização resourcemanager.projects.create. Esta autorização está incluída em funções como a função de criador de projetos
(roles/resourcemanager.projectCreator).
A função de criador de projeto é concedida por predefinição a todo o domínio de um novo recurso de organização e aos utilizadores da avaliação gratuita.
Para ver informações sobre como conceder a função a indivíduos e limitar o acesso ao nível do recurso da organização, consulte a página Gerir funções da organização predefinidas.
Se não especificar o recurso principal, é selecionado um recurso principal automaticamente, se aplicável, com base no domínio da conta de utilizador.
Pode criar um novo projeto através da Google Cloud consola, da
Google Cloud CLI ou do
método projects.create().
Consola
Para criar um novo projeto, faça o seguinte:
-
Aceda à página Gerir recursos na Google Cloud consola.
Os passos restantes aparecem na Google Cloud consola.
- Na lista pendente Selecionar organização na parte superior da página, selecione o recurso de organização no qual quer criar um projeto. Se for um utilizador da avaliação gratuita, ignore este passo, uma vez que esta lista não é apresentada.
- Clique em Criar projeto.
- Na janela Novo projeto apresentada, introduza um nome do projeto e selecione uma conta de faturação, conforme aplicável. Um nome de projeto só pode conter letras, números, aspas simples, hífenes, espaços ou pontos de exclamação e tem de ter entre 4 e 30 carateres.
- Introduza a organização principal ou o recurso de pasta na caixa Localização. Esse recurso vai ser o principal hierárquico do novo projeto. Se Nenhuma organização for uma opção, pode selecioná-la para criar o seu novo projeto como o nível superior da sua própria hierarquia de recursos.
- Quando terminar de introduzir os detalhes do novo projeto, clique em Criar.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Para criar um novo projeto, use o comando
gcloud projects create:gcloud projects create PROJECT_IDEm que PROJECT_ID é o ID do projeto que quer criar. Um ID do projeto tem de começar com uma letra minúscula e pode conter apenas letras ASCII, dígitos e hífenes, e tem de ter entre 6 e 30 carateres.
Para criar um projeto com um recurso de organização ou uma pasta como principal, use as flags
--organizationou--folder. Uma vez que um recurso só pode ter um elemento principal, só é possível usar um destes indicadores:gcloud projects create PROJECT_ID --organization=ORGANIZATION_IDgcloud projects create PROJECT_ID --folder=FOLDER_ID
API
Não pode usar determinadas palavras no ID do projeto quando cria um novo projeto com o método projects.create(). Alguns exemplos incluem google, null, undefined e ssl.
Quando usa uma palavra restrita, o pedido é devolvido com um erro INVALID_ARGUMENT.
O pedido abaixo apenas cria um projeto e não o associa automaticamente a uma conta de faturação. Use o método
projects.updateBillingInfo
para definir ou atualizar a conta de faturação associada a um projeto.
Criar pedido de projeto:
POST https://cloudresourcemanager.googleapis.com/v3/projects/
Authorization: *************
Content-Type: application/json
{
"projectId": "our-project-123",
"name": "my project",
"labels": {
"mylabel": "prod"
}
}
Create Project Response:
{
"name": "operations/pc.123456789",
}
Pedido de obtenção da operação:
GET https://cloudresourcemanager.googleapis.com/v3/operations/pc.123456789
Authorization: *************
Content-Type: application/json
Resposta da operação de obtenção:
{
"name": "operations/pc.123456789",
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloudresourcemanager.v3.Project",
"projectNumber": "464036093014",
"projectId": "our-project-123",
"lifecycleState": "ACTIVE",
"name": "my project",
"labels": {
"mylabel": "prod"
},
"createTime": "2016-01-07T21:59:43.314Z"
}
}
Adicione etiquetas durante a criação do projeto
As etiquetas oferecem uma forma de criar anotações para recursos. Pode adicionar etiquetas no momento da criação de projetos. Tem de atribuir a função Utilizador de etiquetas ao adicionar etiquetas. Para mais informações sobre as autorizações atribuídas a esta função, consulte o artigo Gerir etiquetas em recursos. Só pode adicionar o espaço de nomes para os pares de chave-valor da etiqueta de uma das seguintes formas:
gcloud
Para adicionar etiquetas durante a criação do projeto, execute o seguinte comando:
gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID --tags=KEY_VALUE_PAIRS
Substitua o seguinte:
- PROJECT_ID é o identificador exclusivo do projeto.
- ORGANIZATION_ID é o identificador exclusivo da organização.
- KEY_VALUE_PAIRS é uma lista separada por vírgulas de pares de chave-valor que pode atribuir ao seu recurso. Um exemplo de pares de chave-valor separados por vírgulas é
123/environment=production, 456/create=testresource.
API
O fragmento seguinte é um pedido JSON em que cria um projeto e adiciona-lhe etiquetas.
POST https://cloudresourcemanager.googleapis.com/v3/projects/
Authorization: *************
Content-Type: application/json
{
"projectId": "our-project-456",
"name": "my project",
"parent": "organizations/123",
"tags": {
"key": "123/environment"
"value": "production"
},
"tags": {
"key": "123/costCenter"
"value": "marketing"
}
}
Designe ambientes de projetos com etiquetas
Pode usar etiquetas para distinguir visualmente os projetos com base no respetivo ambiente, como produção, preparação ou desenvolvimento. Isto ajuda a evitar erros e melhora a perceção quando está a trabalhar em ambientes sensíveis. A Google adiciona um indicador visual ao projeto no Google Cloud seletor de projetos da consola quando é selecionado um projeto com um par chave-valor de etiqueta específico. Este indicador lembra que quaisquer alterações podem afetar as suas aplicações de produção ou não produção associadas. As etiquetas podem ser herdadas pelo projeto ou definidas diretamente no projeto.
Para usar esta funcionalidade, faça o seguinte:
- Crie uma chave de etiqueta com o nome
environment. - Crie valores de etiquetas para as categorias de ambiente que usa. Os seguintes valores
são suportados e mapeados para um emblema correspondente no seletor de projetos da consola:
- Prod: Prod, prod, Production, production
- Dev: Dev, dev, Development, development
- QA: QA, qa, controlo de qualidade, controlo de qualidade, testes, testes, teste, teste
- Staging: Staging, staging, Stage, stage
- Arquivado: arquivado, arquivado
- Associe a etiqueta adequada ao seu projeto através da criação de uma associação de etiquetas.
Se um projeto tiver várias etiquetas de ambiente (por exemplo, uma herdada de uma pasta e outra diretamente no projeto), a etiqueta mais específica é usada para determinar o emblema.
Criar um projeto com uma conta de serviço
Pode usar uma conta de serviço para automatizar a criação de projetos. Tal como as contas de utilizador, as contas de serviço podem receber autorização para criar projetos num recurso de organização. As contas de serviço não podem criar projetos fora de um recurso de organização e têm de especificar o recurso principal quando criam um projeto.
As contas de serviço podem criar um novo projeto através da CLI gcloud ou do método projects.create().
Gerir quotas de projetos
Se tiver menos de 30 projetos restantes na sua quota, é apresentada uma notificação com o número de projetos restantes na quota na página Novo projeto. Depois de atingir o limite de projetos, para criar mais projetos, tem de pedir um aumento do limite de projetos. Em alternativa, pode agendar a eliminação de alguns projetos após 30 dias na página Gerir recursos. Os projetos que os utilizadores eliminaram temporariamente são contabilizados na sua quota. Estes projetos são eliminados na totalidade após 30 dias.
Para pedir capacidade adicional para projetos na quota da sua organização, faça o seguinte:
Aceda à página Quotas e limites do sistema.
No seletor de recursos, selecione a organização para a qual quer aumentar a quota do projeto.
Na opção Filtro, selecione Métrica e introduza
cloudresourcemanager.googleapis.com/projects_count.Selecione Cloud Resource Manager API, clique em Mais ações e, de seguida, selecione Editar quota.
Na caixa de diálogo Alterações de quota, introduza um novo valor de quota e uma descrição e, de seguida, clique em Seguinte.
Introduza os seus detalhes de contacto e clique em Enviar pedido.
Recebe um email a acusar a receção do seu pedido. Se precisar de mais assistência, responda ao email. Após a revisão, recebe uma notificação por email a indicar se o seu pedido foi aprovado.
Se não tiver uma organização e quiser pedir capacidade adicional para projetos na sua quota, use o formulário Pedir aumento da quota do projeto.
Para mais informações sobre as quotas e por que motivo são usadas, consulte a página de apoio técnico Pedidos de quotas de projetos de avaliação gratuita. Para mais informações sobre os relatórios de faturação, consulte a página de apoio técnico Relatórios de faturação.
Encontre o nome, o número e o ID do projeto
Para interagir com os Google Cloud recursos, tem de fornecer as informações de identificação do projeto para cada pedido. Um projeto é identificado pelo respetivo ID do projeto e número do projeto.
Aceda à página Boas-vindas na Google Cloud consola.
No seletor de projetos na parte superior da página, selecione o seu projeto.
O nome do projeto, o número do projeto e o ID do projeto aparecem após o cabeçalho Bem-vindo.
Obtenha um projeto existente
Pode obter um projeto existente através da CLI do Google Cloud ou do método projects.get().
Se não for proprietário do projeto, tem de ter as autorizações incluídas na função de navegador (roles/browser).
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Para obter os metadados de um projeto, use o comando
gcloud projects describe:gcloud projects describe PROJECT_IDSubstitua
PROJECT_IDpelo ID do projeto.
API
Pedido:
GET https://cloudresourcemanager.googleapis.com/v3/projects/<var>PROJECT_ID</var>
Substitua PROJECT_ID pelo ID do projeto.
Resposta:
{
"projectNumber": "464036093014",
"projectId": "our-project-123",
"lifecycleState": "ACTIVE",
"name": "my project",
"labels": {
"mylabel": "prod"
},
"createTime": "2016-01-07T21:59:43.314Z"
}
Apresenta todos os projetos de um recurso.
Para listar todos os projetos que são filhos diretos de um recurso, use o método
v3 projects.list, com o recurso principal especificado na consulta:
Pedido:
GET https://cloudresourcemanager.googleapis.com/v3/projects
{
"parent": "folders/662951040570"
}
Resposta:
{
"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="
}
]
}
Pesquise projetos
Para pesquisar projetos que correspondam à consulta especificada, use gcloud alpha resource-manager
projects search, transmitindo a consulta na flag --query. O âmbito da pesquisa
são todos os projetos para os quais o utilizador tem autorização projects.get.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Para obter a lista de todos os projetos, use o comando
gcloud alpha projects search:gcloud alpha projects search --query="displayName=rek*" <table output showing the projects with display names starting from rek eg. rekey-project-2, rekha-project>gcloud alpha projects search --query="state:DELETE_REQUESTED" <table output showing the projects for which delete has been requested>
API
Pode usar o método
projects.search
e uma string de consulta para devolver recursos específicos do projeto que correspondam ao filtro.
Os resultados contêm apenas projetos para os quais lhe foi concedida a autorização resourcemanager.projects.get.
O seguinte fragmento do código devolve o recurso Project com o nome a apresentar "Tokyo Rain":
Pedido:
GET https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain
Resposta:
{
"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="
}
]
}
O seguinte fragmento do código devolve todos os recursos do projeto com uma etiqueta vermelha:
Pedido:
GET https://cloudresourcemanager.googleapis.com/v3/projects:search?query=labels.color%3Ared
Resposta:
{
"projects": [
{
"name": "projects/951054970012",
"parent": "folders/662951040570",
"projectId": "Osaka-rain-234",
"state": "ACTIVE",
"displayName": "Osaka Rain",
"createTime": "2013-11-13T20:31:53.308Z",
"updateTime": "2013-11-13T20:31:53.308Z",
"etag": "BwWUlZ6XEfY=",
"labels": {
"color": "red"
}
}
]
}
Se especificar os campos parent.type e parent.id no corpo do pedido, a autorização resourcemanager.projects.list é verificada no elemento principal. Se o utilizador tiver esta autorização, todos os projetos na hierarquia principal são devolvidos após a aplicação dos filtros restantes.
Se o utilizador não tiver esta autorização, todos os projetos para os quais o utilizador tem a autorização resourcemanager.projects.get são devolvidos após a aplicação dos filtros restantes.
Se não for especificado nenhum filtro, a chamada devolve projetos para os quais o utilizador tem autorizações resourcemanager.projects.get.
A atualizar projetos
Pode atualizar projetos através da Google Cloud consola ou do método
projects.patch().
Os únicos campos que podem ser atualizados são o nome e as etiquetas do projeto. Para mais informações sobre a atualização de projetos, consulte a página de referência da API Project.
Para mover um projeto na hierarquia de recursos, consulte o artigo Mover um projeto. Para migrar um projeto de um recurso de organização para outro, consulte o artigo Migrar projetos.
Consola
Para atualizar o nome ou as etiquetas de um projeto através da Google Cloud consola, faça o seguinte:
- Na Google Cloud consola, aceda à página Definições de IAM e administrador.
Aceda às definições de IAM e administrador
Os passos restantes aparecem na Google Cloud consola.
- Na parte superior do ecrã, clique na lista pendente de seleção de projetos.
- Na janela Selecionar de apresentada, clique na lista pendente da organização e, de seguida, selecione a sua organização. Se for um utilizador da avaliação gratuita, ignore este passo, uma vez que a lista de organizações não é apresentada.
- Selecione o projeto na lista apresentada.
- Para alterar o nome do projeto, edite Nome do projeto e, de seguida, clique em Guardar.
- Para alterar as etiquetas, clique em Etiquetas na navegação do lado esquerdo.
Saiba mais sobre a utilização de etiquetas.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Para atualizar o nome ou as etiquetas de um projeto, use o comando
gcloud alpha projects update:gcloud alpha projects update PROJECT_ID \ --name=NAME \ --update-labels=KEY=VALUE, ...Onde:
PROJECT_ID é o ID do projeto que quer atualizar.
NAME é o novo nome que quer atribuir ao projeto.
KEY=VALUE, … é uma lista dos pares de chave=valor das etiquetas que quer atualizar. Se já existir uma etiqueta, o respetivo valor é modificado. Se não existir, é criada uma nova etiqueta.
Para mais informações e flags adicionais que podem ser usadas com este comando, consulte o SDK da CLI Google Cloud.
Obtenha o objeto
projectatravés do métodoprojects.get.Modifique os campos que quer atualizar.
Chame o método
projects.patch.
API
Para atualizar um projeto, faça o seguinte:
O exemplo seguinte atualiza o nome a apresentar do projeto para
myproject e define a etiqueta color como red:
Pedido:
PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NUMBER?updateMask=displayName,labels
Onde PROJECT_NUMBER é o ID numérico do projeto que quer atualizar.
Corpo JSON do pedido:
{
"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"
}
}
]
}
Encerramento (eliminação) de projetos
Pode encerrar projetos através da Google Cloud consola ou do método
projects.delete
na API. Um projeto tem de ter um estado do ciclo de vida de ACTIVE para ser encerrado desta forma.
Este método marca imediatamente um projeto para eliminação. É enviado um email de notificação ao utilizador que iniciou a operação de eliminação e aos contactos da categoria Técnica indicados em Contactos essenciais com base no melhor esforço. Se a notificação não for enviada, o projeto continua marcado para eliminação. Se não existir nenhum contacto na categoria Técnica, o contacto alternativo não é notificado.
Não é possível usar um projeto marcado para eliminação. Se o projeto tiver uma conta de faturação associada, essa associação é interrompida e não é reposta se a operação de eliminação do projeto for cancelada. Após 30 dias, o projeto é eliminado por completo. Até ser totalmente eliminado, o projeto pode continuar a estar visível, embora não seja utilizável.
Para parar o processo de eliminação do projeto durante o período de 30 dias, consulte os passos para restaurar um projeto.
No final do período de 30 dias, o projeto e todos os respetivos recursos são eliminados e não podem ser recuperados. Até ser eliminado, o projeto conta para a sua quota de projetos.
Para ajudar a garantir que não elimina projetos importantes, pode ativar as recomendações de risco de alterações. As recomendações de alteração de risco geram avisos quando tenta eliminar projetos que o sistema Google Cloud identificou como importantes.
Se tiver configurado a faturação para um projeto, este pode não ser completamente eliminado até o ciclo de faturação atual terminar e a sua conta ser cobrada com êxito. O número e os tipos de serviços em utilização também podem afetar o momento em que o sistema elimina permanentemente um projeto. Para saber mais sobre a retenção de dados e a eliminação segura, consulte o artigo De que forma a Google retém os dados que recolhe.
Encerre um projeto
Consola
-
Na Google Cloud consola, aceda à página Definições de IAM e administrador.
Aceda às definições de IAM e administrador
Os passos restantes aparecem na Google Cloud consola.
-
Na página Definições de IAM e administração, selecione o projeto que quer eliminar e, de seguida,
clique em Encerrar.
A opção Encerrar só é apresentada aos utilizadores que têm a autorização
resourcemanager.projects.deleteno projeto atual. - Clique em Desligar.
- Introduza o ID do projeto e, de seguida, clique em Encerrar mesmo assim.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Para eliminar um projeto, use o comando
gcloud projects delete:gcloud projects delete PROJECT_IDEm que PROJECT_ID é o ID do projeto que quer eliminar.
API
O seguinte fragmento do código elimina o projeto especificado:
Pedido:
DELETE https://cloudresourcemanager.googleapis.com/v3/projects/my-project-123
Resolução de problemas de eliminação de projetos
Se o processo de encerramento de um projeto falhar, pode encontrar mais informações em Resolução de problemas de eliminação de projetos.
Restaure um projeto
Os proprietários do projeto podem restaurar um projeto eliminado no período de recuperação de 30 dias que começa quando o projeto é encerrado.
Considerações
A restauração de um projeto devolve-o ao estado em que se encontrava antes de ser encerrado, com determinadas exceções:
A faturação é desativada no projeto quando o projeto é encerrado e a faturação não é ativada automaticamente em projetos restaurados. A conta do Cloud Billing tem de ser associada manualmente novamente após o restauro do projeto. Pode ter de aguardar algumas horas antes de poder associar com êxito um projeto restaurado recentemente a uma conta de faturação.
Pode recuperar a maioria dos recursos se restaurar um projeto no prazo de 30 dias.
Pode demorar até 36 horas para que alguns serviços sejam restaurados. Se os seus recursos não forem restaurados após este período, contacte o Apoio técnico da Google.
Alguns recursos, como os recursos do Cloud Storage ou do Pub/Sub, são eliminados muito mais cedo. Estes recursos podem não ser totalmente recuperáveis, mesmo que restaure o projeto no prazo de 30 dias.
Alguns serviços podem ter de ser reiniciados manualmente. Para mais informações, consulte o artigo sobre como reiniciar Google Cloud os serviços.
Tem de ter a autorização resourcemanager.projects.undelete no projeto que quer restaurar. Para restaurar um projeto:
Consola
Para ver o projeto na Google Cloud consola, precisa das seguintes autorizações:
resourcemanager.projects.listresourcemanager.folders.listresourcemanager.projects.get
Aceda à página Gerir recursos na Google Cloud consola.
No seletor de projetos na parte superior da página, selecione o recurso da sua organização.
Abaixo da lista de recursos da organização, pastas e projetos, clique em Recursos pendentes de eliminação.
Selecione a caixa do projeto que quer restaurar e, de seguida, clique em Restaurar. Na caixa de diálogo apresentada, confirme que quer restaurar o projeto.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Para restaurar um projeto, use o comando
gcloud projects undelete:gcloud projects undelete PROJECT_IDPROJECT_ID é o ID ou o número do projeto que quer restaurar.
API
O seguinte fragmento do código restaura o projeto especificado:
Pedido:
POST https://cloudresourcemanager.googleapis.com/v3/projects/my-project-123:undelete