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 Cloud de Confiance by S3NS , devi fornire le informazioni identificative del progetto per ogni richiesta. Un progetto viene identificato da un ID e da un numero.

Console

  1. Vai alla pagina Benvenuto nella console Cloud de Confiance .

    Vai a Benvenuto

  2. Seleziona il tuo progetto dal selettore di progetti nella parte superiore della pagina.

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

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

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' Cloud de Confiance by S3NS 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' Cloud de Confiance by S3NS 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 Cloud de Confiance utilizzando la console, segui questi passaggi:

  1. Nella Cloud de Confiance console, vai alla pagina IAM e amministrazione > Impostazioni.

    Vai a IAM e amministrazione > Impostazioni

    I passaggi rimanenti vengono visualizzati nella console Cloud de Confiance .

  2. Nella parte superiore dello schermo, fai clic sull'elenco a discesa per la selezione dei progetti.
  3. 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.
  4. Seleziona il progetto dall'elenco visualizzato.
  5. Per cambiare il nome del progetto, modificalo in Nome progetto e fai clic su Salva.
  6. 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.
  7. Per modificare le etichette, fai clic su Etichette nel menu di navigazione a sinistra.

    Scopri di più sull'utilizzo delle etichette.

gcloud

  1. Nella console Cloud de Confiance , attiva Cloud Shell.

    Attiva Cloud Shell

    Nella parte inferiore della console Cloud de Confiance 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.

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