Ver e atualizar projetos

É possível recuperar metadados do projeto e modificar as definições de configuração para gerenciar seus recursos de nuvem. Também é possível pesquisar projetos específicos na hierarquia de recursos com base no estado ou no nome de exibição.

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

Para interagir com os recursos do Cloud de Confiance by S3NS , você precisa inserir 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

  1. Acesse a página de Boas-vindas no console do Cloud de Confiance .

    Acessar "Boas-vindas"

  2. No seletor de projetos na parte de cima da página, selecione o projeto.

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

gcloud

Para encontrar o número, o ID ou o nome do projeto, use o comando gcloud projects describe:

gcloud projects describe PROJECT_ID

Para recuperar apenas o número do projeto como um valor, use a flag --format:

gcloud projects describe PROJECT_ID --format="value(projectNumber)"

Acessar um projeto existente

Para ver os metadados detalhados de um projeto específico do Cloud de Confiance by S3NS , 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.

Você precisa ter o status de Proprietário do Projeto ou as permissões do papel 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 do Cloud de Confiance by S3NS

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 do Cloud de Confiance by S3NS

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

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

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 do Cloud de Confiance by S3NS

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 de consulta

É possível filtrar a 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: filtra os resultados por uma organização ou pasta específica.

Permissões

Se você especificar um pai na consulta (por exemplo, parent:folders/123), precisará ter permissões resourcemanager.projects.list nesse pai. Se você tiver essa permissão, todos os projetos no pai serão retornados após a aplicação dos filtros restantes.

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 pai, os resultados vão incluir todos os projetos em que você tem permissões resourcemanager.projects.get.

Console

É possível pesquisar projetos na página Gerenciar recursos:

  1. No console Cloud de Confiance , acesse a página Gerenciar recursos. Acessar "Gerenciar recursos"
  2. Na caixa Filtro, insira a propriedade que você quer pesquisar, como name ou ID.
  3. Selecione a propriedade na lista suspensa e insira o valor que você quer pesquisar.

gcloud

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

  • PROJECT_ID: o ID do projeto do Cloud de Confiance by S3NS

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 atualizar 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 Cloud de Confiance console, faça o seguinte:

  1. No Cloud de Confiance 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 Cloud de Confiance .

  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 teste sem custo financeiro, 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 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.
  7. Para mudar os rótulos, clique em Rótulos na navegação à esquerda.

    Saiba mais sobre o Uso dos rótulos.

gcloud

  1. No console do Cloud de Confiance , ative o Cloud Shell.

    Ativar o Cloud Shell

    Na parte inferior do console do Cloud de Confiance , 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.

  2. 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 outras flags que podem ser usadas com esse comando, consulte o SDK da CLI do Google Cloud.

REST

Para atualizar um projeto, faça o seguinte:

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