In questa pagina viene descritto come utilizzare la funzionalità di replica turbo in un bucket a doppia area geografica.
Prerequisiti
I prerequisiti possono variare in base allo strumento utilizzato:
console
Per completare questa guida utilizzando Google Cloud Console, devi disporre delle autorizzazioni IAM appropriate. Per utilizzare questa funzionalità, devi avere o creare un bucket in una località con due aree geografiche. Se il bucket a cui vuoi accedere esiste in un progetto non creato da te, potresti dover chiedere al proprietario del progetto di assegnarti un ruolo contenente le autorizzazioni necessarie.
Per un elenco delle autorizzazioni necessarie per azioni specifiche, consulta Autorizzazioni IAM per Google Cloud Console.
Per un elenco dei ruoli pertinenti, consulta Ruoli di Cloud Storage. In alternativa, puoi creare un ruolo personalizzato con autorizzazioni specifiche e limitate.
Riga di comando
Per completare questa guida utilizzando un'utilità a riga di comando, devi disporre delle autorizzazioni IAM appropriate. Per utilizzare questa funzionalità, devi avere o creare un bucket in una località con due aree geografiche. Se il bucket a cui vuoi accedere esiste in un progetto non creato da te, potresti dover chiedere al proprietario del progetto di assegnarti un ruolo contenente le autorizzazioni necessarie.
Per un elenco delle autorizzazioni necessarie per azioni specifiche, consulta Autorizzazioni IAM per comandi gsutil.
Per un elenco dei ruoli pertinenti, consulta Ruoli di Cloud Storage. In alternativa, puoi creare un ruolo personalizzato con autorizzazioni specifiche e limitate.
Esempi di codice
Per completare questa guida utilizzando le librerie client di Cloud Storage, devi disporre delle autorizzazioni IAM appropriate. Per utilizzare questa funzionalità, devi avere o intendi creare un bucket in una località con doppia area geografica. Se il bucket a cui vuoi accedere esiste in un progetto non creato da te, potresti dover chiedere al proprietario del progetto di assegnarti un ruolo contenente le autorizzazioni necessarie. Se non diversamente indicato, le richieste della libreria client vengono effettuate tramite l'API JSON.
Per un elenco delle autorizzazioni necessarie per azioni specifiche, consulta le autorizzazioni IAM per i metodi JSON.
Per un elenco dei ruoli pertinenti, consulta Ruoli di Cloud Storage. In alternativa, puoi creare un ruolo personalizzato con autorizzazioni specifiche e limitate.
API REST
API JSON
Per completare questa guida utilizzando l'API JSON, devi disporre delle autorizzazioni IAM appropriate. Per utilizzare questa funzionalità, devi avere o creare un bucket in una località con due aree geografiche. Se il bucket a cui vuoi accedere esiste in un progetto non creato da te, potresti dover chiedere al proprietario del progetto di assegnarti un ruolo contenente le autorizzazioni necessarie.
Per un elenco delle autorizzazioni necessarie per azioni specifiche, consulta le autorizzazioni IAM per i metodi JSON.
Per un elenco dei ruoli pertinenti, consulta Ruoli di Cloud Storage. In alternativa, puoi creare un ruolo personalizzato con autorizzazioni specifiche e limitate.
API XML
Questa funzionalità non può essere gestita tramite l'API XML. Usa l'API JSON.
Controllare lo stato di replica di un bucket
Per controllare l'RPO o lo stato della replica di un bucket, completa le seguenti istruzioni:
console
- In Google Cloud Console, vai alla pagina Browser di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket da verificare.
Fai clic sulla scheda Configurazione.
Se la replica turbo è abilitata nel bucket, Replication è impostata su Turbo.
Riga di comando
Utilizza il comando gsutil rpo get
:
gsutil rpo get gs://BUCKET_NAME/
Dove:
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
In caso di esito positivo, la risposta sarà simile al seguente esempio:
gs://my-bucket: ASYNC_TURBO
Esempi di codice
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C++.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C# .
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
API REST
API JSON
- Ottieni un token di accesso all'autorizzazione da OAuth 2.0 Playground. Configura il parco giochi in modo che utilizzi le tue credenziali OAuth. Per le istruzioni, consulta la pagina relativa all'autenticazione API.
Utilizza
cURL
per chiamare l'API JSON con una richiesta di bucketGET
:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"
Dove:
OAUTH2_TOKEN
è il nome del token di accesso generato nel passaggio 1.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
La risposta sarà simile al seguente esempio:
{ "name": "my-bucket", "projectNumber": "234...", ... "rpo": "ASYNC_TURBO" }
Nota la chiave
rpo
. Il valoreASYNC_TURBO
indica che la replica turbo è abilitata.DEFAULT
indica che viene applicata la replica predefinita. Il camporpo
è sempre presente per i bucket a due e più aree geografiche, ma è assente dai bucket a singola area geografica.
API XML
Questa funzionalità non può essere gestita tramite l'API XML. Usa l'API JSON.
Imposta replica turbo
Per abilitare o disabilitare la replica turbo in un bucket esistente, completa le seguenti istruzioni:
console
- In Google Cloud Console, vai alla pagina Browser di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket desiderato.
Fai clic sulla scheda Configurazione.
Nella riga Replication, fai clic su
Modifica.La finestra visualizzata indica se stai per abilitare la replica turbo o disattivare la replica turbo.
Fai clic su Salva per confermare la nuova impostazione.
Riga di comando
Utilizza il comando gsutil rpo set
:
gsutil rpo set STATE gs://BUCKET_NAME/
Dove:
STATE
èASYNC_TURBO
per abilitare la replica turbo oDEFAULT
per la disattivazione della replica turbo.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
Se l'operazione ha esito positivo, non viene restituita una risposta. La modifica diventa effettiva immediatamente.
Esempi di codice
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C++.
L'esempio seguente abilita la replica turbo in un bucket:
L'esempio seguente abilita la replica predefinita in un bucket:
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C# .
L'esempio seguente abilita la replica turbo in un bucket:
L'esempio seguente abilita la replica predefinita in un bucket:
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Go.
L'esempio seguente abilita la replica turbo in un bucket:
L'esempio seguente abilita la replica predefinita in un bucket:
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Java.
L'esempio seguente abilita la replica turbo in un bucket:
L'esempio seguente abilita la replica predefinita in un bucket:
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
L'esempio seguente abilita la replica turbo in un bucket:
L'esempio seguente abilita la replica predefinita in un bucket:
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
L'esempio seguente abilita la replica turbo in un bucket:
L'esempio seguente abilita la replica predefinita in un bucket:
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.
L'esempio seguente abilita la replica turbo in un bucket:
L'esempio seguente abilita la replica predefinita in un bucket:
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
L'esempio seguente abilita la replica turbo in un bucket:
L'esempio seguente abilita la replica predefinita in un bucket:
API REST
API JSON
- Ottieni un token di accesso all'autorizzazione da OAuth 2.0 Playground. Configura il parco giochi in modo che utilizzi le tue credenziali OAuth. Per le istruzioni, consulta la pagina relativa all'autenticazione API.
Crea un file JSON contenente le seguenti informazioni:
{ "rpo": "STATE" }
Dove
STATE
èASYNC_TURBO
per abilitare Replica turbo oDEFAULT
per disabilitare la replica turbo.Utilizza
cURL
per chiamare l'API JSON con una richiesta diPATCH
bucket:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"
Dove:
JSON_FILE_NAME
è il percorso del file JSON che hai creato nel passaggio 2.OAUTH2_TOKEN
è il token di accesso che hai generato nel passaggio 1.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
Se la richiesta ha esito positivo, non viene restituita alcuna risposta.
API XML
Questa funzionalità non può essere gestita tramite l'API XML. Usa l'API JSON.
Crea un bucket a doppia area geografica con replica turbo
Per creare un nuovo bucket a doppia area geografica con replica turbo abilitata, segui le istruzioni riportate di seguito:
console
- In Google Cloud Console, vai alla pagina Browser di Cloud Storage.
Fai clic su Crea bucket.
Nella pagina Crea un bucket, inserisci le informazioni sul 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 dati, accanto a Tipo di località, scegli Doppia area geografica e seleziona la casella di controllo Aggiungi replica turbo.
Per Località, seleziona una delle due aree geografiche disponibili.
Per Scegli una classe di archiviazione predefinita per i tuoi dati, seleziona una classe di archiviazione per il bucket. La classe di archiviazione predefinita viene assegnata per impostazione predefinita a tutti gli oggetti caricati nel bucket.
Per Scegli come controllare l'accesso agli oggetti, seleziona un'opzione Controllo dell'accesso. Il modello di controllo dell'accesso determina il modo in cui controlli l'accesso agli oggetti del bucket.
(Facoltativo) Per le Impostazioni avanzate, aggiungi le etichette di bucket, imposta un criterio di conservazione e scegli un metodo di crittografia.
Fai clic su Crea.
Per informazioni dettagliate sugli errori nelle operazioni non riuscite nel browser di Cloud Storage, consulta la sezione Risoluzione dei problemi.
Riga di comando
Utilizza il comando gsutil mb --rpo
:
gsutil mb -l LOCATION -c CLASS --rpo REPLICATION_TYPE gs://BUCKET_NAME/
Dove:
LOCATION
specifica la località geografica del bucket. Se non viene specificata alcuna località, il criterio predefinito èUS
(più aree geografiche). Ai fini di questo esempio, specifica una doppia area geografica. Ad esempio:nam4
.CLASS
specifica la classe di archiviazione. Ad esempio,NEARLINE
.REPLICATION_TYPE
specifica l'impostazione di replica per i bucket a due e più aree geografiche. Il valoreDEFAULT
rappresenta la replica predefinita ed è un'opzione valida per i bucket a due o più aree geografiche.ASYNC_TURBO
rappresenta la replica turbo ed è un'opzione valida per molti bucket a doppia area geografica. Se non specificata, la replica predefinita è l'impostazione di replica predefinita. Ai fini di questo esempio, utilizzaASYNC_TURBO
.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.Se la richiesta ha esito positivo, il comando restituisce il seguente messaggio:
Creating gs://BUCKET_NAME/...
Esempi di codice
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C++.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C# .
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
API REST
API JSON
- Ottieni un token di accesso all'autorizzazione da OAuth 2.0 Playground. Configura il parco giochi in modo che utilizzi le tue credenziali OAuth. Per le istruzioni, consulta la pagina relativa all'autenticazione API.
Crea un file JSON contenente le impostazioni del bucket, che devono includere un
name
per il bucket. Consulta la documentazione Bucket:Inserisci per un elenco completo delle impostazioni. Di seguito sono riportate le impostazioni comuni da includere:{ "name": "BUCKET_NAME", "rpo": "REPLICATION_TYPE", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "iamConfiguration": { "uniformBucketLevelAccess": { "enabled": true }, } }
Dove:
BUCKET_NAME
è il nome che vuoi assegnare al tuo bucket, soggetto ai requisiti di denominazione. Ad esempio,my-bucket
.REPLICATION_TYPE
specifica l'impostazione di replica per i bucket a due e più aree geografiche. Il valoreDEFAULT
rappresenta la replica predefinita ed è un'opzione valida per bucket a doppia area geografica o a più aree geografiche.ASYNC_TURBO
rappresenta la replica turbo ed è un'opzione valida per la maggior parte dei bucket a doppia area geografica. Se non specificata, la replica predefinita è l'impostazione di replica predefinita. Ai fini di questo esempio, utilizzaASYNC_TURBO
.BUCKET_LOCATION
è la località in cui vuoi archiviare i dati degli oggetti del tuo bucket. Poiché stai creando un bucket con la replica turbo attivata e poiché la località geografica di un bucket è immutabile, una volta vengono specificate le due aree geografiche. Ad esempio:NAM4
.STORAGE_CLASS
è la classe di archiviazione predefinita del bucket. Ad esempio:NEARLINE
.
Utilizza
cURL
per chiamare l'API JSON:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b?project=PROJECT_ID"
Dove:
JSON_FILE_NAME
è il percorso del file JSON che hai creato nel passaggio 2.OAUTH2_TOKEN
è il token di accesso che hai generato nel passaggio 1.PROJECT_ID
è l'ID del progetto a cui verrà associato il bucket. Ad esempio,my-project
.
API XML
Questa funzionalità non può essere gestita tramite l'API XML. Usa l'API JSON.
Monitorare le prestazioni della replica turbo di un bucket
- In Google Cloud Console, vai alla pagina Browser di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket desiderato.
Fai clic sulla scheda Configurazione.
Nella riga Replica, fai clic su Visualizza metriche di replica.
Se la replica di un oggetto ha richiesto più di 15 minuti, i minuti aggiuntivi vengono aggregati e visualizzati in Google Cloud Console come Numero di minuti non conformi all'RPO. Google Cloud Console monitora inoltre il numero di repliche degli oggetti completate, mostrate come Repliche di oggetti con turbo.
Per saperne di più, consulta Informazioni su RTO e RPO.
Passaggi successivi
- Scopri di più sulla replica turbo.
- Scopri di più sui prezzi della replica turbo o vedi un esempio di prezzi.