Creazione e gestione dei progetti

I progettiGoogle Cloud sono la base per creare, abilitare e utilizzare tutti i servizi Google Cloud , tra cui gestione delle API, attivazione della fatturazione, aggiunta e rimozione di collaboratori e gestione delle autorizzazioni per le risorse Google Cloud .

Questa pagina spiega come creare e gestire i Google Cloud progetti utilizzando l'API Cloud Resource Manager e la Google Cloud console.

Prima di iniziare

Scopri di più sulla risorsa progetto nella panoramica della gerarchia delle risorse. Per indicazioni sulla configurazione della gerarchia delle risorse, vedi Decidere una gerarchia delle risorse per la tua Google Cloud landing zone.

Per identificare il tuo progetto vengono utilizzati i seguenti elementi:

• Nome progetto: un nome leggibile per il progetto.

  Il nome del progetto non è utilizzato da nessuna API di Google. Puoi modificare il nome del progetto in qualsiasi momento durante o dopo la creazione del progetto. I nomi dei progetti non devono essere univoci.

• ID progetto: un identificatore univoco globale per il tuo progetto.

  Un ID progetto è una stringa univoca utilizzata per distinguere il tuo progetto da tutti gli altri in Google Cloud. Dopo aver inserito un nome del progetto, la consoleGoogle Cloud genera un ID progetto univoco che può essere una combinazione di lettere, numeri e trattini. Ti consigliamo di utilizzare l'ID progetto generato, ma puoi modificarlo durante la creazione del progetto. Una volta creato il progetto, l'ID progetto è permanente.

  Un ID progetto deve soddisfare i seguenti requisiti:

  • Deve avere una lunghezza compresa tra 6 e 30 caratteri.
  • Può contenere solo lettere minuscole, numeri e trattini.
  • Deve iniziare con una lettera.
  • Non può terminare con un trattino.
  • Non può essere in uso o utilizzato in precedenza, inclusi i progetti eliminati.
  • Non può contenere stringhe con limitazioni come google e ssl. Ti consigliamo di non utilizzare le stringhe undefined e null in un ID progetto.

• Numero di progetto: un identificatore univoco generato automaticamente per il tuo progetto.

Non includere informazioni sensibili come quelle che consentono l'identificazione personale (PII) o dati di sicurezza nel nome del progetto, nell'ID progetto o in altri nomi di risorse. L'ID progetto viene utilizzato nel nome di molte altre risorse Google Cloud e qualsiasi riferimento al progetto o alle risorse correlate espone l'ID progetto e il nome della risorsa.

Crea un progetto

Per creare un progetto, devi disporre dell'autorizzazione resourcemanager.projects.create. Questa autorizzazione è inclusa in ruoli come Autore progetto (roles/resourcemanager.projectCreator).

Il ruolo Autore progetto viene concesso per impostazione predefinita all'intero dominio di una nuova risorsa organizzazione e agli utenti della prova gratuita.

Per informazioni su come concedere il ruolo a privati e limitare l'accesso a livello di risorsa dell'organizzazione, consulta la pagina Gestione dei ruoli predefiniti dell'organizzazione.

Se non specifichi la risorsa principale, ne viene selezionata una automaticamente, se applicabile, in base al dominio dell'account utente.

Puoi creare un nuovo progetto utilizzando la console Google Cloud , Google Cloud CLI o il metodo projects.create().

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

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

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

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

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

Aggiungere tag durante la creazione del progetto

I tag forniscono un modo per creare annotazioni per le risorse. Puoi aggiungere tag al momento della creazione dei progetti. Devi assegnare il ruolo Tagga utente durante l'aggiunta dei tag. Per ulteriori informazioni sulle autorizzazioni assegnate a questo ruolo, vedi Gestire i tag sulle risorse. Puoi aggiungere lo spazio dei nomi per le coppie chiave-valore del tag in uno dei seguenti modi:

gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID --tags=KEY_VALUE_PAIRS

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

Creazione di un progetto utilizzando un account di servizio

Puoi utilizzare un account di servizio per automatizzare la creazione dei progetti. Come gli account utente, ai service account può essere concessa l'autorizzazione per creare progetti all'interno di una risorsa organizzazione. I service account non possono creare progetti al di fuori di una risorsa organizzazione e devono specificare la risorsa padre durante la creazione di un progetto. I service account possono creare un nuovo progetto utilizzando gcloud CLI o il metodo projects.create().

Gestione delle quote progetto

Se nella quota rimangono meno di 30 progetti, una notifica mostra il numero di progetti rimanenti nella quota nella pagina Nuovo progetto. Dopo aver raggiunto il limite di progetti, per crearne altri devi richiedere un aumento del limite di progetti. In alternativa, puoi pianificare l'eliminazione di alcuni progetti dopo 30 giorni nella pagina Gestisci risorse. I progetti che gli utenti hanno eliminato temporaneamente vengono conteggiati ai fini della quota. Questi progetti vengono eliminati completamente dopo 30 giorni.

Per richiedere capacità aggiuntiva per i progetti nella quota dell'organizzazione:

1. Vai alla pagina Quote e limiti di sistema.

   Vai a Quote e Limiti di sistema

2. Nel selettore delle risorse, seleziona l'organizzazione per cui vuoi aumentare la quota del progetto.

3. Nell'opzione Filtro, seleziona Metrica e inserisci cloudresourcemanager.googleapis.com/projects_count.

4. Seleziona API Cloud Resource Manager, fai clic su more_vert Altre azioni e poi seleziona edit Modifica quota.

5. Nella finestra di dialogo Modifiche alla quota, inserisci un nuovo valore della quota e una descrizione, poi fai clic su Avanti.

6. Inserisci i tuoi dati di contatto e fai clic su Invia richiesta.

Riceverai un'email di conferma della ricezione della richiesta. Se hai bisogno di ulteriore assistenza, rispondi all'email. Dopo la revisione, riceverai una notifica via email indicante se la richiesta è stata approvata.

Se non hai un'organizzazione e vuoi richiedere capacità aggiuntiva per i progetti nella tua quota, utilizza il modulo Richiedi aumento della quota di progetto.

Per ulteriori informazioni sulle quote e sul motivo per cui vengono utilizzate, consulta la pagina di assistenza Richieste di quota di progetto per la prova gratuita. Per ulteriori informazioni sui report di fatturazione, consulta la pagina di assistenza Report di fatturazione.

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.

1. Vai alla pagina Benvenuto nella console Google Cloud .

   Vai a Benvenuto

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

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

Recuperare un progetto esistente

Puoi ottenere un progetto esistente utilizzando Google Cloud CLI o il metodo projects.get().

Se non sei il proprietario di un progetto, devi disporre delle autorizzazioni incluse nel ruolo Browser (roles/browser).

GET https://cloudresourcemanager.googleapis.com/v3/projects/<var>PROJECT_ID</var>

{
    "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, con la risorsa padre specificata nella query:

Richiesta:

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

{
    "parent": "folders/662951040570"
}

Risposta:

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

Cerca progetti

Per cercare progetti corrispondenti alla query specificata, utilizza gcloud alpha resource-manager projects search, passando la query nel flag --query. L'ambito della ricerca sono tutti i progetti per i quali l'utente dispone dell'autorizzazione projects.get.

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

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

GET https://cloudresourcemanager.googleapis.com/v3/projects:search?query=labels.color%3Ared

{
  "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 specifichi i campi parent.type e parent.id nel corpo della richiesta, l'autorizzazione resourcemanager.projects.list viene verificata sull'elemento principale. Se l'utente dispone di questa autorizzazione, tutti i progetti secondari vengono restituiti dopo l'applicazione dei filtri rimanenti.

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

Se non viene specificato alcun filtro, la chiamata restituisce i progetti per i quali l'utente dispone delle autorizzazioni resourcemanager.projects.get.

Aggiornamento dei progetti

Puoi aggiornare i progetti utilizzando la console Google Cloud o il metodo projects.patch().

Gli unici campi che possono essere aggiornati sono il nome e le etichette del progetto. Per ulteriori informazioni sull'aggiornamento dei progetti, consulta la pagina di riferimento dell'API Project.

Per spostare un progetto all'interno della tua gerarchia di risorse, consulta Spostamento di un progetto. Per eseguire la migrazione di un progetto da una risorsa organizzazione a un'altra, consulta la sezione Migrazione dei progetti.

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

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

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

Chiusura (eliminazione) di progetti

Puoi chiudere i progetti utilizzando la console Google Cloud o il metodo projects.delete nell'API. Per essere arrestato in questo modo, un progetto deve avere lo stato del ciclo di vita ACTIVE.

Questo metodo contrassegna immediatamente un progetto da eliminare. Viene inviata un'email di notifica all'utente che ha avviato l'operazione di eliminazione e ai contatti della categoria Tecnico elencati in Contatti necessari secondo il criterio del "best effort". Se la notifica non viene inviata, il progetto viene comunque contrassegnato per l'eliminazione. Se non è presente alcun contatto nella categoria Tecnico, il contatto di riserva non riceve alcuna notifica.

Un progetto contrassegnato per l'eliminazione non è utilizzabile. Se al progetto è associato un account di fatturazione, l'associazione viene interrotta e non viene reintegrata se l'operazione di eliminazione del progetto viene annullata. Dopo 30 giorni, il progetto viene eliminato completamente. Finché non viene eliminato completamente, il progetto potrebbe essere ancora visibile, anche se non è utilizzabile.

Per interrompere la procedura di eliminazione del progetto durante il periodo di 30 giorni, consulta i passaggi per ripristinare un progetto.

Al termine del periodo di 30 giorni, il progetto e tutte le relative risorse vengono eliminati e non possono più essere recuperati. Finché non viene eliminato, il progetto viene incluso nel calcolo della quota di progetti.

Per assicurarti di non eliminare progetti importanti, puoi attivare i consigli sui rischi di modifica. Le raccomandazioni per la modifica del rischio generano avvisi quando tenti di eliminare progetti che Google Cloud sono stati identificati come importanti.

Se hai configurato la fatturazione per un progetto, questo potrebbe non essere eliminato completamente fino al termine del ciclo di fatturazione corrente e all'addebito riuscito sul tuo account. Il numero e i tipi di servizi in uso possono anche influire sul momento in cui il sistema elimina definitivamente un progetto. Per scoprire di più sulla conservazione dei dati e sull'eliminazione sicura, consulta Modalità di conservazione dei dati raccolti da Google.

Chiudere un progetto

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

Risoluzione dei problemi di eliminazione del progetto

Se la procedura di chiusura di un progetto non va a buon fine, puoi trovare maggiori informazioni in Risoluzione dei problemi di eliminazione del progetto.

Ripristinare un progetto

I proprietari del progetto possono ripristinare un progetto eliminato entro il periodo di recupero di 30 giorni che inizia quando il progetto viene chiuso.

Considerazioni

Il ripristino di un progetto lo riporta allo stato in cui si trovava prima dell'arresto, con alcune eccezioni:

• La fatturazione è disattivata nel progetto quando il progetto viene chiuso e la fatturazione non viene attivata automaticamente nei progetti ripristinati. L'account di fatturazione Cloud deve essere collegato manualmente di nuovo dopo il ripristino del progetto. Potresti dover attendere alcune ore prima di poter collegare correttamente un progetto ripristinato di recente a un account di fatturazione.

• Puoi recuperare la maggior parte delle risorse se ripristini un progetto entro il periodo di 30 giorni.

• Alcuni servizi hanno ritardi nel ripristino e potresti dover attendere fino a 36 ore prima che vengano ripristinati.

• Alcune risorse, come quelle di Cloud Storage o Pub/Sub, vengono eliminate molto prima. Queste risorse potrebbero non essere completamente recuperabili anche se ripristini il progetto entro il periodo di 30 giorni.

• Alcuni servizi potrebbero dover essere riavviati manualmente. Per ulteriori informazioni, vedi Riavvio dei servizi Google Cloud .

Devi disporre dell'autorizzazione resourcemanager.projects.undelete per il progetto che vuoi ripristinare. Per ripristinare un progetto:

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