In questa pagina viene descritto come utilizzare la funzionalità di replica turbo su un bucket a due regioni.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per l'utilizzo della replica turbo, chiedi all'amministratore di concederti il ruolo IAM Amministratore Storage (roles/storage.admin
) nel bucket.
Questo ruolo predefinito contiene le autorizzazioni necessarie per utilizzare la replica turbo. Per visualizzare esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.buckets.get
storage.buckets.update
Potresti anche riuscire a ottenere queste autorizzazioni con i ruoli personalizzati o altri ruoli predefiniti.
Per istruzioni sulla concessione dei ruoli sui bucket, consulta Utilizzare IAM con i bucket.
Imposta replica turbo
Per abilitare o disabilitare la replica turbo su 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 che ti interessa.
Fai clic sulla scheda Configurazione.
Nella riga Replication (Replica), fai clic su
Edit (Modifica).La finestra visualizzata indica se stai per abilitare la replica turbo o disabilitare la replica turbo.
Fai clic su Salva per confermare la nuova impostazione.
Riga di comando
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 attivare la replica turbo oDEFAULT
per disattivarla.
Se l'esito è positivo, la risposta sarà simile a:
Updating gs://my-bucket/... Completed 1
Librerie client
C++
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita la replica turbo su un bucket:
Il seguente esempio abilita la replica predefinita su un bucket:
C#
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita la replica turbo su un bucket:
Il seguente esempio abilita la replica predefinita su un bucket:
Go
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita la replica turbo su un bucket:
Il seguente esempio abilita la replica predefinita su un bucket:
Java
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita la replica turbo su un bucket:
Il seguente esempio abilita la replica predefinita su un bucket:
Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita la replica turbo su un bucket:
Il seguente esempio abilita la replica predefinita su un bucket:
PHP
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita la replica turbo su un bucket:
Il seguente esempio abilita la replica predefinita su un bucket:
Python
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita la replica turbo su un bucket:
Il seguente esempio abilita la replica predefinita su un bucket:
Ruby
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita la replica turbo su un bucket:
Il seguente esempio abilita la replica predefinita su un bucket:
API REST
API JSON
Installa e inizializzatogcloud CLI per 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 seguenti informazioni:
{ "rpo": "STATE" }
Dove
STATE
èASYNC_TURBO
per attivare la replica turbo oDEFAULT
per disattivarla.Utilizza
cURL
per chiamare l'API JSON con una richiestaPATCH
bucket:curl -X PATCH --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/BUCKET_NAME?fields=rpo"
Dove:
JSON_FILE_NAME
è il percorso del file JSON creato al passaggio 2.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. Utilizza invece l'API JSON.
Controllare lo stato di replica di un bucket
Per controllare l'RPO (Recovery Point Objective) o lo stato di 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 da verificare.
Fai clic sulla scheda Configurazione.
Se la replica turbo è abilitata nel bucket, l'opzione Replica è impostata su Turbo.
Riga di comando
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
.
Se l'esito è positivo, la risposta è simile al seguente esempio:
rpo: ASYNC_TURBO
Librerie client
C++
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
C#
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
API REST
API JSON
Installa e inizializzatogcloud CLI per 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
.Utilizza
cURL
per chiamare l'API JSON con una richiestaGET
Bucket:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"
Dove
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.La risposta è simile al seguente esempio:
{ "name": "my-bucket", "projectNumber": "234...", ... "rpo": "ASYNC_TURBO" }
Osserva 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ù regioni, ma non è presente nei bucket a singola regione.
API XML
Questa funzionalità non può essere gestita tramite l'API XML. Utilizza invece l'API JSON.
Passaggi successivi
- Scopri di più sulla replica turbo.
- Scopri di più sui prezzi della replica turbo.
- Scopri di più sulle metriche che monitorano le prestazioni del bucket, incluse le prestazioni di replica.
- Scopri come utilizzare gli avvisi di Cloud Monitoring per creare criteri di modifica in base a metriche specificate e gestire le notifiche associate.