Cette page explique comment utiliser la fonctionnalité de réplication turbo sur un bucket birégional.
Rôles requis
Pour obtenir les autorisations requises pour utiliser la réplication turbo, demandez à votre administrateur de vous accorder le rôle IAM Administrateur de l'espace de stockage (roles/storage.admin
) sur le bucket.
Ce rôle prédéfini contient les autorisations requises pour utiliser la réplication turbo. Pour afficher les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
storage.buckets.get
storage.buckets.update
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.
Pour savoir comment attribuer des rôles aux buckets, consultez la section Utiliser IAM avec des buckets.
Définir la réplication turbo
Pour activer ou désactiver la réplication turbo sur un bucket existant, procédez comme suit :
Console
- Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.
Dans la liste des buckets, cliquez sur le nom du bucket souhaité.
Cliquez sur l'onglet Configuration.
Sur la ligne Réplication, cliquez sur Modifier
.La fenêtre qui s'affiche indique si vous êtes sur le point d'activer la réplication turbo ou de désactiver la réplication turbo.
Cliquez sur Enregistrer pour confirmer le nouveau paramètre.
Ligne de commande
Exécutez la commande gcloud storage buckets update
avec l'option --rpo
:
gcloud storage buckets update gs://BUCKET_NAME --rpo=STATE
Où :
BUCKET_NAME
correspond au nom du bucket concerné. Par exemple,my-bucket
.STATE
correspond àASYNC_TURBO
pour activer la réplication turbo ou àDEFAULT
pour la désactiver.
Si l'opération réussit, la réponse se présente comme suit :
Updating gs://my-bucket/... Completed 1
Bibliothèques clientes
C++
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C++.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
L'exemple suivant active la réplication turbo sur un bucket :
L'exemple suivant active la réplication par défaut sur un bucket :
C#
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C#.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
L'exemple suivant active la réplication turbo sur un bucket :
L'exemple suivant active la réplication par défaut sur un bucket :
Go
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Go.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
L'exemple suivant active la réplication turbo sur un bucket :
L'exemple suivant active la réplication par défaut sur un bucket :
Java
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Java.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
L'exemple suivant active la réplication turbo sur un bucket :
L'exemple suivant active la réplication par défaut sur un bucket :
Node.js
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Node.js.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
L'exemple suivant active la réplication turbo sur un bucket :
L'exemple suivant active la réplication par défaut sur un bucket :
PHP
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage PHP.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
L'exemple suivant active la réplication turbo sur un bucket :
L'exemple suivant active la réplication par défaut sur un bucket :
Python
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Python.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
L'exemple suivant active la réplication turbo sur un bucket :
L'exemple suivant active la réplication par défaut sur un bucket :
Ruby
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Ruby.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
L'exemple suivant active la réplication turbo sur un bucket :
L'exemple suivant active la réplication par défaut sur un bucket :
API REST
API JSON
Vous devez installer et initialiser gcloud CLI afin de générer un jeton d'accès pour l'en-tête
Authorization
.Vous pouvez également créer un jeton d'accès à l'aide d'OAuth 2.0 Playground et l'inclure dans l'en-tête
Authorization
.Créez un fichier JSON contenant les informations suivantes :
{ "rpo": "STATE" }
Où
STATE
correspond àASYNC_TURBO
pour activer la réplication turbo ou àDEFAULT
pour la désactiver.Exécutez
cURL
pour appeler l'API JSON avec une requête de bucketPATCH
: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"
Où :
JSON_FILE_NAME
correspond au chemin d'accès au fichier JSON que vous avez créé à l'étape 2.BUCKET_NAME
correspond au nom du bucket concerné. Exemple :my-bucket
Si la requête aboutit, aucune réponse n'est renvoyée.
API XML
Cette fonctionnalité ne peut pas être gérée via l'API XML. Utilisez plutôt l'API JSON.
Vérifier l'état de réplication d'un bucket
Pour vérifier l'objectif de point de récupération (RPO) ou l'état de réplication d'un bucket, procédez comme suit :
Console
- Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.
Dans la liste des buckets, cliquez sur le nom du bucket que vous souhaitez vérifier.
Cliquez sur l'onglet Configuration.
Si la réplication turbo est activée sur le bucket, la réplication est définie sur Turbo.
Ligne de commande
Exécutez la commande gcloud storage buckets describe
avec l'option --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(rpo)"
Où :
BUCKET_NAME
correspond au nom du bucket concerné. Par exemple,my-bucket
.
Si l'opération réussit, la réponse se présente comme suit :
rpo: ASYNC_TURBO
Bibliothèques clientes
C++
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C++.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
C#
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C#.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Go.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Java.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Node.js.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
PHP
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage PHP.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Python.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Ruby.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
API REST
API JSON
Vous devez installer et initialiser gcloud CLI afin de générer un jeton d'accès pour l'en-tête
Authorization
.Vous pouvez également créer un jeton d'accès à l'aide d'OAuth 2.0 Playground et l'inclure dans l'en-tête
Authorization
.Exécutez
cURL
pour appeler l'API JSON avec une requête de bucketGET
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"
Où
BUCKET_NAME
est le nom du bucket concerné. Exemple :my-bucket
La réponse est semblable à ceci :
{ "name": "my-bucket", "projectNumber": "234...", ... "rpo": "ASYNC_TURBO" }
Notez la clé
rpo
. La valeurASYNC_TURBO
indique que la réplication turbo est activée.DEFAULT
indique que la réplication par défaut est appliquée. Le champrpo
est toujours présent pour les buckets birégionaux et multirégionaux, mais pas pour les buckets à région unique.
API XML
Cette fonctionnalité ne peut pas être gérée via l'API XML. Utilisez plutôt l'API JSON.
Étapes suivantes
- En savoir plus sur la réplication turbo.
- En savoir plus sur les tarifs de la réplication turbo.
- Découvrez les métriques qui surveillent les performances de votre bucket, y compris les performances de réplication.
- Découvrez comment utiliser les alertes Cloud Monitoring pour créer des règles de modification basées sur des métriques spécifiées et gérer les notifications qui leur sont associées.