Visualizzare e aggiornare i progetti

Questa pagina spiega come recuperare i metadati del progetto e modificare le impostazioni del progetto esistenti. Puoi anche cercare progetti specifici all'interno della gerarchia delle risorse in base al loro stato o ai nomi visualizzati.

Trovare il nome, il numero e l'ID del progetto

Per interagire con le risorse Google Cloud , devi fornire le informazioni identificative del progetto per ogni richiesta. Un progetto viene identificato da un ID e da un numero.

Console

Vai alla pagina Benvenuto nella console Google Cloud .
Vai a Benvenuto
Seleziona il tuo progetto dal selettore di progetti nella parte superiore della pagina.

Nota: nel selettore di progetti possono essere visualizzate fino a 4000 risorse. Se non vedi una risorsa che dovrebbe essere visualizzata, vai alla pagina Gestisci risorse e filtra l'elenco utilizzando il nome della risorsa.

Il nome, il numero e l'ID progetto vengono visualizzati dopo l'intestazione Benvenuto.

Recuperare un progetto esistente

Per ottenere i metadati dettagliati di un progetto Google Cloud specifico, ad esempio lo stato del ciclo di vita, l'ora di creazione e la risorsa padre del progetto, utilizza Google Cloud CLI o l'API.

Per accedere ai dettagli del progetto, devi disporre dello stato di Proprietario progetto o delle autorizzazioni del ruolo Sfoglia (roles/browser).

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

PROJECT_ID: l' Google Cloud ID progetto

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud projects describe PROJECT_ID

Windows (PowerShell)

gcloud projects describe PROJECT_ID

Windows (cmd.exe)

gcloud projects describe PROJECT_ID

REST

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

PROJECT_ID: l' Google Cloud ID progetto

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{}

Per inviare la richiesta, scegli una di queste opzioni:

curl

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Elenco di tutti i progetti in una risorsa

Per elencare tutti i progetti che sono elementi figlio diretti di una risorsa, utilizza il metodo v3 projects.list e specifica la risorsa padre nella query:

REST

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

FOLDER_ID: l' Google Cloud ID cartella

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
    "parent": "folders/662951040570"
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Cerca progetti

Per trovare i progetti che corrispondono a criteri specifici, ad esempio un prefisso del nome visualizzato o uno stato del ciclo di vita specifico, utilizza il metodo projects.search o il comando gcloud alpha resource-manager projects search.

L'ambito della ricerca include tutti i progetti per i quali disponi dell'autorizzazione resourcemanager.projects.get.

Sintassi delle query

Puoi filtrare la ricerca utilizzando il flag --query (gcloud) o il parametro query (API). I filtri di ricerca più comuni includono:

displayName: il nome descrittivo del progetto.
state: lo stato del ciclo di vita del progetto, ad esempio ACTIVE o DELETE_REQUESTED
parent.type e parent.id: filtra i risultati in base a un'organizzazione o una cartella specifica.

Autorizzazioni

Se specifichi un elemento principale nella query (ad esempio parent:folders/123), devi disporre delle autorizzazioni resourcemanager.projects.list per l'elemento principale. Se disponi di questa autorizzazione, tutti i progetti secondari vengono restituiti dopo l'applicazione dei filtri rimanenti.

Se non disponi di questa autorizzazione, tutti i progetti per cui disponi dell'autorizzazione resourcemanager.projects.get vengono restituiti dopo l'applicazione dei filtri rimanenti.

Se non specifichi un progetto padre, i risultati includono tutti i progetti per i quali disponi delle autorizzazioni resourcemanager.projects.get.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

PROJECT_ID: l' Google Cloud ID progetto

Esegui questo comando:

Linux, macOS o 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*"

Dovresti ricevere una risposta simile alla seguente:

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

REST

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{}

Per inviare la richiesta, scegli una di queste opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Aggiorna progetti

Puoi modificare il nome, le etichette e i tag del progetto. Per saperne di più sull'aggiornamento dei progetti, consulta la pagina di riferimento dell'API Project. Per aggiornare i progetti, utilizza uno dei seguenti metodi:

Console

Per aggiornare il nome o le etichette di un progetto Google Cloud utilizzando la console, segui questi passaggi:

Nella Google Cloud console, vai alla pagina IAM e amministrazione > Impostazioni.
Vai a IAM e amministrazione > Impostazioni

I passaggi rimanenti vengono visualizzati nella console Google Cloud .
Nella parte superiore dello schermo, fai clic sull'elenco a discesa per la selezione dei progetti.
Nella finestra Seleziona da che viene visualizzata, fai clic sull'elenco a discesa Organizzazione e seleziona l'organizzazione. Se stai usufruendo di una prova senza costi, salta questo passaggio perché l'elenco Organizzazione non viene visualizzato.
Seleziona il progetto dall'elenco visualizzato.
Per cambiare il nome del progetto, modificalo in Nome progetto e fai clic su Salva.
Per aggiungere o modificare i tag, vai alla sezione Tag della pagina e fai clic su Gestisci tag. Per informazioni sull'aggiunta o l'aggiornamento di chiavi e valori dei tag, consulta Creare e gestire i tag.
Per modificare le etichette, fai clic su Etichette nel menu di navigazione a sinistra.
Scopri di più sull'utilizzo delle etichette.

gcloud

Nella console Google Cloud , attiva Cloud Shell.

Attiva Cloud Shell

Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.
Per aggiornare il nome o le etichette di un progetto, utilizza il comando gcloud alpha projects update:
```
gcloud alpha projects update PROJECT_ID \
   --name=NAME \
   --update-labels=KEY=VALUE, ...
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID del progetto che vuoi aggiornare.
- NAME: il nuovo nome che vuoi assegnare al progetto.
- KEY: la chiave di un'etichetta da aggiornare.
- VALUE: il valore di un'etichetta da aggiornare.
Per ulteriori informazioni e altri flag che possono essere utilizzati con questo comando, consulta Google Cloud CLI SDK.

REST

Per aggiornare un progetto:

Recupera l'oggetto project utilizzando il metodo projects.get.
Modifica i campi che vuoi aggiornare.
Chiama il metodo projects.patch.

L'esempio seguente aggiorna il nome visualizzato del progetto a myproject e imposta l'etichetta color su red:

Richiesta:

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

Dove PROJECT_NUMBER è l'ID numerico del progetto che vuoi aggiornare.

Corpo JSON della richiesta:

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

Risposta:

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

Passaggi successivi

Scopri come spostare un progetto all'interno della gerarchia di risorse.
Scopri come eseguire la migrazione di un progetto da una risorsa dell'organizzazione a un'altra.

Visualizzare e aggiornare i progetti Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Trovare il nome, il numero e l'ID del progetto

Console

Recuperare un progetto esistente

gcloud

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

curl

PowerShell

Elenco di tutti i progetti in una risorsa

REST

curl

PowerShell

Cerca progetti

gcloud

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

curl

PowerShell

Aggiorna progetti

Console

gcloud

REST

Passaggi successivi

Visualizzare e aggiornare i progetti