In questa pagina viene descritto come utilizzare la funzionalità di replica turbo in un bucket a doppia area geografica.
Autorizzazioni obbligatorie
Console
Per completare questa guida utilizzando la console Google Cloud, devi disporre delle autorizzazioni IAM appropriate. Per utilizzare questa funzionalità, devi avere o intendi creare un bucket in una località a doppia area geografica. Se il bucket a cui vuoi accedere esiste in un progetto che non hai creato, potresti aver bisogno che il proprietario del progetto ti assegni un ruolo contenente le autorizzazioni necessarie.
Per un elenco delle autorizzazioni necessarie per azioni specifiche, consulta Autorizzazioni IAM per la console Google Cloud.
Per un elenco dei ruoli pertinenti, consulta Ruoli 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 intendi creare un bucket in una località a doppia area geografica. Se il bucket a cui vuoi accedere esiste in un progetto che non hai creato, potresti aver bisogno che il proprietario del progetto ti assegni un ruolo contenente le autorizzazioni necessarie.
Per un elenco delle autorizzazioni necessarie per azioni specifiche, consulta Autorizzazioni IAM per i comandi gsutil.
Per un elenco dei ruoli pertinenti, consulta Ruoli Cloud Storage. In alternativa, puoi creare un ruolo personalizzato con autorizzazioni specifiche e limitate.
Librerie client
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 regione. Se il bucket a cui vuoi accedere esiste in un progetto che non hai creato, potresti aver bisogno che il proprietario del progetto ti assegni un ruolo contenente le autorizzazioni necessarie.
Se non diversamente specificato, le richieste della libreria client vengono effettuate tramite l'API JSON e richiedono le autorizzazioni elencate nelle autorizzazioni IAM per i metodi JSON. Per vedere quali metodi dell'API JSON vengono richiamati quando effettui richieste utilizzando una libreria client, registra le richieste non elaborate.
Per un elenco di ruoli IAM pertinenti, consulta i ruoli 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 intendi creare un bucket in una località a doppia area geografica. Se il bucket a cui vuoi accedere esiste in un progetto che non hai creato, potresti aver bisogno che il proprietario del progetto ti assegni un ruolo contenente le autorizzazioni necessarie.
Per un elenco delle autorizzazioni necessarie per azioni specifiche, consulta la pagina relativa alle autorizzazioni IAM per i metodi JSON.
Per un elenco dei ruoli pertinenti, consulta Ruoli 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.
Imposta replica turbo
Per abilitare o disabilitare la replica turbo in un bucket esistente, segui queste istruzioni:
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket desiderato.
Fai clic sulla scheda Configuration (Configurazione).
Nella riga Replica, 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
gcloud
Utilizza il comando gcloud storage buckets update
con il flag --rpo
:
gcloud storage buckets update gs://BUCKET_NAME --rpo=STATE
Dove:
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.STATE
èASYNC_TURBO
per abilitare la replica turbo oDEFAULT
per disabilitare la replica turbo.
Se l'operazione ha esito positivo, la risposta avrà il seguente aspetto:
Updating gs://my-bucket/... Completed 1
gsutil
Utilizza il comando gsutil rpo set
:
gsutil rpo set STATE gs://BUCKET_NAME/
Dove:
STATE
èASYNC_TURBO
per abilitare la replica turbo oDEFAULT
per disabilitare la 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 entra in vigore immediatamente.
Librerie client
C++
Per ulteriori informazioni, consulta la documentazione di riferimento per l'API Cloud Storage C++.
Il seguente esempio abilita la replica turbo su un bucket:
L'esempio seguente abilita la replica predefinita su un bucket:
C#
Per ulteriori informazioni, consulta la documentazione di riferimento per l'API Cloud Storage C#.
Il seguente esempio abilita la replica turbo su un bucket:
L'esempio seguente abilita la replica predefinita su un bucket:
Go
Per ulteriori informazioni, consulta la documentazione di riferimento per l'API Cloud Storage Go.
Il seguente esempio abilita la replica turbo su un bucket:
L'esempio seguente abilita la replica predefinita su un bucket:
Java
Per ulteriori informazioni, consulta la documentazione di riferimento per l'API Cloud Storage Java.
Il seguente esempio abilita la replica turbo su un bucket:
L'esempio seguente abilita la replica predefinita su un bucket:
Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento per l'API Cloud Storage Node.js.
Il seguente esempio abilita la replica turbo su un bucket:
L'esempio seguente abilita la replica predefinita su un bucket:
PHP
Per ulteriori informazioni, consulta la documentazione di riferimento per l'API Cloud Storage PHP.
Il seguente esempio abilita la replica turbo su un bucket:
L'esempio seguente abilita la replica predefinita su un bucket:
Python
Per ulteriori informazioni, consulta la documentazione di riferimento per l'API Cloud Storage Python.
Il seguente esempio abilita la replica turbo su un bucket:
L'esempio seguente abilita la replica predefinita su un bucket:
Ruby
Per ulteriori informazioni, consulta la documentazione di riferimento per l'API Cloud Storage Ruby.
Il seguente esempio abilita la replica turbo su un bucket:
L'esempio seguente abilita la replica predefinita su un bucket:
API REST
API JSON
- Richiedi un token di accesso all'autorizzazione da Playground OAuth 2.0. Configura il parco giochi in modo che utilizzi le tue credenziali OAuth. Per le istruzioni, consulta Autenticazione API.
Crea un file JSON contenente le seguenti informazioni:
{ "rpo": "STATE" }
Dove
STATE
èASYNC_TURBO
per abilitare la replica turbo oDEFAULT
per disabilitare la replica turbo.Usa
cURL
per chiamare l'API JSON con unaPATCH
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.
Controlla lo stato di replica di un bucket
Per controllare l'RPO (Recovery Point Objective) o lo stato della replica di un bucket, segui queste istruzioni:
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket che vuoi verificare.
Fai clic sulla scheda Configuration (Configurazione).
Se la replica turbo è abilitata nel bucket, la replica è impostata su Turbo.
Riga di comando
gcloud
Utilizza il comando gcloud storage buckets describe
con il flag --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(rpo)"
Dove:
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
In caso di esito positivo, la risposta avrà il seguente esempio:
rpo: ASYNC_TURBO
gsutil
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 avrà il seguente esempio:
gs://my-bucket: ASYNC_TURBO
Librerie client
C++
Per ulteriori informazioni, consulta la documentazione di riferimento per l'API Cloud Storage C++.
C#
Per ulteriori informazioni, consulta la documentazione di riferimento per l'API Cloud Storage C#.
Go
Per ulteriori informazioni, consulta la documentazione di riferimento per l'API Cloud Storage Go.
Java
Per ulteriori informazioni, consulta la documentazione di riferimento per l'API Cloud Storage Java.
Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento per l'API Cloud Storage Node.js.
PHP
Per ulteriori informazioni, consulta la documentazione di riferimento per l'API Cloud Storage PHP.
Python
Per ulteriori informazioni, consulta la documentazione di riferimento per l'API Cloud Storage Python.
Ruby
Per ulteriori informazioni, consulta la documentazione di riferimento per l'API Cloud Storage Ruby.
API REST
API JSON
- Richiedi un token di accesso all'autorizzazione da Playground OAuth 2.0. Configura il parco giochi in modo che utilizzi le tue credenziali OAuth. Per le istruzioni, consulta Autenticazione API.
Usa
cURL
per chiamare l'API JSON con una richiestaGET
Bucket: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 che hai generato nel passaggio 1.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
La risposta sarà simile all'esempio seguente:
{ "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 doppia e in 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.
Monitora le prestazioni di replica turbo di un bucket
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket desiderato.
Fai clic sulla scheda Configuration (Configurazione).
Nella riga Replica, fai clic su Visualizza metriche di replica.
Se la replica di un oggetto richiede più di 15 minuti, i minuti supplementari vengono aggregati e visualizzati nella console Google Cloud come Numero di minuti mancanti RPO. La console Google Cloud monitora anche il numero di repliche di oggetti completate, mostrate come repliche di oggetti con turbo.
Per saperne di più, consulta Monitoraggio delle prestazioni della replica Turbo.
Passaggi successivi
- Scopri di più sulla replica turbo.
- Scopri di più sui prezzi della replica turbo o consulta un esempio di prezzi.