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 une classe de stockage par défaut Stockage standard et une durée de conservation de la suppression réversible de sept jours.
Rôles requis
Pour obtenir les autorisations requises pour créer un bucket Cloud Storage, 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. 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
Si vous créez un bucket pour la première fois, consultez Découvrir le stockage d'objets avec la console Google Cloud ou Découvrir le stockage d'objets avec l'outil Google Cloud CLI.
Pour créer des buckets avec des paramètres spécifiques ou des configurations avancées, 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. Après chacune de ces étapes, cliquez sur Continuer pour passer à l'étape suivante :
Dans la section Premiers pas, procédez comme suit :
- Saisissez un nom unique qui répond aux exigences de dénomination des buckets.
Pour activer l'espace de noms hiérarchique, cliquez sur la flèche d'expansion pour développer la section Optimiser pour les charges de travail orientées fichiers et à forte intensité de données, puis sélectionnez Activer l'espace de noms hiérarchique sur ce bucket.
Pour ajouter une étiquette de bucket, cliquez sur la flèche de développement pour développer la section Étiquettes, puis sur add_box Ajouter une étiquette et spécifiez un élément
key
etvalue
pour votre étiquette.
Dans la section Choisir l'emplacement de stockage de vos données, procédez comme suit :
Sélectionnez un type d'emplacement.
Utilisez le menu déroulant du type d'emplacement pour sélectionner un emplacement où les données d'objets de votre bucket seront stockées de manière permanente.
- Si vous sélectionnez le type d'emplacement birégional, vous pouvez également choisir d'activer la réplication turbo à l'aide de la case à cocher correspondante.
Pour configurer la réplication entre buckets, développez la section Configurer la réplication entre buckets, puis procédez comme suit:
Configurer la réplication entre buckets
- Cochez la case à côté de Ajouter une réplication entre buckets via le service de transfert de stockage.
- Dans le menu Bucket de destination, sélectionnez un bucket de destination.
Dans la section Paramètres de réplication, cliquez sur Configurer pour configurer les paramètres de la tâche de réplication.
Le volet Configurer la réplication entre buckets s'affiche.
- Pour filtrer les objets à répliquer par préfixe de nom d'objet, saisissez un préfixe avec lequel vous souhaitez inclure ou exclure des objets, puis cliquez sur Ajouter un préfixe.
- Pour définir une classe de stockage pour les objets répliqués, sélectionnez une classe de stockage dans le menu Classe de stockage. Si vous ignorez cette étape, les objets répliqués utiliseront la classe de stockage du bucket de destination par défaut.
- Cliquez sur OK.
Dans la section 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.
Dans la section 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 des accès pour les objets de votre bucket.
Dans la section Choisir comment protéger les données d'objet, procédez comme suit :
Sélectionnez l'une des options sous Protection des données que vous souhaitez définir pour votre bucket.
Pour choisir comment vos données d'objet seront chiffrées, cliquez sur la flèche d'expansion méthode de chiffrement des données.
intitulée Chiffrement des données, puis sélectionnez une
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
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Dans votre environnement de développement, exécutez la commande
gcloud storage buckets create
:gcloud storage buckets create gs://BUCKET_NAME --location=BUCKET_LOCATION
Où :
BUCKET_NAME
est le nom que vous souhaitez attribuer au bucket, ce nom étant soumis à des exigences de dénomination. Exemple:my-bucket
.BUCKET_LOCATION
est l'emplacement du bucket. Par exemple,us-east1
.
Si la requête aboutit, la commande renvoie le message suivant :
Creating gs://BUCKET_NAME/...
Définissez les options 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é. Exemple :my-project
--default-storage-class
: spécifiez la classe de stockage par défaut du bucket. Par exemple,STANDARD
.--uniform-bucket-level-access
: activez un accès uniforme au niveau du bucket pour votre bucket.
Exemple :
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_ID --default-storage-class=STORAGE_CLASS --location=BUCKET_LOCATION --uniform-bucket-level-access
Pour obtenir la liste complète des options de création de buckets avec gcloud CLI, consultez les options
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 la page Configurer l'authentification pour les 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 la page Configurer l'authentification pour les bibliothèques clientes.
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 la page Configurer l'authentification pour les bibliothèques clientes.
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 la page Configurer l'authentification pour les bibliothèques clientes.
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 la page Configurer l'authentification pour les bibliothèques clientes.
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 la page Configurer l'authentification pour les bibliothèques clientes.
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 la page Configurer l'authentification pour les bibliothèques clientes.
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 la page Configurer l'authentification pour les bibliothèques clientes.
Terraform
Vous pouvez utiliser une ressource Terraform pour créer un bucket de stockage.
API REST
API JSON
Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête
Authorization
.Créez un fichier JSON contenant les paramètres du bucket, qui doit inclure un
name
pour le bucket. Consultez la documentation Buckets:Insert pour obtenir la liste complète des paramètres. Les paramètres les plus courants sont les suivants :{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "iamConfiguration": { "uniformBucketLevelAccess": { "enabled": true }, } }
Où :
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
est 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,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_IDENTIFIER"
Où :
JSON_FILE_NAME
est le nom du fichier JSON que vous avez créé à l'étape 2.PROJECT_IDENTIFIER
est l'ID ou numéro du projet auquel le bucket sera associé. Exemple :my-project
.
API XML
Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête
Authorization
.Créez un fichier XML contenant les paramètres du bucket. Consultez la documentation XML: Créer un bucket pour obtenir la liste complète des paramètres. Les paramètres les plus courants sont les suivants :
<CreateBucketConfiguration> <StorageClass>STORAGE_CLASS</StorageClass> <LocationConstraint>BUCKET_LOCATION</LocationConstraint> </CreateBucketConfiguration>
Où :
STORAGE_CLASS
est la classe de stockage par défaut du bucket. Exemple:STANDARD
.BUCKET_LOCATION
est l'emplacement où vous souhaitez stocker les données d'objets du bucket. Par exemple,US-EAST1
.
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
est le nom du fichier XML que vous avez créé à l'étape 2.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
.
Si la requête a abouti, une réponse n'est pas renvoyée.
Étape suivante
- Répertoriez les buckets d'un projet.
- Découvrez les métadonnées associées à un bucket.
- Déplacez ou renommez un bucket.
- Supprimez un bucket.
- Importez un objet dans un bucket.
- Créez et configurez des buckets de manière déclarative avec Kubernetes Config Connector, qui vous permet de décrire les ressources Google Cloud à l'aide d'outils, d'API et de configurations Kubernetes. Pour en savoir plus, consultez la documentation de l'API Config Connector.
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 gratuits pour exécuter, tester et déployer des charges de travail.
Profiter d'un essai gratuit de Cloud Storage