Cette page montre comment créer des buckets Cloud Storage. Pour obtenir une présentation des buckets, consultez la page Mots clés. Sauf indication contraire dans votre requête, les buckets sont créés dans l'emplacement multirégional US
avec la classe de stockage par défaut stockage standard.
Pour créer un bucket de stockage, procédez comme suit :
Console
- Ouvrez le navigateur Cloud Storage dans Google Cloud Console.
Ouvrir le navigateur Cloud Storage - Cliquez sur Create a bucket (Créer un bucket) pour ouvrir le formulaire de création de bucket.
- Saisissez les informations sur votre bucket et cliquez sur Continue (Continuer) à chaque étape :
- Renseignez le champ Name (Nom) conformément aux exigences concernant les noms de buckets.
- Sélectionnez la Default storage class (classe de stockage par défaut) du bucket. Cette classe de stockage par défaut sera attribuée par défaut à tous les objets importés dans le bucket. Ensuite, sélectionnez l'emplacement (Location) où les données du bucket seront stockées de manière permanente.
Remarque : Le panneau Monthly cost estimate (Estimation du coût mensuel) du volet de droite donne une estimation des coûts mensuels du bucket en fonction de la classe de stockage et de l'emplacement sélectionnés, ainsi que des opérations et du volume de données attendus.
- Sélectionnez un modèle Access control (modèle de contrôle des accès) pour déterminer comment contrôler l'accès aux objets du bucket.
- Vous pouvez également ajouter des étiquettes de buckets, définir une règle de conservation et choisir une méthode de chiffrement.
- Cliquez sur Done (OK).
Consultez la page Dépannage pour obtenir des informations détaillées sur les erreurs liées aux opérations ayant échoué dans le navigateur Cloud Storage.
gsutil
Exécutez la commande gsutil mb
:
gsutil mb gs://BUCKET_NAME
Où :
BUCKET_NAME
correspond au nom que vous souhaitez attribuer au bucket, ce nom étant soumis à des exigences de dénomination. Par exemple,my-bucket
.
Si la requête aboutit, la commande renvoie le message suivant :
Creating gs://BUCKET_NAME/...
Définissez les options facultatives suivantes pour mieux contrôler la création du bucket :
-p
: spécifiez le projet auquel le bucket sera associé. Par exemple,my-project
.-c
: spécifiez la classe de stockage par défaut du bucket. Par exemple,NEARLINE
.-l
: spécifiez l'emplacement du bucket. Par exemple,US-EAST1
.-b
: activez un accès uniforme au niveau du bucket pour votre bucket.
Exemple :
gsutil mb -p PROJECT_ID -c STORAGE_CLASS -l BUCKET_LOCATION -b on gs://BUCKET_NAME
Exemples de code
C++
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C++.
C#
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C#.
Go
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Go.
Java
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Java.
Node.js
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Node.js.
PHP
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage PHP.
Python
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Python.
Ruby
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Ruby.
API REST
API JSON
- Obtenez un jeton d'autorisation d'accès sur la page OAuth 2.0 Playground. Configurez Playground pour utiliser vos propres identifiants OAuth.
- Créez un fichier .json contenant les informations suivantes :
BUCKET_NAME
correspond au nom que vous souhaitez attribuer au bucket, ce nom étant soumis à des exigences de dénomination. Par exemple,my-bucket
.BUCKET_LOCATION
correspond à l'emplacement où vous souhaitez stocker les données d'objets du bucket. Par exemple,US-EAST1
.STORAGE_CLASS
est la classe de stockage par défaut du bucket. Par exemple,NEARLINE
.- Utilisez
cURL
pour appeler l'API JSON :curl -X POST --data-binary @JSON_FILE_NAME.json \ -H "Authorization: Bearer OAUTH2_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.OAUTH2_TOKEN
correspond au jeton d'accès que vous avez généré à l'étape 1.PROJECT_ID
correspond à l'ID du projet auquel le bucket sera associé. Par exemple,my-project
.
{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS" }
Où :
API XML
- Obtenez un jeton d'autorisation d'accès sur la page OAuth 2.0 Playground. Configurez Playground de façon à utiliser vos propres identifiants OAuth.
- Créez un fichier .xml contenant les informations suivantes :
BUCKET_LOCATION
correspond à l'emplacement où vous souhaitez stocker les données d'objets du bucket. Par exemple,US-EAST1
.STORAGE_CLASS
est la classe de stockage par défaut du bucket. Par exemple,NEARLINE
.- Utilisez
cURL
pour appeler l'API XML :curl -X PUT --data-binary @XML_FILE_NAME.xml \ -H "Authorization: Bearer OAUTH2_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.OAUTH2_TOKEN
correspond au jeton d'accès que vous avez généré à l'étape 1.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. Par exemple,my-bucket
.
<CreateBucketConfiguration> <LocationConstraint>BUCKET_LOCATION</LocationConstraint> <StorageClass>STORAGE_CLASS</StorageClass> </CreateBucketConfiguration>
Où :
Étapes suivantes
- Répertoriez les buckets d'un projet.
- Obtenez des informations sur les buckets.
- Déplacez ou renommez un bucket.
- Supprimez un bucket.
- Importez un objet dans un bucket.
- Découvrez les concepts de base liés à l'utilisation de Cloud Storage avec Google Cloud Console.