I progetti Google Cloud sono la base per creare, attivare e utilizzare tutti i servizi Google Cloud, tra cui gestire le API, attivare la fatturazione, aggiungere e rimuovere collaboratori e gestire le autorizzazioni per le risorse Google Cloud.
Questa pagina spiega come creare e gestire i progetti Google Cloud utilizzando l'API Cloud Resource Manager e la console Google Cloud.
Prima di iniziare
Scopri di più sulla risorsa progetto nella Panoramica della gerarchia delle risorse. Per indicazioni su come configurare la gerarchia delle risorse, consulta Decidere una gerarchia delle risorse per la zona di destinazione Google Cloud.
Per identificare il progetto vengono utilizzati i seguenti elementi:
Nome del progetto: un nome leggibile del progetto.
Il nome del progetto non è utilizzato da nessuna API Google. Puoi modificare il nome del progetto in qualsiasi momento durante o dopo la creazione del progetto. I nomi dei progetti 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 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 sia 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 possono essere in uso o utilizzati in precedenza; inclusi i progetti eliminati.
- Non possono contenere stringhe con limitazioni, ad esempio
google,null,undefinedessl.
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 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 privati il ruolo e limitare l'accesso a tutte le risorse dell'organizzazione, consulta la pagina Gestire i ruoli predefinite dell'organizzazione.
Se non specifichi la risorsa principale, se applicabile, viene selezionata automaticamente una risorsa principale in base al dominio dell'account utente.
Puoi creare un nuovo progetto utilizzando la console Google Cloud,
Google Cloud CLI,
projects.create()
.
Console
Per creare un nuovo progetto, segui questi passaggi:
-
Vai alla pagina Gestisci risorse nella console Google Cloud.
I passaggi rimanenti vengono visualizzati 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 the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Per creare un nuovo progetto, utilizza Comando
gcloud projects create:gcloud projects create PROJECT_IDdove PROJECT_ID è l'ID del progetto che vuoi creare. Un ID progetto deve iniziare con una lettera minuscola e può contenere solo lettere, cifre e trattini ASCII. Deve essere compreso tra 6 e 30 caratteri.
Per creare un progetto con una risorsa dell'organizzazione o una cartella come elemento principale, utilizza i flag
--organizationo--folder. Una risorsa può avere un solo principale, è possibile usare uno solo di questi flag:gcloud projects create PROJECT_ID --organization=ORGANIZATION_IDgcloud projects create PROJECT_ID --folder=FOLDER_ID
API
Non puoi utilizzare determinate parole nell'ID progetto quando crei un nuovo progetto
con il metodo projects.create(). Alcuni esempi sono google, null, undefined e ssl.
Quando utilizzi una parola con limitazioni, la richiesta viene restituita con un errore INVALID_ARGUMENT.
La richiesta riportata di seguito crea solo un progetto e non lo associa automaticamente a un account di fatturazione. Utilizza la
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 del progetto:
{
"name": "operations/pc.123456789",
}
Richiesta di recupero 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"
}
}
Aggiungere tag durante la creazione del progetto
I tag consentono di creare annotazioni per le risorse. Puoi aggiungere i tag al momento della creazione dei progetti. Tu Devi assegnare il ruolo Utente tag durante l'aggiunta di tag. Per ulteriori informazioni sulle autorizzazioni assegnate a questo ruolo, consulta Gestire i tag nelle risorse. Puoi aggiungere lo spazio dei nomi per le coppie chiave-valore del tag in uno dei seguenti modi:
gcloud
Per aggiungere tag durante la creazione del progetto, esegui questo comando:
gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID --tags=KEY_VALUE_PAIRS
Sostituisci quanto segue:
- PROJECT_ID è l'identificatore univoco del progetto.
- ORGANIZATION_ID è l'identificatore univoco dell'organizzazione.
- KEY_VALUE_PAIRS è un elenco di coppie chiave-valore separate da virgole che puoi assegnare alla risorsa. Un esempio di coppie chiave-valore separate da virgole è
123/environment=production, 456/create=testresource.
API
Lo snippet seguente è una richiesta JSON in cui crei un progetto e aggiungere tag.
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,
agli account di servizio possono essere concesse
l'autorizzazione per creare progetti all'interno
risorsa dell'organizzazione. Agli account di servizio non è consentito creare progetti al di fuori di un
organizzazione e devi specificare la risorsa padre quando crei un progetto.
Gli account di servizio possono creare un nuovo progetto utilizzando l'interfaccia a riga di comando gcloud o il metodo projects.create().
Gestione delle quote del progetto
Se nella quota rimangono meno di 30 progetti, una notifica mostra il numero di progetti rimanenti nella quota nella pagina Nuovo progetto. Una volta raggiunto il limite di progetti, per creare altri progetti devi richiedere un limite di progetti aumentano. In alternativa, puoi pianificare l'eliminazione di alcuni progetti dopo 30 giorni nella pagina Gestisci risorse. Progetti di cui gli utenti dispongono eliminati temporaneamente vengono conteggiati ai fini della quota. Questi progetti vengono eliminati definitivamente dopo 30 giorni.
Per richiedere capacità aggiuntiva per i progetti nella tua quota, utilizza Richiedi l'aumento della quota del progetto in un modulo di testo. Puoi trovare maggiori informazioni sulle quote e sul motivo per cui vengono utilizzate nella pagina di assistenza Richieste di quote per progetti di 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 la classe identificando le informazioni del progetto per ogni richiesta. Un progetto viene identificato e il relativo ID e numero di progetto.
Vai alla pagina Ti diamo il benvenuto nella console Google Cloud.
Seleziona il tuo progetto dal selettore dei progetti nella parte superiore della pagina.
Il nome del progetto, il numero di progetto e l'ID progetto vengono visualizzati dopo il tag Intestazione Benvenuto.
Recuperare un progetto esistente
Puoi recuperare un progetto esistente utilizzando Google Cloud CLI o il metodo projects.get().
Se non sei un proprietario del progetto, devi disporre delle autorizzazioni incluse nel
Ruolo Browser (roles/browser).
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Per ottenere i metadati per un progetto, utilizza il metodo
gcloud projects describe:gcloud projects describe PROJECT_IDSostituisci
PROJECT_IDcon l'ID del progetto.
API
Richiesta:
GET https://cloudresourcemanager.googleapis.com/v3/projects/<var>PROJECT_ID</var>
Sostituisci PROJECT_ID con l'ID del progetto.
Risposta:
{
"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 figli diretti di una risorsa, utilizza
Metodo projects.list della versione 3,
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="
}
]
}
Cercare progetti
Per cercare progetti corrispondenti alla query specificata, usa 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.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Per ottenere l'elenco di tutti i progetti, utilizza
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 corrispondenti al filtro.
I risultati contengono solo i progetti per i quali hai ottenuto la
Autorizzazione resourcemanager.projects.get.
Il seguente snippet di codice restituisce la risorsa di 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 valori parent.type e parent.id
campi nel corpo della richiesta,
L'autorizzazione resourcemanager.projects.list è stata verificata nella
principale. Se l'utente dispone di questa autorizzazione, tutti i progetti all'interno dell'elemento padre verranno
restituiti dopo l'applicazione dei filtri rimanenti.
Se l'utente non dispone di questa autorizzazione, tutti i progetti per i quali ha l'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 ha autorizzazioni resourcemanager.projects.get.
Aggiornamento dei progetti
Puoi aggiornare i progetti utilizzando la console Google Cloud oppure
projects.patch()
.
Gli unici campi che possono essere aggiornati sono il nome del progetto e le etichette. 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 uno 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 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 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 the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
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 che vuoi assegnare al progetto.
KEY=VALUE, ... è un elenco di coppie chiave-valore delle etichette da aggiornare. Se esiste già un'etichetta, il relativo valore è modificato. Se non esiste, viene creata una nuova etichetta.
Per ulteriori informazioni e flag aggiuntivi che possono essere utilizzati con questo comando, consulta Google Cloud CLI SDK.
API
Per aggiornare un progetto:
Recupera l'oggetto
projectutilizzandoprojects.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 oppure
projects.delete
nell'API. Per poter essere chiuso, un progetto deve avere lo stato del ciclo di vita ACTIVE
in questo modo.
Questo metodo contrassegna immediatamente un progetto da eliminare. Viene inviata un'email di notifica all'utente che ha avviato l'operazione di eliminazione e al team di contatti elencati nella Contatti necessari con il massimo impegno; Se l'invio della notifica non riesce, il progetto è comunque contrassegnato per l'eliminazione. Se non è presente alcun contatto nella categoria Tecnico, il contatto di riserva non viene avvisato.
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 il processo di eliminazione del progetto durante il periodo di 30 giorni, consulta passaggi per ripristinare un progetto.
Al termine del periodo di 30 giorni, il progetto e tutte le sue risorse vengono eliminati e non possono essere recuperati. Finché non viene eliminato, il progetto viene conteggiato per la quota di progetto.
Per assicurarti di non eliminare progetti importanti, puoi attivare i consigli sui rischi di modifica. Rischio di cambiamento dei suggerimenti generano avvisi quando tenti di eliminare i progetti di cui Google Cloud identificati come importanti.
Se hai configurato la fatturazione per un progetto, questo potrebbe non essere stato completamente eliminato fino al termine del ciclo di fatturazione corrente e ai relativi addebiti sul tuo account. Il numero e i tipi di servizi in uso possono influire anche sul momento in cui il sistema elimina definitivamente un progetto. Per scoprire di più sulla conservazione e sull'eliminazione sicura dei dati, consulta Modalità di conservazione dei dati raccolti da Google.
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 vengono visualizzati nella console Google Cloud.
-
Nella piattaforma IAM e Impostazioni amministratore, seleziona il progetto che vuoi eliminare e poi
fai clic su Arresta.
L'opzione Arrest (Arresta) viene visualizzata 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 the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Per eliminare un progetto, utilizza Comando
gcloud projects delete:gcloud projects delete PROJECT_IDdove PROJECT_ID è l'ID del progetto che vuoi 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 all'indirizzo Risoluzione dei problemi relativi all'eliminazione del progetto.
Ripristina un progetto
I proprietari del progetto possono ripristinare un progetto eliminato entro il periodo di recupero di 30 giorni che inizia al momento della chiusura del progetto. Il ripristino di un progetto lo riporta allo stato precedente alla chiusura, con alcune eccezioni:
- La fatturazione è disabilitata nel progetto quando il progetto è chiuso e la fatturazione non viene abilitata 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 un progetto ripristinato di recente a un account .
- Puoi recuperare la maggior parte delle risorse se ripristini un progetto entro 30 giorni punto.
- Il ripristino di alcuni servizi potrebbe richiedere del tempo (fino a 36 ore).
- 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, consulta Riavviare i servizi Google Cloud.
Devi disporre dell'autorizzazione resourcemanager.projects.undelete per il progetto
da ripristinare. Per ripristinare un progetto:
Console
Per visualizzare il progetto nella console Google Cloud, è necessario quanto segue autorizzazioni:
resourcemanager.projects.listresourcemanager.folders.listresourcemanager.projects.get
Vai alla pagina Gestisci risorse nella console Google Cloud.
Nel Selettore di 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 relativa al progetto da ripristinare, quindi fai clic su Ripristina. Nella finestra di dialogo visualizzata, conferma che desideri ripristinare. del progetto.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Per ripristinare un progetto, utilizza
gcloud projects undelete:gcloud projects undelete PROJECT_IDPROJECT_ID è l'ID o il numero di progetto del al progetto che vuoi ripristinare.
API
Il seguente snippet di codice ripristina il progetto specificato:
Richiesta:
POST https://cloudresourcemanager.googleapis.com/v3/projects/my-project-123:undelete