In questa pagina viene descritto come utilizzare l'archiviazione a due regioni.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per la creazione di un bucket a due regioni, chiedi all'amministratore di concederti il ruolo IAM Amministratore Storage (roles/storage.admin
) per il progetto.
Questo ruolo predefinito contiene l'autorizzazione necessaria per creare un bucket a due regioni. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
storage.buckets.create
storage.buckets.enableObjectRetention
(richiesto solo se si abilitano le configurazioni di conservazione degli oggetti per il bucket)storage.buckets.list
(richiesto solo se si crea un bucket utilizzando la console Google Cloud)resourcemanager.projects.get
(richiesto solo se si crea un bucket utilizzando la console Google Cloud)
Potresti essere in grado di ottenere queste autorizzazioni anche con i ruoli personalizzati o altri ruoli predefiniti. Per sapere quali ruoli sono associati a quali autorizzazioni, consulta Ruoli IAM per Cloud Storage.
Per istruzioni sulla concessione dei ruoli per i progetti, consulta Gestire l'accesso ai progetti.
Crea un bucket a due regioni
Completa i seguenti passaggi per creare un bucket a due regioni:
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Fai clic su Crea.
Nella pagina Crea un bucket, inserisci le informazioni del bucket. Per andare al passaggio successivo, fai clic su Continua.
In Assegna un nome al bucket, inserisci un nome che soddisfi i requisiti di denominazione dei bucket.
Per Scegli dove archiviare i tuoi dati, accanto a Tipo di località, scegli Due regioni. (Facoltativo) Puoi combinare la funzionalità con la replica turbo, selezionando la casella di controllo Aggiungi replica turbo.
In Località, seleziona il Continente e le Regioni associate che vuoi utilizzare.
In Scegli una classe di archiviazione predefinita per i tuoi dati, seleziona una classe di archiviazione per il bucket. La classe di archiviazione predefinita è assegnata per impostazione predefinita a tutti gli oggetti caricati nel bucket.
Per Scegli come controllare l'accesso agli oggetti, seleziona le opzioni di prevenzione dell'accesso pubblico e di controllo dell'accesso che vuoi utilizzare.
Per Scegli come proteggere i dati degli oggetti, seleziona gli strumenti di protezione che vuoi utilizzare, come il controllo delle versioni degli oggetti, un criterio di conservazione e un metodo di crittografia.
Fai clic su Crea.
Per scoprire come ottenere informazioni dettagliate sugli errori relativi alle operazioni di Cloud Storage non riuscite nella console Google Cloud, consulta Risoluzione dei problemi.
Riga di comando
Utilizza il comando buckets create
con i flag --location
e --placement
:
gcloud storage buckets create gs://BUCKET_NAME --location=MULTI-REGION --placement=REGION_1,REGION_2
Dove:
BUCKET_NAME
è il nome del bucket che stai creando. Ad esempio,my-bucket
.MULTI-REGION
specifica il codice per più regioni associato alle regioni sottostanti. Ad esempio, quando scegli le regioniASIA-SOUTH1
(Mumbai) eASIA-SOUTH2
(Delhi), utilizzaIN
.REGION_1
specifica la posizione geografica di una regione per il tuo bucket. Ad esempio,ASIA-EAST1
.REGION_2
specifica la posizione geografica di una seconda regione per il tuo bucket. Ad esempio,ASIA-SOUTHEAST1
.
Se la richiesta ha esito positivo, il comando restituisce il seguente messaggio:
Creating gs://BUCKET_NAME/...
Per un elenco completo delle opzioni disponibili durante la creazione di bucket con gcloud storage
, consulta le opzioni per buckets create
.
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
API REST
API JSON
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Crea un file JSON contenente le impostazioni per il bucket, che deve includere
name
elocation
. Consulta la documentazione Buckets:Insert per un elenco completo delle impostazioni. Di seguito sono riportate alcune impostazioni comuni tra cui:{ "name": "BUCKET_NAME", "location": "MULTI-REGION", "customPlacementConfig": { "dataLocations": ["REGION_1", "REGION_2"] }, "storageClass": "STORAGE_CLASS" }
Dove:
BUCKET_NAME
è il nome che vuoi assegnare al bucket, soggetto ai requisiti di denominazione. Ad esempio,my-bucket
.MULTI-REGION
specifica il codice per più regioni associato alle regioni sottostanti. Ad esempio, quando scegli le regioniASIA-SOUTH1
(Mumbai) eASIA-SOUTH2
(Delhi), utilizzaIN
.REGION_1
eREGION_2
sono le regioni in cui vuoi archiviare i dati degli oggetti del bucket. Ad esempio,ASIA-EAST1
eASIA-SOUTHEAST1
.STORAGE_CLASS
è la classe di archiviazione del tuo bucket. Ad esempio:STANDARD
.
Utilizza
cURL
per chiamare l'API JSON:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b?project=PROJECT_ID"
Dove:
JSON_FILE_NAME
è il nome del file JSON che hai creato nel passaggio 2.PROJECT_ID
è l'ID del progetto a cui verrà associato il bucket. Ad esempio,my-project
.
API XML
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Crea un file XML contenente le seguenti informazioni:
<CreateBucketConfiguration> <LocationConstraint>MULTI-REGION</LocationConstraint> <CustomPlacementConfig> <DataLocations> <DataLocation>REGION_1</DataLocation> <DataLocation>REGION_2</DataLocation> </DataLocations> </CustomPlacementConfig> <StorageClass>STORAGE_CLASS</StorageClass> </CreateBucketConfiguration>
Dove:
MULTI-REGION
specifica il codice per più regioni associato alle regioni sottostanti. Ad esempio, quando scegli le regioniASIA-SOUTH1
(Mumbai) eASIA-SOUTH2
(Delhi), utilizzaIN
.REGION_1
eREGION_2
sono le regioni in cui vuoi archiviare i dati degli oggetti del bucket. Ad esempio,ASIA-EAST1
eASIA-SOUTHEAST1
.STORAGE_CLASS
è la classe di archiviazione predefinita del tuo bucket. Ad esempio:STANDARD
.
Utilizza
cURL
per chiamare l'API XML:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "x-goog-project-id: PROJECT_ID" \ "https://storage.googleapis.com/BUCKET_NAME"
Dove:
XML_FILE_NAME
è il nome del file XML che hai creato nel passaggio 2.PROJECT_ID
è l'ID del progetto a cui verrà associato il bucket. Ad esempio,my-project
.BUCKET_NAME
è il nome che vuoi assegnare al bucket, soggetto ai requisiti di denominazione dei bucket. Ad esempio,my-bucket
.
Se la richiesta include regioni non supportate, viene restituito un messaggio di errore. Se la richiesta ha esito positivo, non viene restituita alcuna risposta.
Passaggi successivi
- Scopri di più sulla replica turbo.
- Recuperare i metadati dei bucket, inclusa l'accoppiamento delle regioni utilizzato da un bucket a due regioni.
- Scopri di più sui prezzi della replica turbo o consulta un esempio di prezzi.