Cette page explique comment utiliser le stockage birégional.
Rôles requis
Pour obtenir les autorisations requises pour créer un bucket birégional, demandez à votre administrateur de vous accorder le rôle IAM d'administrateur de l'espace de stockage (roles/storage.admin
) sur le projet.
Ce rôle prédéfini contient l'autorisation requise pour créer un bucket birégional. Pour afficher les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
storage.buckets.create
storage.buckets.enableObjectRetention
(obligatoire uniquement si vous activez des configurations de conservation d'objets pour le bucket)storage.buckets.list
(obligatoire uniquement si vous créez un bucket à l'aide de la console Google Cloud)resourcemanager.projects.get
(obligatoire uniquement si vous créez un bucket à l'aide de la console Google Cloud)
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis. Pour connaître les rôles et les autorisations associées, consultez la page Rôles IAM pour Cloud Storage.
Pour savoir comment attribuer des rôles aux projets, consultez la page Gérer l'accès aux projets.
Créer un bucket birégional
Pour créer un bucket birégional, procédez comme suit :
Console
- Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.
Cliquez sur Créer.
Sur la page Créer un bucket, saisissez les informations concernant votre bucket. Pour passer à l'étape suivante, cliquez sur Continuer.
Dans le champ Attribuer un nom au bucket, saisissez un nom qui répond aux exigences de dénomination des buckets.
Dans le champ Choisir l'emplacement de stockage de vos données, à côté de Type d'emplacement, choisissezEmplacement birégional. Facultatif : vous pouvez combiner la fonctionnalité avec la réplication turbo en cochant la case Ajouter une réplication turbo.
Dans le champ Emplacement, sélectionnez le Continent et les Régions associées que vous souhaitez utiliser.
Pour Choisir une classe de stockage par défaut pour vos données, sélectionnez une classe de stockage pour le bucket. La classe de stockage par défaut est attribuée par défaut à tous les objets importés dans le bucket.
Dans le champ Choisir comment contrôler l'accès aux objets, sélectionnez les options de prévention de l'accès public et de contrôle des accès que vous souhaitez utiliser.
Pour Choisir comment protéger les données d'objet, sélectionnez les outils de protection que vous souhaitez utiliser, tels que la gestion des versions des objets, une règle de conservation et une méthode de chiffrement.
Cliquez sur Créer.
Pour savoir comment obtenir des informations détaillées sur les erreurs liées aux opérations Cloud Storage ayant échoué dans la console Google Cloud, consultez la section Dépannage.
Ligne de commande
Exécutez la commande buckets create
avec les options --location
et --placement
:
gcloud storage buckets create gs://BUCKET_NAME --location=MULTI-REGION --placement=REGION_1,REGION_2
Où :
BUCKET_NAME
correspond au nom du bucket en cours de création. Par exemple,my-bucket
.MULTI-REGION
spécifie le code multirégional associé aux régions sous-jacentes. Par exemple, lorsque vous choisissez les régionsASIA-SOUTH1
(Mumbai) etASIA-SOUTH2
(Delhi), utilisezIN
.REGION_1
spécifie l'emplacement géographique d'une région pour votre bucket. Par exemple,ASIA-EAST1
.REGION_2
spécifie l'emplacement géographique d'une deuxième région pour le bucket. Par exemple,ASIA-SOUTHEAST1
.
Si la requête aboutit, la commande renvoie le message suivant :
Creating gs://BUCKET_NAME/...
Afin d'obtenir la liste complète des options disponibles pour la création de buckets avec gcloud storage
, consultez la section Options pour buckets create
.
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
.Créez un fichier JSON contenant les paramètres du bucket, qui doit inclure un
name
et unlocation
. Consultez la documentation de la section Buckets:Insert pour obtenir la liste complète des paramètres. Les paramètres les plus courants sont les suivants :{ "name": "BUCKET_NAME", "location": "MULTI-REGION", "customPlacementConfig": { "dataLocations": ["REGION_1", "REGION_2"] }, "storageClass": "STORAGE_CLASS" }
Où :
BUCKET_NAME
correspond au nom que vous souhaitez attribuer au bucket, ce nom étant soumis à des exigences de dénomination. Exemple :my-bucket
.MULTI-REGION
spécifie le code multirégional associé aux régions sous-jacentes. Par exemple, lorsque vous choisissez les régionsASIA-SOUTH1
(Mumbai) etASIA-SOUTH2
(Delhi), utilisezIN
.REGION_1
etREGION_2
sont les régions dans lesquelles vous souhaitez stocker les données d'objets du bucket. Par exemple,ASIA-EAST1
etASIA-SOUTHEAST1
.STORAGE_CLASS
est la classe de stockage par défaut de votre bucket. Exemple :STANDARD
.
Utilisez
cURL
pour appeler l'API JSON :curl -X POST --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?project=PROJECT_ID"
Où :
JSON_FILE_NAME
correspond au nom du fichier JSON que vous avez créé à l'étape 2.PROJECT_ID
correspond à l'ID du projet auquel le bucket sera associé. Par exemple,my-project
.
API XML
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 XML contenant les informations suivantes :
<CreateBucketConfiguration> <LocationConstraint>MULTI-REGION</LocationConstraint> <CustomPlacementConfig> <DataLocations> <DataLocation>REGION_1</DataLocation> <DataLocation>REGION_2</DataLocation> </DataLocations> </CustomPlacementConfig> <StorageClass>STORAGE_CLASS</StorageClass> </CreateBucketConfiguration>
Où :
MULTI-REGION
spécifie le code multirégional associé aux régions sous-jacentes. Par exemple, lorsque vous choisissez les régionsASIA-SOUTH1
(Mumbai) etASIA-SOUTH2
(Delhi), utilisezIN
.REGION_1
etREGION_2
sont les régions dans lesquelles vous souhaitez stocker les données d'objets du bucket. Par exemple,ASIA-EAST1
etASIA-SOUTHEAST1
.STORAGE_CLASS
est la classe de stockage par défaut du bucket. Exemple :STANDARD
.
Utilisez
cURL
pour appeler l'API XML :curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "x-goog-project-id: PROJECT_ID" \ "https://storage.googleapis.com/BUCKET_NAME"
Où :
XML_FILE_NAME
correspond au nom du fichier XML que vous avez créé à l'étape 2 ;PROJECT_ID
correspond à l'ID du projet auquel le bucket sera associé. Par exemple,my-project
.BUCKET_NAME
correspond au nom que vous souhaitez attribuer au bucket, ce nom étant soumis à des exigences de dénomination des buckets. Exemple :my-bucket
.
Si la requête inclut des régions non compatibles, un message d'erreur est renvoyé. Si la requête a abouti, une réponse n'est pas renvoyée.
Étapes suivantes
- En savoir plus sur la réplication turbo.
- Récupérez les métadonnées d'un bucket, y compris l'association de régions utilisée par un bucket birégional.
- Apprenez-en plus sur les tarifs de la réplication turbo ou consultez un exemple de tarification.