Progetti

I progettiGoogle Cloud ti consentono di organizzare le risorse, gestire l'accesso e monitorare la fatturazione. Tutte le risorse Google Cloud appartengono a un progetto, incluse le risorse Cloud Storage come bucket e oggetti.

Un progetto è costituito da un insieme di utenti, un insieme di API e le impostazioni di fatturazione, autenticazione e monitoraggio per queste API. Ad esempio, tutti i bucket e gli oggetti Cloud Storage, insieme alle autorizzazioni utente per accedervi, risiedono in un progetto.

Puoi avere un solo progetto o crearne diversi e utilizzarli per organizzare le tue risorse Google Cloud , inclusi i dati di Cloud Storage, in gruppi logici.

Per informazioni di base, consulta la panoramica dei progetti in Google Cloud.

Quando specificare un progetto

Nella maggior parte dei casi, non è necessario specificare un progetto quando esegui azioni in Cloud Storage. Tuttavia, devi includere l'ID progetto o il numero di progetto nei seguenti casi:

Console

  • Quando utilizzi Cloud Storage con la console Google Cloud , vieni associato automaticamente a un progetto. Puoi cambiare progetto utilizzando il menu a discesa nella parte superiore della finestra della console Google Cloud .

  • Quando accedi per la prima volta a un bucket per cui è stata attivata la funzionalità Pagamenti a carico del richiedente, ti viene chiesto di selezionare un progetto a cui fatturare le richieste. In seguito, puoi modificare il progetto di fatturazione utilizzando il pulsante Cambia progetto situato sopra l'elenco degli oggetti nel bucket.

Riga di comando

I seguenti comandi utilizzano la proprietà project impostata nella configurazione di Google Cloud CLI, a meno che non utilizzi il flag globale --project nel comando per specificare un progetto diverso:

Utilizza il flag globale --billing-project, insieme a un identificatore del progetto, per indicare il progetto a cui addebitare l'accesso al bucket. Questo è obbligatorio quando accedi a un bucket in cui è abilitata l'opzione Pagamenti a carico del richiedente, altrimenti è facoltativo.

Librerie client

Le librerie client di Cloud Storage richiedono la specifica di un progetto nelle stesse circostanze dell'API JSON.

API JSON

I seguenti metodi richiedono di specificare un progetto:

Il progetto viene inviato come parametro nell'URL della richiesta, come nel seguente esempio:

GET https://storage.googleapis.com/storage/v1/b?project=PROJECT_IDENTIFIER

  • Per indicare un progetto a cui addebitare l'accesso al bucket, utilizza il parametro di query "userProject" insieme a un identificatore di progetto, come nell'esempio seguente:

    GET https://storage.googleapis.com/storage/v1/b?userProject=PROJECT_IDENTIFIER

    Questo parametro di query è obbligatorio quando si accede a un bucket in cui è abilitata l'opzione Pagamenti a carico del richiedente, altrimenti è facoltativo.

API XML

Le seguenti richieste richiedono di specificare un progetto, a meno che tu non abbia impostato un progetto predefinito per l'accesso interoperabile:

Il progetto associato a queste richieste API XML è specificato nell'intestazione HTTP x-goog-project-id, come nell'esempio seguente:

x-goog-project-id: PROJECT_ID

L'intestazione è facoltativa per altre richieste API XML.

  • Per indicare un progetto a cui addebitare l'accesso al bucket, utilizza l'intestazione "x-goog-user-project" insieme a un ID progetto, come nell'esempio seguente:

    x-goog-user-project: PROJECT_ID

    Questa intestazione è obbligatoria quando si accede a un bucket per cui è abilitata l'opzione Pagamenti a carico del richiedente, altrimenti è facoltativa.

Progetti e autorizzazioni

Per ogni progetto, utilizzi Identity and Access Management (IAM) per concedere la possibilità di gestire e lavorare sul progetto. Quando concedi un ruolo IAM a un'entità, ad esempio un account utente, l'entità ottiene determinate autorizzazioni che le consentono di eseguire azioni. Quando concedi un ruolo a livello di progetto, l'accesso fornito dal ruolo si applica a ogni bucket e oggetto all'interno del progetto. In alternativa, quando concedi un ruolo per un singolo bucket, l'accesso fornito dal ruolo è limitato solo a quel bucket e agli oggetti che contiene.

Per un elenco dei ruoli disponibili che si applicano a Cloud Storage, nonché per una discussione su come un insieme speciale di ruoli, chiamati ruoli di base, si applica a Cloud Storage, consulta Ruoli IAM di Cloud Storage.

Per istruzioni su come visualizzare, concedere e revocare i ruoli di un'entità a livello di bucket e di progetto, consulta Utilizzo di IAM con i progetti.

Service account

I service account consentono alle applicazioni di autenticarsi e accedere a risorse e serviziGoogle Cloud . Ad esempio, puoi creare un service account che le tue istanze Compute Engine utilizzano per accedere agli oggetti archiviati nei bucket Cloud Storage. I service account vengono creati all'interno di un progetto e hanno un indirizzo email univoco che li identifica.

Di seguito sono riportati esempi di azioni relative a Cloud Storage che vengono spesso eseguite dai service account che crei e gestisci:

Agenti di servizio

Un agente di servizio è un tipo speciale di account di servizio che agisce per conto di un servizio Google Cloud . Cloud Storage utilizza un agente di servizio per le seguenti funzionalità:

L'agente di servizio Cloud Storage non è inizialmente disponibile quando crei un progetto. Viene invece attivato automaticamente al primo accesso, da una delle funzionalità elencate in precedenza o quando richiedi il nome dell'agente di servizio. Il service agent deve essere attivato prima di assegnare le autorizzazioni.

Di seguito è riportato un esempio di indirizzo email per l'agente di servizio Cloud Storage associato al numero di progetto 123456789876:

service-123456789876@gs-project-accounts.iam.gserviceaccount.com

Eliminazioni di progetti

Quando elimini (chiudi) un progetto, vengono eliminati anche i bucket Cloud Storage e gli oggetti al loro interno, a meno che non siano protetti dall'eliminazione temporanea. Per proteggere i tuoi dati nel caso in cui un progetto venga eliminato accidentalmente o con dolo, ti consigliamo di abilitare l'eliminazione temporanea nei tuoi bucket:

  • Se elimini il progetto, i bucket con l'eliminazione temporanea abilitata vengono conservati per la durata di conservazione dell'eliminazione temporanea o per la finestra di recupero del progettoGoogle Cloud , a seconda di quale periodo di tempo è più breve. Trascorso questo periodo di tempo, il bucket viene eliminato definitivamente.

  • Se ripristini un progetto eliminato, i bucket vengono ripristinati allo stato in cui si trovavano quando il progetto è stato eliminato. Ad esempio, i bucket attivi al momento dell'eliminazione del progetto vengono ripristinati come bucket attivi.

  • I bucket non protetti dall'eliminazione temporanea potrebbero essere eliminati immediatamente quando viene eliminato un progetto e potrebbero non essere ripristinabili.

Ti consigliamo inoltre le seguenti strategie per proteggere i tuoi dati dalle eliminazioni dei progetti:

  • Limita l'accesso all'eliminazione a livello di progetto inserendo un blocco sui tuoi progetti.

  • Eseguire il backup dei dati aziendali critici in bucket di un progetto diverso.

Per saperne di più sulle opzioni per proteggere e recuperare i dati, consulta Opzioni di protezione, backup e recupero dei dati.

Passaggi successivi