Cette page montre comment créer des buckets Cloud Storage. 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.
Autorisations requises
Console
Pour suivre ce guide à l'aide de Google Cloud Console, vous devez disposer des autorisations IAM appropriées. Si vous n'avez pas créé le projet auquel vous souhaitez accéder, vous devrez peut-être demander au propriétaire du projet de vous attribuer un rôle contenant les autorisations nécessaires.
Pour obtenir la liste des autorisations requises pour des actions spécifiques, consultez la page Autorisations IAM pour Google Cloud Console.
Pour obtenir la liste des rôles pertinents, consultez la page Rôles Cloud Storage. Vous pouvez également créer un rôle personnalisé disposant d'autorisations limitées spécifiques.
Command line
Pour suivre ce guide à l'aide d'un utilitaire de ligne de commande, vous devez disposer des autorisations IAM appropriées. Si vous n'avez pas créé le projet auquel vous souhaitez accéder, vous devrez peut-être demander au propriétaire du projet de vous attribuer un rôle contenant les autorisations nécessaires.
Pour obtenir la liste des autorisations requises pour des actions spécifiques, consultez la page Autorisations IAM pour les commandes gsutil.
Pour obtenir la liste des rôles pertinents, consultez la page Rôles Cloud Storage. Vous pouvez également créer un rôle personnalisé disposant d'autorisations limitées spécifiques.
Bibliothèques clientes
Pour suivre ce guide à l'aide des bibliothèques clientes Cloud Storage, vous devez disposer des autorisations IAM appropriées. Si vous n'avez pas créé le projet auquel vous souhaitez accéder, vous devrez peut-être demander au propriétaire du projet de vous attribuer un rôle contenant les autorisations nécessaires.
Sauf indication contraire, les requêtes de bibliothèque cliente sont effectuées via l'API JSON et nécessitent des autorisations, comme indiqué dans la section Autorisations IAM pour les méthodes JSON. Pour savoir quelles méthodes d'API JSON sont appelées lorsque vous envoyez des requêtes à l'aide d'une bibliothèque cliente, consignez les requêtes brutes.
Pour obtenir la liste des rôles IAM pertinents, consultez la page Rôles Cloud Storage. Vous pouvez également créer un rôle personnalisé disposant d'autorisations limitées spécifiques.
API REST
API JSON
Pour suivre ce guide à l'aide de l'API JSON, vous devez disposer des autorisations IAM appropriées. Si vous n'avez pas créé le projet auquel vous souhaitez accéder, vous devrez peut-être demander au propriétaire du projet de vous attribuer un rôle contenant les autorisations nécessaires.
Pour obtenir la liste des autorisations requises pour des actions spécifiques, consultez la page Autorisations IAM pour les méthodes JSON.
Pour obtenir la liste des rôles pertinents, consultez la page Rôles Cloud Storage. Vous pouvez également créer un rôle personnalisé disposant d'autorisations limitées spécifiques.
Créer un nouveau bucket
Console
- Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.
- Cliquez sur Créer un bucket.
- 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, sélectionnez un Type d'emplacement et un Emplacement où les données du bucket seront stockées de manière permanente.
- Pour Choisir une classe de stockage pour vos données, sélectionnez une classe de stockage par défaut pour le bucket, ou bien classe automatique pour une gestion automatique des classes de stockage des données de votre bucket.
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.
- Pour le champ Choisir comment contrôler l'accès aux objets, indiquez si votre bucket s'applique ou non la protection contre l'accès public et sélectionnez un modèle de contrôle d'accès pour les objets de votre bucket.
Remarque : Si la protection contre l'accès public est déjà appliquée par la règle d'administration de votre projet, le bouton Empêcher l'accès public est verrouillé.
- Pour choisir comment protéger les données d'objet, configurez les outils de protection si vous le souhaitez, puis sélectionnez une méthode de chiffrement des données.
- 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
gcloud
Exécutez la commande gcloud storage buckets create
:
gcloud storage buckets create 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 :
--project
: spécifiez l'ID ou le numéro du projet auquel le bucket sera associé. Par exemple,my-project
.--default-storage-class
: spécifiez la classe de stockage par défaut du bucket. Exemple :NEARLINE
.--location
: spécifiez l'emplacement du bucket. Exemple :US-EAST1
.--uniform-bucket-level-access
: activez un accès uniforme au niveau du bucket pour votre bucket.
Pour obtenir la liste complète des options de création de buckets avec gcloud, consultez les options de buckets create
.
Exemple :
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_ID --default-storage-class=STORAGE_CLASS --location=BUCKET_LOCATION --uniform-bucket-level-access
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. 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 l'ID ou le numéro du projet auquel le bucket sera associé. Par exemple,my-project
.-c
: spécifiez la classe de stockage par défaut du bucket. Exemple :NEARLINE
.-l
: spécifiez l'emplacement du bucket. Exemple :US-EAST1
.-b
: spécifiez le paramètre d'accès uniforme au niveau du bucket pour votre bucket. Exemple :ON
.
Pour obtenir la liste complète des options de création de buckets gsutil, consultez la page Options Mo.
Exemple :
gsutil mb -p PROJECT_ID -c STORAGE_CLASS -l BUCKET_LOCATION -b on gs://BUCKET_NAME
Bibliothèques clientes
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.
Terraform
Vous pouvez utiliser une ressource Terraform pour créer un bucket de stockage.
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. Pour obtenir des instructions, consultez la page Authentification des API.
- Créez un fichier .json contenant les paramètres du bucket, qui doit inclure un
name
pour le bucket. 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 : BUCKET_NAME
correspond au nom que vous souhaitez attribuer au bucket, ce nom étant soumis à des exigences de dénomination. Exemple :my-bucket
BUCKET_LOCATION
correspond à l'emplacement où vous souhaitez stocker les données d'objets du bucket. Exemple :US-EAST1
STORAGE_CLASS
est la classe de stockage par défaut du bucket. 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_IDENTIFIER"
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_IDENTIFIER
correspond à l'ID ou au numéro du projet auquel le bucket sera associé. Exemple :my-project
{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "iamConfiguration": { "uniformBucketLevelAccess": { "enabled": true }, } }
Où :
API XML
- Obtenez un jeton d'autorisation d'accès sur la page OAuth 2.0 Playground. Configurez Playground pour utiliser vos propres identifiants OAuth. Pour obtenir des instructions, consultez la page Authentification des API.
- 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. Exemple :US-EAST1
STORAGE_CLASS
est la classe de stockage par défaut du bucket. 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é. Exemple :my-project
BUCKET_NAME
correspond au nom que vous souhaitez attribuer au bucket, ce nom étant soumis à des exigences de dénomination. 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 la taille et les métadonnées d'un bucket.
- Déplacez ou renommez un bucket.
- Supprimez un bucket.
- Importez un objet dans un bucket.
- Gérez la création et la configuration des buckets à l'aide de Config Connector pour Kubernetes.
Faites l'essai
Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de Cloud Storage en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits offerts pour exécuter, tester et déployer des charges de travail.
Profiter d'un essai gratuit de Cloud Storage