I progetti Google Cloud sono la base per creare, abilitare e utilizzare tutti i servizi Google Cloud, tra cui la gestione delle API, l'abilitazione della fatturazione, l'aggiunta e la rimozione di collaboratori e la gestione delle autorizzazioni per le risorse Google Cloud.
In questa pagina viene spiegato come creare e gestire i progetti Google Cloud utilizzando l'API Resource Manager e la console Google Cloud.
Prima di iniziare
Ulteriori informazioni sulla risorsa del progetto nell'articolo Panoramica della gerarchia delle risorse. Per indicazioni sulla configurazione della gerarchia delle risorse, consulta Definire una gerarchia delle risorse per la zona di destinazione di Google Cloud.
Per identificare il progetto vengono utilizzati:
Nome del 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 di progetto non devono essere necessariamente univoci.
ID progetto: un identificatore univoco globale per il progetto.
Un ID progetto è una stringa univoca utilizzata per distinguere il tuo progetto da tutti gli altri in Google Cloud. Dopo aver inserito il nome di un progetto, la console Google Cloud genera un ID progetto univoco composto da una combinazione di lettere, numeri e trattini. Ti consigliamo di usare l'ID progetto generato, ma puoi modificarlo durante la creazione del progetto. Una volta creato il progetto, l'ID progetto è permanente.
Un ID progetto ha 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 utilizzata in precedenza; sono inclusi i progetti eliminati.
- Non può contenere stringhe limitate, come
google,null,undefinedessl.
Numero progetto: un identificatore univoco generato automaticamente per il tuo progetto.
Non includere informazioni sensibili come informazioni che consentono l'identificazione personale (PII) o dati di sicurezza nel nome del progetto, nell'ID progetto o in altri nomi delle risorse. L'ID progetto viene utilizzato come 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.
Creazione di un progetto
Per creare un progetto, devi disporre dell'autorizzazione resourcemanager.projects.create. Questa autorizzazione è inclusa in ruoli quali il ruolo Autore progetto (roles/resourcemanager.projectCreator). Il ruolo Autore progetto viene concesso per impostazione predefinita all'intero dominio di una nuova risorsa dell'organizzazione e agli utenti della prova gratuita.
Per informazioni su come concedere ai singoli utenti il ruolo e limitare l'accesso a livello di risorsa dell'organizzazione, consulta la pagina Gestione dei ruoli predefiniti dell'organizzazione.
Se non specifichi la risorsa padre, viene selezionata automaticamente una risorsa padre, 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().
Console
Per creare un nuovo progetto, segui questi passaggi:
-
Vai alla pagina Gestisci risorse nella console Google Cloud.
I passaggi rimanenti verranno visualizzati automaticamente nella console Google Cloud.
- Nell'elenco a discesa Seleziona organizzazione nella parte superiore della pagina, scegli la risorsa Organizzazione in cui creare un progetto. Se stai usufruendo di una prova gratuita, salta questo passaggio perché l'elenco non viene visualizzato.
- Fai clic su Crea progetto.
- Nella finestra Nuovo progetto visualizzata, inserisci un nome per il progetto e seleziona un account di fatturazione appropriato. Il nome del progetto può contenere solo lettere, numeri, virgolette singole, trattini, spazi o punti esclamativi e deve avere una lunghezza compresa tra 4 e 30 caratteri.
- Inserisci la cartella o l'organizzazione padre nella casella Posizione. Questa risorsa sarà l'entità padre gerarchica di un nuovo progetto. Se Nessuna organizzazione è un'opzione, puoi selezionarla per creare il nuovo progetto come livello superiore della sua gerarchia di risorse.
- Una volta specificati i dettagli del nuovo progetto, fai clic su Crea.
gcloud
-
In Google Cloud Console, attiva Cloud Shell.
Nella parte inferiore di Google Cloud Console, 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à installato e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.
Per creare un nuovo progetto, utilizza il comando
gcloud projects create:gcloud projects create PROJECT_IDdove PROJECT_ID è l'ID del progetto da creare. Un ID progetto deve iniziare con una lettera minuscola, contenere solo lettere, cifre e trattini ASCII e deve essere compreso tra 6 e 30 caratteri.
Per creare un progetto con una risorsa dell'organizzazione o una cartella come padre, utilizza i flag
--organizationo--folder. Poiché una risorsa può avere un solo elemento padre, è possibile utilizzare solo uno di questi flag:gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID gcloud projects create PROJECT_ID --folder=FOLDER_ID
API
Non puoi usare determinate parole nell'ID progetto quando crei un nuovo progetto con il metodo projects.create(). Alcuni esempi includono google, null, undefined e ssl.
Quando utilizzi una parola con limitazioni, la richiesta restituisce
un errore INVALID_ARGUMENT.
La richiesta seguente crea solo un progetto e non lo associa automaticamente a un account di fatturazione. Utilizza il metodo projects.updateBillingInfo per impostare o aggiornare l'account di fatturazione associato a un progetto.
Crea richiesta di progetto:
POST https://cloudresourcemanager.googleapis.com/v3/projects/
Authorization: *************
Content-Type: application/json
{
"projectId": "our-project-123",
"name": "my project",
"labels": {
"mylabel": "prod"
}
}
Crea risposta al progetto:
{
"name": "operations/pc.123456789",
}
Recupero richiesta operazione:
GET https://cloudresourcemanager.googleapis.com/v3/operations/pc.123456789
Authorization: *************
Content-Type: application/json
Recupero risposta operazione:
{
"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"
}
}
Creazione di un progetto utilizzando un account di servizio
Puoi utilizzare un account di servizio per automatizzare la creazione dei progetti. Analogamente agli account utente, agli account di servizio può essere concessa l'autorizzazione per creare progetti all'interno di una risorsa dell'organizzazione. Gli account di servizio non sono autorizzati a creare progetti al di fuori di una risorsa dell'organizzazione e devono specificare la risorsa padre durante la creazione di un progetto.
Gli account di servizio possono creare un nuovo progetto utilizzando gcloud CLI o il metodo projects.create().
Gestione delle quote dei progetti
Se nella quota rimangono meno di 30 progetti, nella pagina Nuovo progetto viene visualizzato il numero di progetti rimanenti nella quota. Una volta raggiunto il limite di progetti, per creare altri progetti devi richiedere un aumento del limite. In alternativa, puoi pianificare l'eliminazione di alcuni progetti dopo 30 giorni nella pagina Gestisci risorse. I progetti eliminati temporaneamente dagli utenti vengono conteggiati nella quota. Questi progetti vengono eliminati completamente dopo 30 giorni.
Per richiedere ulteriore capacità per i progetti nella tua quota, utilizza il modulo Richiedi aumento della quota dei progetti. Per ulteriori informazioni sulle quote e sul motivo per cui vengono utilizzate, consulta la pagina di assistenza relativa alle richieste di quota del progetto di prova gratuita. Per ulteriori informazioni sui report di fatturazione, consulta la pagina di assistenza Report di fatturazione.
Identificazione dei progetti
Per interagire con le risorse Google Cloud, devi fornire le informazioni di identificazione del progetto per ogni richiesta. Un progetto è identificato dall'ID e dal numero del progetto.
Per ottenere l'ID e il numero del progetto:
Vai alla pagina Dashboard nella console Google Cloud.
Fai clic sull'elenco a discesa Seleziona da nella parte superiore della pagina. Nella finestra Seleziona da visualizzata, scegli il tuo progetto.
L'ID e il numero del progetto vengono visualizzati nella scheda Informazioni sul progetto della dashboard del progetto:
Nell'esempio precedente, il nome del progetto è My Sample Project e l'ID progetto è my-sample-project-191923.
Ottieni un progetto esistente
Puoi ottenere un progetto esistente utilizzando la console Google Cloud o il metodo projects.get().
Se non sei un proprietario del progetto, devi disporre delle autorizzazioni incluse nel ruolo Browser (roles/browser).
Console
Per visualizzare un progetto utilizzando la console Google Cloud, segui questi passaggi:
- Vai alla pagina Dashboard nella console Google Cloud.
- Seleziona il progetto dal selettore di progetti nella parte superiore della pagina.
gcloud
-
In Google Cloud Console, attiva Cloud Shell.
Nella parte inferiore di Google Cloud Console, 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à installato e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.
Per ottenere i metadati di un progetto, utilizza il comando
gcloud projects describe:gcloud projects describe PROJECT_IDdove PROJECT_ID è l'ID del progetto da visualizzare.
API
Richiesta:
GET
https://cloudresourcemanager.googleapis.com/v3/projects/our-project-123
Risposta:
{
"projectNumber": "464036093014",
"projectId": "our-project-123",
"lifecycleState": "ACTIVE",
"name": "my project",
"labels": {
"mylabel": "prod"
},
"createTime": "2016-01-07T21:59:43.314Z"
}
Elenco progetti
Elenco di tutti i progetti in una risorsa
Per elencare tutti i progetti 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 che corrispondono alla query specificata, utilizza gcloud alpha resource-manager
projects search, passando la query nel flag --query. L'ambito della ricerca corrisponde a tutti i progetti per i quali l'utente dispone dell'autorizzazione projects.get.
gcloud
-
In Google Cloud Console, attiva Cloud Shell.
Nella parte inferiore di Google Cloud Console, 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à installato e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.
Per ottenere l'elenco di tutti i progetti, utilizza il 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
Puoi utilizzare il metodo projects.search e una stringa di query per restituire risorse di progetto specifiche che corrispondono al filtro.
I risultati contengono solo i progetti per i quali ti è stata concessa l'autorizzazione resourcemanager.projects.get.
Lo snippet di codice riportato di seguito restituisce la risorsa del progetto con il nome visualizzato "Tokyo Rain":
Richiesta:
GET https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain
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="
}
]
}
Il seguente snippet di codice restituisce tutte le risorse del progetto con un'etichetta rossa:
Richiesta:
GET https://cloudresourcemanager.googleapis.com/v3/projects:search?query=labels.color%3Ared
Risposta:
{
"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 selezionata nell'elemento padre. Se l'utente dispone di questa autorizzazione, tutti i progetti dell'elemento padre 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 per l'API del progetto.
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 dell'organizzazione a un'altra, consulta Migrazione dei progetti.
Console
Per aggiornare il nome o le etichette di un progetto utilizzando la console Google Cloud, segui questi passaggi:
- Nella console Google Cloud, vai alla pagina Impostazioni di IAM e amministrazione.
Vai a Impostazioni IAM e amministrazione
I passaggi rimanenti verranno visualizzati automaticamente 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 gratuita, 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 modificare le etichette, fai clic su Etichette nel menu di navigazione a sinistra.
Scopri di più sull'utilizzo delle etichette.
gcloud
-
In Google Cloud Console, attiva Cloud Shell.
Nella parte inferiore di Google Cloud Console, 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à installato 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, ...Dove:
PROJECT_ID è l'ID del progetto da aggiornare.
NAME è il nuovo nome da assegnare al progetto.
KEY=VALUE, ... è un elenco delle coppie chiave=valore di etichette che vuoi aggiornare. Se esiste già un'etichetta, il suo valore viene modificato. Se non esiste, viene creata una nuova etichetta.
Per ulteriori informazioni e flag aggiuntivi che possono essere utilizzati con questo comando, consulta l'SDK Google Cloud CLI.
API
Per aggiornare un progetto:
Recupera l'oggetto
projectutilizzando il metodoprojects.get.Modifica i campi che vuoi aggiornare.
Chiama il metodo
projects.patch.
L'esempio seguente aggiorna il nome visualizzato del progetto in
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 da 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"
}
}
]
}
Chiusura (eliminazione) di progetti
Puoi arrestare i progetti utilizzando la console Google Cloud o il metodo
projects.delete
nell'API. Un progetto deve avere uno stato del ciclo di vita ACTIVE per essere arrestato in questo modo.
Questo metodo contrassegna immediatamente un progetto da eliminare. Un'email di notifica viene inviata all'utente che ha avviato l'operazione di eliminazione e ai contatti della categoria tecnica elencati nei Contatti necessari al meglio delle possibilità. Se la notifica non viene inviata, il progetto viene comunque contrassegnato per l'eliminazione. Se non esistono contatti nella categoria Tecnico, il contatto di fallback 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 completamente eliminato. Finché non viene eliminato completamente, il progetto potrebbe essere ancora visibile, anche se non è utilizzabile.
Per interrompere il processo 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 essere recuperati. Finché non viene eliminato, il progetto viene conteggiato ai fini della quota di progetto.
Per assicurarti di non eliminare progetti importanti, puoi attivare i consigli sul rischio di modifica. I suggerimenti di modifica dei rischi generano avvisi quando tenti di eliminare progetti che Google Cloud ha identificato come importanti.
Se hai configurato la fatturazione per un progetto, è possibile che questo non venga eliminato completamente fino al termine del ciclo di fatturazione corrente e al completamento degli addebiti sul tuo account. Il numero e i tipi di servizi in uso possono influire anche sull'eliminazione definitiva di un progetto da parte del sistema. Per scoprire di più sulla conservazione e sull'eliminazione sicura dei dati, consulta Modalità di conservazione dei dati raccolti da Google.
Per chiudere un progetto:
Console
-
Nella console Google Cloud, vai alla pagina Impostazioni di IAM e amministrazione.
Vai a Impostazioni IAM e amministrazione
I passaggi rimanenti verranno visualizzati automaticamente nella console Google Cloud.
-
Nella pagina delle impostazioni IAM e amministrazione, seleziona il progetto che vuoi eliminare, quindi fai clic su Chiudi.
L'arresto viene visualizzato solo per gli utenti che dispongono dell'autorizzazione
resourcemanager.projects.deletenel progetto corrente. - Fai clic su Chiudi.
- Inserisci l'ID progetto e fai clic su Chiudi comunque.
gcloud
-
In Google Cloud Console, attiva Cloud Shell.
Nella parte inferiore di Google Cloud Console, 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à installato e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.
Per eliminare un progetto, utilizza il comando
gcloud projects delete:gcloud projects delete PROJECT_IDdove PROJECT_ID è l'ID del progetto da eliminare.
API
Il seguente snippet di codice elimina il progetto specificato:
Richiesta:
DELETE
https://cloudresourcemanager.googleapis.com/v3/projects/my-project-123
Risoluzione dei problemi di eliminazione del progetto
Se il processo di chiusura di un progetto non va a buon fine, puoi trovare ulteriori informazioni nella pagina relativa alla risoluzione dei problemi di eliminazione di un progetto.
Ripristino di un progetto
I proprietari del progetto possono ripristinare un progetto eliminato entro il periodo di recupero di 30 giorni che inizia alla chiusura del progetto. Il ripristino di un progetto lo riporta allo stato in cui si trovava prima della chiusura, con alcune eccezioni:
- La fatturazione è disabilitata per il progetto quando il progetto è chiuso e la fatturazione non viene attivata automaticamente sui progetti ripristinati. L'account di fatturazione Cloud deve essere collegato manualmente nuovamente 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. Il ripristino di alcuni servizi presenta ritardi e potrebbe essere necessario attendere un po' di tempo prima che vengano ripristinati.
- Alcune risorse, ad esempio 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, consulta la pagina Riavviare i servizi Google Cloud.
Devi disporre dell'autorizzazione resourcemanager.projects.undelete per il progetto
che vuoi ripristinare. Per ripristinare un progetto:
Console
Per visualizzare il progetto nella console Google Cloud, devi disporre delle seguenti autorizzazioni:
resourcemanager.projects.listresourcemanager.folders.listresourcemanager.projects.get
Per ripristinare un progetto utilizzando la console Google Cloud:
Vai alla pagina Gestisci risorse nella console Google Cloud.
Nel selettore progetti nella parte superiore della pagina, seleziona la risorsa dell'organizzazione.
Sotto l'elenco di risorse, cartelle e progetti dell'organizzazione, fai clic su Risorse in attesa di eliminazione.
Seleziona la casella corrispondente al progetto da ripristinare, quindi fai clic su Ripristina. Nella finestra di dialogo visualizzata, conferma che vuoi ripristinare il progetto.
gcloud
-
In Google Cloud Console, attiva Cloud Shell.
Nella parte inferiore di Google Cloud Console, 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à installato e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.
Per ripristinare un progetto, utilizza il comando
gcloud projects undelete:gcloud projects undelete PROJECT_IDdove PROJECT_ID è l'ID o il numero di progetto del progetto da ripristinare.
API
Il seguente snippet di codice ripristina il progetto specificato:
Richiesta:
POST
https://cloudresourcemanager.googleapis.com/v3/projects/my-project-123:undelete