Cette page explique comment créer des buckets avec l'espace de noms hiérarchique activé.
Créer un bucket
Cette section explique comment créer un bucket avec un espace de noms hiérarchique activé.
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, puis cliquez sur Continuer :
- 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.
Remarque : Vous ne pouvez pas activer l'espace de noms hiérarchique dans un bucket existant.
- Facultatif : Pour ajouter un libellé de bucket, cliquez sur la flèche de développement pour développer la section Libellés, puis cliquez sur add_box Ajouter un libellé, puis spécifiez un élément
key
et un élémentvalue
pour votre libellé. - Dans la section Choisir l'emplacement de stockage de vos données, procédez comme suit :
- Sélectionnez Région comme Type d'emplacement.
- Dans la liste Emplacement, sélectionnez la région dans laquelle les données du bucket seront stockées de manière permanente.
- Dans la section Choisir une classe de stockage pour vos données, sélectionnez Définir une classe par défaut pour le bucket.
Remarque : Le panneau 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.
- Dans la section Choisir comment contrôler l'accès aux objets, indiquez si votre bucket applique ou non la protection contre l'accès public, et pour Contrôle des accès, choisissez Uniforme.
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é.
- Dans la section Choisir comment protéger les données d'objet, procédez comme suit :
- Facultatif : Sélectionnez une méthode de protection des données. Vous pouvez par exemple configurer une règle de suppression réversible personnalisée, la gestion des versions des objets ou une règle de conservation.
- Pour sélectionner une méthode de chiffrement des données, cliquez sur la flèche d'expansion intitulée 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
-
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 --uniform-bucket-level-access --enable-hierarchical-namespace
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
.BUCKET_LOCATION
est l'emplacement du bucket. Par exemple,us-east1
.--uniform-bucket-level-access
: activez un accès uniforme au niveau du bucket pour votre bucket.
--enable-hierarchical-namespace
: activez l'espace de noms hiérarchique pour le bucket. Remarque : Vous ne pouvez pas activer l'espace de noms hiérarchique dans un bucket existant.
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
.
Pour obtenir la liste complète des options de création de buckets avec Google Cloud CLI, consultez les options
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
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.
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 : 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. Par exemple,STANDARD
.hierarchicalNamespace.enabled
est défini surTRUE
pour activer l'espace de noms hiérarchique pour votre bucket. Remarque : Vous ne pouvez pas activer l'espace de noms hiérarchique dans un bucket existant.uniformBucketLevelAccess.enabled
est défini surTRUE
pour activer l'accès uniforme au niveau du bucket pour votre bucket.
- 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 contenant les paramètres du bucket.PROJECT_IDENTIFIER
correspond à l'ID ou au numéro du projet auquel votre bucket sera associé. Exemple :my-project
{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "hierarchicalNamespace": { "enabled": "BOOLEAN" }, "iamConfiguration": { "uniformBucketLevelAccess": { "enabled": true }, }, }
Où :
Étape suivante
- Obtenez des informations sur les métadonnées d'un bucket.
- Obtenez des informations sur la structure de l'espace de stockage d'un bucket.
- Comprendre les dossiers
- Créer et gérer des dossiers
- Renommer des dossiers
- Répertorier et supprimer des buckets.
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