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 utilizzare la replica turbo, chiedi all'amministratore di concederti il ruolo IAM Amministratore archiviazione (roles/storage.admin
) nel bucket.
Questo ruolo predefinito contiene le autorizzazioni necessarie per utilizzare la replica turbo. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
storage.buckets.get
storage.buckets.update
storage.buckets.list
- Questa autorizzazione è obbligatoria solo se prevedi di utilizzare la console Google Cloud per eseguire le istruzioni riportate in questa pagina.
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Per istruzioni su come concedere i ruoli ai bucket, consulta Utilizzare IAM con i bucket.
Impostare la replica turbo
Per attivare o disattivare la replica turbo in un bucket esistente, segui queste istruzioni:
Console
- Nella console Google Cloud, vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket che ti interessa.
Fai clic sulla scheda Configuration (Configurazione).
Nella riga Replicazione, fai clic su
Modifica.La finestra visualizzata indica se stai per attivare la replica turbo o disattivare 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.
In caso di esito positivo, la risposta è simile alla seguente:
Updating gs://my-bucket/... Completed 1
Librerie client
C++
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
L'esempio seguente abilita la replica turbo su un bucket:
L'esempio seguente abilita la replica predefinita in un bucket:
C#
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C#.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
L'esempio seguente abilita la replica turbo su un bucket:
L'esempio seguente abilita la replica predefinita in un bucket:
Go
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
L'esempio seguente abilita la replica turbo su un bucket:
L'esempio seguente abilita la replica predefinita in un bucket:
Java
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
L'esempio seguente abilita la replica turbo su un bucket:
L'esempio seguente abilita la replica predefinita in un bucket:
Node.js
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
L'esempio seguente abilita la replica turbo su un bucket:
L'esempio seguente abilita la replica predefinita in un bucket:
PHP
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
L'esempio seguente abilita la replica turbo su un bucket:
L'esempio seguente abilita la replica predefinita in un bucket:
Python
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
L'esempio seguente abilita la replica turbo su un bucket:
L'esempio seguente abilita la replica predefinita in un bucket:
Ruby
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
L'esempio seguente abilita la replica turbo su un bucket:
L'esempio seguente abilita la replica predefinita in un bucket:
API REST
API JSON
Avere installato e inizializzatogcloud CLI, che consente di generare un token di accesso per l'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 che hai creato nel 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 sedile, segui le istruzioni riportate di seguito:
Console
- Nella console Google Cloud, vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket da verificare.
Fai clic sulla scheda Configuration (Configurazione).
Se la replica turbo è abilitata nel bucket, 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'operazione ha esito positivo, la risposta è simile al seguente esempio:
rpo: ASYNC_TURBO
Librerie client
C++
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
C#
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C#.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Go
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Java
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Node.js
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
PHP
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Python
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Ruby
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
API REST
API JSON
Avere installato e inizializzatogcloud CLI, che consente di generare un token di accesso per l'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" }
Nota la chiave
rpo
. Il valoreASYNC_TURBO
indica che la replica turbo è attivata.DEFAULT
indica che viene applicata la replica predefinita. Il camporpo
è sempre presente per i bucket a due e più regioni, ma non per i bucket a regione singola.
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 le metriche che monitorano il rendimento del bucket, incluso il rendimento della replica.
- Scopri come gli avvisi di Cloud Monitoring possono essere utilizzati per creare criteri di alterazione in base a metriche specificate e gestire le notifiche associate.