Como criar e gerenciar projetos

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

Os projetos do Google Cloud formam a base para criar, ativar e usar todos os serviços do Google Cloud, incluindo o gerenciamento de APIs, ativação de faturamento, adição e remoção de colaboradores e gerenciamento de permissões dos recursos do Google Cloud.

Nesta página, explicamos como criar e gerenciar projetos do Google Cloud usando a API Resource Manager e o console do Google Cloud.

Antes de começar

Leia sobre o recurso do projeto na Visão geral da hierarquia de recursos. Para saber como configurar a hierarquia de recursos, consulte Decidir uma hierarquia de recursos para sua zona de destino do Google Cloud.

Os seguintes itens são usados para identificar seu projeto:

  • Nome do projeto: um nome legível para seu projeto.

    O nome do projeto não é usado por nenhuma API do Google Você pode editar o nome do projeto a qualquer momento durante ou após a criação do projeto. Os nomes dos projetos não precisam ser exclusivos.

  • ID do projeto: um identificador exclusivo personalizável para seu projeto.

    O ID do projeto é uma string exclusiva usada para diferenciar seu projeto de todos os outros no Google Cloud. Use o Console do Google Cloud para gerar um ID do projeto ou escolha seu próprio. Só é possível modificar o código do projeto durante a criação dele.

    Requisitos do ID do projeto:

    • Precisa ter de 6 a 30 caracteres.
    • Só pode conter letras minúsculas, números e hífens
    • Precisa começar com uma letra.
    • Não pode terminar com hífen
    • não pode ser em uso ou usado anteriormente; Isso inclui projetos excluídos.
    • Não podem conter strings restritas, como google e ssl.
  • Número do projeto: um identificador exclusivo gerado automaticamente para seu projeto.

Não inclua informações confidenciais no nome e no ID do projeto ou em outros nomes de recursos. O ID do projeto é usado no nome de muitos outros recursos do Google Cloud, e qualquer referência ao projeto ou aos recursos relacionados expõe o ID e o nome do recurso.

Como criar um projeto

Para criar um projeto, você deve ter a permissão resourcemanager.projects.create. Essa permissão está incluída em papéis como o de Criador do projeto (roles/resourcemanager.projectCreator). O papel de Criador de projetos é concedido por padrão a todo o domínio de uma nova organização e para usuários de teste sem custo financeiro. Para informações sobre como conceder o papel à pessoa e limitar o acesso em toda a organização, consulte Como gerenciar papéis padrão da organização.

Se você não especificar o recurso pai, um recurso pai será selecionado automaticamente, se aplicável, com base no domínio da conta de usuário.

É possível criar um novo projeto usando o console do Google Cloud, a Google Cloud CLI ou o método projects.create().

Console

Para criar um projeto novo, execute as seguintes etapas:

  1. Acesse a página Gerenciar recursos no console do Google Cloud.

    Acessar a página "Gerenciar recursos"

  2. Na lista suspensa Selecionar organização, na parte de cima da página, escolha o recurso da organização em que o projeto vai ser criado. Se você é um usuário da avaliação gratuita, pule esta etapa porque a lista não será exibida.
  3. Clique em Criar projeto.
  4. Na janela Novo projeto que vai ser exibida, insira o nome do projeto e selecione uma conta de faturamento, conforme aplicável. O nome de um projeto só pode ser composto por letras, números, aspas simples, hifens, espaços ou pontos de exclamação e precisa ter entre 4 e 30 caracteres.
  5. Insira o recurso da organização ou pasta mãe na caixa Local. Esse recurso vai ser o pai hierárquico do novo projeto. Se houver a opção Sem organização, selecione-a para criar o novo projeto como o nível superior da própria hierarquia de recursos.
  6. Ao concluir a inserção dos detalhes do novo projeto, clique em Criar.

gcloud

Para criar um novo projeto, use o comando gcloud projects create:

gcloud projects create PROJECT_ID

Em que PROJECT_ID é o código do projeto que você quer criar. Um ID do projeto precisa começar com uma letra minúscula e deve conter apenas letras ASCII, dígitos e hifens e deve ter entre 6 e 30 caracteres.

Para criar um projeto com uma organização ou uma pasta como pai, use as sinalizações --organization ou --folder. Como um recurso pode ter apenas um pai, só uma dessas sinalizações pode ser usada:

gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID

gcloud projects create PROJECT_ID --folder=FOLDER_ID

API

Não é possível usar determinadas palavras no ID do projeto quando cria um novo projeto com o método projects.create(). Alguns exemplos incluem ssl e google. Quando você usa uma palavra restrita, a solicitação é retornada com um erro INVALID_ARGUMENT.

A solicitação a seguir apenas cria um projeto e não o associa automaticamente a uma conta de faturamento. Use o método projects.updateBillingInfo para definir ou atualizar a conta de faturamento associada a um projeto.

Criar solicitação de projeto:

POST https://cloudresourcemanager.googleapis.com/v3/projects/
Authorization: *************
Content-Type: application/json

{
    "projectId": "our-project-123",
    "name": "my project",
    "labels": {
      "mylabel": "prod"
    }
}

Criar resposta de projeto:

{
    "name": "operations/pc.123456789",
}

Receber solicitação de operação:

GET https://cloudresourcemanager.googleapis.com/v3/operations/pc.123456789
Authorization: *************
Content-Type: application/json

Receber resposta de operaçã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"
    }
}

Como criar um projeto usando uma conta de serviço

Você pode usar uma conta de serviço para automatizar a criação do projeto. Assim como as contas de usuário, as contas de serviço podem receber permissão para criar projetos dentro de uma organização. As contas de serviço não têm permissão para criar projetos fora de uma organização e devem especificar o recurso pai ao criar um projeto. As contas de serviço podem criar um novo projeto usando a CLI gcloud ou o método projects.create().

Como gerenciar cotas de projeto

Se você tiver menos de 30 projetos restantes na cota, uma notificação exibirá a quantidade desses projetos na página Novo projeto. Depois de atingir seu limite de projetos, você deve solicitar um aumento no limite de projetos para criar mais projetos. Como alternativa, você pode programar a exclusão de alguns projetos depois de 30 dias na página Gerenciar recursos. Projetos que os usuários fizeram a exclusão reversívelsão contabilizados na sua cota. Esses projetos são excluídos completamente após 30 dias.

Para solicitar mais capacidade para projetos na sua cota, use o formulário Solicitar aumento de cota do projeto. Você encontra mais informações sobre as cotas e por que elas são usadas na página de suporte Solicitações de cota para projetos no teste gratuito. Para mais informações sobre relatórios de faturamento, consulte a página de suporte Relatórios de faturamento.

Identificar projetos

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.

Para receber o ID e o número do projeto, faça o seguinte:

  1. Acesse a página Painel no console do Google Cloud:

    Ir para a página "Painel"

  2. Clique na lista suspensa Selecionar de na parte superior da página. Na janela Selecionar de exibida, selecione seu projeto.

O ID do projeto e o número do projeto são exibidos no card Informações do projeto do painel do projeto:

No exemplo acima, o nome do projeto é Meu projeto de exemplo e o ID do projeto émy-sample-project-191923.

Acessar um projeto existente

Você pode receber um projeto existente usando o console do Google Cloud ou o método projects.get().

Console

Para ver um projeto usando o Console do Google Cloud, faça o seguinte:

  1. Acesse a página Painel no console do Google Cloud.

    Ir para a página "Painel"

  2. Clique na lista suspensa Selecionar de na parte superior da página. Na janela Selecionar de exibida, selecione seu projeto.

gcloud

Para obter os metadados de um projeto, use o comando gcloud projects describe:

gcloud projects describe PROJECT_ID

Em que PROJECT_ID é o código do projeto que você quer visualizar.

API

Solicitação:

GET
https://cloudresourcemanager.googleapis.com/v3/projects/our-project-123

Resposta:

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

Como listar projetos

Listar todos os projetos em um recurso

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

Solicitação:

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="
    }
    ]
}

Pesquisar projetos

Para pesquisar projetos que correspondam à consulta especificada, use gcloud alpha resource-manager projects search, transmitindo a consulta na sinalização --query. O escopo da pesquisa inclui todos os projetos em que o usuário tem a permissão projects.get.

gcloud

Para ver 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

Use o método projects.search e uma string de consulta para retornar recursos específicos do projeto que correspondam ao filtro. Os resultados contêm apenas projetos para os quais você recebeu a permissão resourcemanager.projects.get.

O snippet de código a seguir retorna o recurso Projeto com o nome de exibição "Tokyo Rain":

Solicitação:

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

{
    "displayName": "Tokyo Rain"
}

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 snippet de código a seguir retorna todos os projetos com um rótulo vermelho:

Solicitação:

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

{
    "labels": {
    "color": "red"
    }
}

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 você especificar os campos parent.type e parent.id no corpo da solicitação, a permissão resourcemanager.projects.list será verificada no pai. Se o usuário tiver essa permissão, todos os projetos do pai serão retornados depois que os filtros restantes forem aplicados.

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

Se nenhum filtro for especificado, a chamada retornará projetos em que o usuário tem permissões resourcemanager.projects.get.

Como atualizar projetos

É possível atualizar projetos usando o console do Google Cloud ou o método projects.patch().

Os únicos campos que podem ser atualizados são o nome do projeto e os rótulos. Para mais informações sobre como atualizar projetos, veja a página de referência da API do projeto.

Para mover um projeto dentro da hierarquia de recursos, consulte Como mover um projeto. Para migrar um projeto de uma organização para outra, consulte Como migrar projetos.

Console

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

  1. Abra a página Configurações no console do Google Cloud.

    Abrir a página "Configurações"

  2. Na parte superior da tela, clique na lista suspensa de seleção de projetos.
  3. Na janela Selecionar exibida, clique na lista suspensa da organização e escolha sua organização. Pule esta etapa se você for um usuário de avaliação gratuita, porque que a lista de organização não vai aparecer.
  4. Selecione seu projeto na lista que aparecer.
  5. Para alterar o nome do projeto, edite o Nome do projeto e depois clique em Salvar.
  6. Para mudar os marcadores, clique em Marcadores no painel de navegação à esquerda. Saiba mais sobre como usar rótulos.

gcloud

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, ...

Em que:

  • PROJECT_ID é o ID do projeto que você quer atualizar.

  • NAME é o novo nome que você quer atribuir ao projeto.

  • KEY = VALUE, ... é uma lista dos pares de chave-valor dos rótulos que você quer atualizar. Se um rótulo já existir, seu valor será modificado. Se ele não existir, um novo rótulo será criado.

Para mais informações e outras sinalizações que podem ser usadas com esse comando, consulte o SDK da Google Cloud CLI.

API

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étodoprojects.patch

O exemplo a seguir atualiza o nome do projeto para myproject e o rótulo color:blue:

O snippet de código a seguir atualiza o nome do projeto para "myproject":

Solicitação:

PATCH https://cloudresourcemanager.googleapis.com/v3/{project.name=PROJECT_NAME}
{
  updateMask=displayName,labels
}

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

Solicitar corpo JSON:

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

Como encerrar (excluir) projetos

Encerre projetos usando o console do Google Cloud ou o método projects.delete na API. Para ser encerrado, o projeto precisa ter um estado de ciclo de vida ACTIVE.

Este método marca imediatamente um projeto a ser excluído. O e-mail de notificação é enviado ao usuário que iniciou a operação de exclusão e aos contatos da categoria técnica listados em Contatos essenciais da melhor forma possível. Se a notificação não for enviada, o projeto ainda será marcado como excluído. Se não houver contato na categoria "Técnica", o contato do substituto não será notificado.

Um projeto marcado para exclusão não pode ser utilizado. Se o projeto tiver uma conta de faturamento associada, essa associação será corrompida e não será restabelecida se a operação de exclusão do projeto for cancelada. Após 30 dias, o projeto é totalmente excluído.

Para interromper o processo de exclusão do projeto durante o período de 30 dias, consulte as etapas para restaurar um projeto. É possível verificar o número de dias restantes no período de 30 dias usando o método da Google Cloud CLI do gcloud projects describe.

No final do período de 30 dias, o projeto e todos os seus recursos são excluídos e não podem ser recuperados. Até a exclusão, o projeto é contabilizado na sua cota do projeto.

Se você configurou o faturamento para um projeto, ele pode não ser completamente excluído até que o ciclo de faturamento atual termine e a cobrança seja realizada. A quantidade e o tipo dos serviços em uso também podem ser afetados quando o sistema exclui permanentemente um projeto. Para saber mais sobre retenção de dados e exclusão segura, veja Como o Google retém os dados coletados.

Para encerrar um projeto:

Console

  1. No Console do Google Cloud, acesse a página Configurações do IAM e do administrador.

    Abrir a página "Configurações"

  2. Na página Configurações IAM e administrador, clique em Selecionar um projeto.
  3. Selecione o projeto que você quer excluir e clique em Abrir.
  4. Clique em Encerrar.
  5. Digite o ID do projeto e clique em Encerrar.

gcloud

Para excluir um projeto, use o comando gcloud projects delete:

gcloud projects delete PROJECT_ID

Em que PROJECT_ID é o código do projeto que você quer excluir.

API

O snippet de código a seguir exclui o projeto especificado:

Solicitação:

DELETE
https://cloudresourcemanager.googleapis.com/v3/projects/my-project-123

Solução de problemas na exclusão de projetos

Se o processo de encerramento de um projeto falhar, você poderá encontrar mais informações em Solução de problemas de exclusão do projeto.

Como restaurar um projeto

Os proprietários de projetos podem restaurar um projeto excluído dentro do período de recuperação de 30 dias, contados a partir de quando o projeto é encerrado. A restauração de um projeto retorna-o ao estado em que estava antes de ser encerrado, com algumas exceções:

  • O faturamento é desativado no projeto quando o projeto é encerrado e o faturamento não é ativado automaticamente em projetos restaurados. A conta do Cloud Billing precisa ser vinculada manualmente novamente após a restauração do projeto. Talvez seja necessário aguardar algumas horas para vincular um projeto restaurado recentemente a uma conta de faturamento.
  • É possível recuperar a maioria dos recursos se você restaurar um projeto no período de 30 dias. Alguns serviços têm atrasos na restauração, e talvez seja necessário aguardar algum tempo para que eles sejam restaurados.
  • Alguns recursos, como os do Cloud Storage ou do Pub/Sub, são excluídos muito antes do tempo. Esses recursos podem não ser totalmente recuperáveis, mesmo se você restaurar o projeto dentro do período de 30 dias.
  • Pode ser que alguns serviços precisem ser reiniciados manualmente. Para obter mais informações, consulte Como reiniciar os serviços do Google Cloud.

É necessário ter a permissão resourcemanager.projects.undelete no projeto que você quer restaurar. Para restaurar um projeto:

Console

Para ver o projeto no console do Google Cloud, você precisa das permissões a seguir:

  • resourcemanager.projects.list
  • resourcemanager.folders.list
  • resourcemanager.projects.get

Para restaurar um projeto usando o Console do Google Cloud, siga estas etapas:

  1. Acesse a página Gerenciar recursos no console do Google Cloud.

    Acessar a página "Gerenciar recursos"

  2. Em Seletor de projetos, na parte superior da página, selecione sua organização.

  3. Abaixo da lista de organizações, pastas e projetos, clique em Recursos com exclusão pendente.

  4. Marque a caixa do projeto que você quer restaurar e clique em Restaurar. Na caixa de diálogo exibida, confirme que você quer restaurar o projeto.

gcloud

Para restaurar um projeto, use o comando gcloud projects undelete:

gcloud projects undelete PROJECT_ID

Em que PROJECT_ID é o ID ou o número do projeto que você quer restaurar.

API

O snippet de código a seguir restaura o projeto especificado:

Solicitação:

POST
https://cloudresourcemanager.googleapis.com/v3/projects/my-project-123:undelete