Creazione e gestione dei progetti

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, undefined e ssl.

• 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() .

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

1. Vai alla pagina Ti diamo il benvenuto nella console Google Cloud.

   Vai a Ti diamo il benvenuto

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

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

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

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

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:

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