Cette page explique comment créer, lister, supprimer et obtenir les métadonnées des dossiers dans des buckets avec l'espace de noms hiérarchique activé.
Avant de commencer
Assurez-vous que l'espace de noms hiérarchique est activé pour votre bucket. Pour obtenir des instructions détaillées sur l'activation de l'espace de noms hiérarchique sur un bucket, consultez la section Créer des buckets avec l'espace de noms hiérarchique activé.
Créer un dossier
Cette section explique comment créer un dossier.
Rôles requis
Pour obtenir les autorisations requises pour créer des dossiers, demandez à votre administrateur de vous accorder le rôle IAM "Utilisateur d'objets Storage" (roles/storage.objectUser
) sur le bucket.
Ce rôle contient l'autorisation storage.folders.create
, qui est requise pour créer un dossier.
Pour savoir comment attribuer des rôles aux buckets, consultez la section Utiliser IAM avec des buckets.
Vous pouvez également obtenir cette autorisation avec d'autres rôles personnalisés ou rôles prédéfinis. Pour un rôle plus permissif qui vous permet de gérer des dossiers en plus de les créer, demandez à votre administrateur de vous attribuer l'un des rôles suivants:
- Administrateur de dossier de l'espace de stockage (
roles/storage.folderAdmin
) - Administrateur des objets de l'espace de stockage (
roles/storage.objectAdmin
) - Administrateur de l'espace de stockage (
roles/storage.admin
)
Pour connaître les rôles et les autorisations associées, consultez la page Rôles IAM pour Cloud Storage.
-
Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.
- Dans la liste des buckets, cliquez sur le nom du bucket dans lequel vous souhaitez créer le dossier.
- Sur la page Informations sur le bucket, cliquez sur Créer un dossier pour créer un dossier vide.
- Dans le champ Nom, saisissez un nom pour votre fichier. Pour plus d'informations sur les noms, consultez la section Considérations.
- Cliquez sur Créer.
Le dossier que vous venez de créer apparaît dans le volet Navigateur de dossiers.
-
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 folders create
:gcloud storage folders create --recursive gs://
BUCKET_NAME /FOLDER_NAME Où :
BUCKET_NAME
est le nom du bucket. Exemple :my-bucket
.FOLDER_NAME
correspond au nom du dossier que vous souhaitez créer. Exemple :my-folder/
Pour en savoir plus sur les noms de dossiers, consultez la documentation de présentation des dossiers.--recursive
est un indicateur qui crée automatiquement tous les dossiers parents inexistants avec le dossier. Ce paramètre est facultatif lorsque des dossiers parents existent déjà.
Si la requête aboutit, la commande renvoie le message suivant :
Completed 1/1
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.
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.
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.
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.
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.
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.
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.
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.
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 dossier, qui doit inclure un
name
pour le dossier. Consultez la documentation de la section Folders: Insert pour obtenir la liste complète des paramètres. Les paramètres suivants sont requis:{ "name": "
FOLDER_NAME ", }où FOLDER_NAME correspond au nom du dossier que vous souhaitez créer. Par exemple,
my-folder/
. Pour en savoir plus sur les noms de dossiers, consultez la documentation de présentation des dossiers. - 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/BUCKET_NAME /folders?recursive=true"Où :
JSON_FILE_NAME
est le nom du fichier JSON contenant les paramètres du dossier.BUCKET_NAME
correspond au nom du bucket dans lequel vous souhaitez créer le dossier.recursive
est défini sur "true" pour créer automatiquement tous les dossiers parent inexistants avec le dossier. Ce paramètre est facultatif lorsque des dossiers parents existent déjà.
Répertorier les dossiers
Cette section explique comment lister les dossiers.
Rôles requis
Pour obtenir les autorisations requises pour lister des dossiers, demandez à votre administrateur de vous accorder le rôle IAM "Lecteur des objets de l'espace de stockage" (roles/storage.objectViewer
) sur le bucket.
Ce rôle contient l'autorisation storage.folders.list
, qui est requise pour lister les dossiers.
Pour savoir comment attribuer des rôles aux buckets, consultez la section Utiliser IAM avec des buckets.
Vous pouvez également obtenir cette autorisation avec d'autres rôles personnalisés ou rôles prédéfinis. Pour un rôle plus permissif qui vous permet de gérer des dossiers en plus de répertorier des dossiers, demandez à votre administrateur de vous attribuer l'un des rôles suivants :
- Administrateur de dossier de l'espace de stockage (
roles/storage.folderAdmin
) - Administrateur des objets de l'espace de stockage (
roles/storage.objectAdmin
) - Utilisateur des objets de l'espace de stockage (
roles/storage.objectUser
) - Administrateur de l'espace de stockage (
roles/storage.admin
)
Pour connaître les rôles et les autorisations associées, consultez la page Rôles IAM pour Cloud Storage.
- Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.
Dans la liste des buckets, cliquez sur le nom du bucket dont vous souhaitez lister les dossiers.
Dans le volet Navigateur de dossiers, utilisez la flèche d'expansion
pour développer la liste des dossiers dans votre bucket.Une liste affiche les dossiers, les dossiers simulés et les dossiers gérés de votre bucket.
Pour répertorier tous les dossiers d'un bucket, exécutez la commande gcloud storage folders list
:
gcloud storage folders list gs://BUCKET_NAME /
Où :
BUCKET_NAME
correspond au nom du bucket contenant les dossiers gérés que vous souhaitez lister. Exemple :my-bucket
Voici un exemple de réponse réussie:
bucket: hns-bucket id: hns-bucket/A/ kind: storage#folder name: A/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/A timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' --- bucket: hns-bucket id: hns-bucket/B/ kind: storage#folder name: B/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/B timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' --- bucket: hns-bucket id: hns-bucket/B/D/ kind: storage#folder name: D/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/B/D timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' --- bucket: hns-bucket id: hns-bucket/C/ kind: storage#folder name: C/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/C timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' --- bucket: hns-bucket id: hns-bucket/C/E/ kind: storage#folder name: E/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/C/E timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' ...
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.
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.
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.
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.
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.
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.
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.
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.
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
.Utilisez
cURL
pour appeler l'API JSON avec une requête permettant de répertorier les dossiers:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/
BUCKET_NAME /folders"Où
BUCKET_NAME
correspond au nom du bucket contenant les dossiers gérés que vous souhaitez lister. Exemple :my-bucket
.
Supprimer un dossier
Cette section explique comment supprimer des dossiers.
Rôles requis
Pour obtenir les autorisations requises pour supprimer des dossiers, demandez à votre administrateur de vous accorder le rôle IAM "Utilisateur des objets de l'espace de stockage" (roles/storage.objectUser
) sur le bucket.
Ce rôle contient l'autorisation storage.folders.delete
, qui est requise pour supprimer un dossier.
Pour savoir comment attribuer des rôles aux buckets, consultez la section Utiliser IAM avec des buckets.
Vous pouvez également obtenir cette autorisation avec d'autres rôles personnalisés ou rôles prédéfinis. Pour un rôle plus permissif qui vous permet de gérer des dossiers en plus de les supprimer, demandez à votre administrateur de vous attribuer l'un des rôles suivants:
- Administrateur de dossier de l'espace de stockage (
roles/storage.folderAdmin
) - Administrateur des objets de l'espace de stockage (
roles/storage.objectAdmin
) - Administrateur de l'espace de stockage (
roles/storage.admin
)
Pour connaître les rôles et les autorisations associées, consultez la page Rôles IAM pour Cloud Storage.
- Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.
Dans la liste des buckets, cliquez sur le nom du bucket dont vous souhaitez supprimer les dossiers.
Dans le volet Navigateur de dossiers, utilisez la flèche d'expansion
pour développer la liste des dossiers dans votre bucket.Recherchez le dossier que vous souhaitez supprimer.
Cliquez sur le menu
Autres actions du dossier.Cliquez sur Supprimer le dossier.
Pour confirmer que vous souhaitez supprimer le dossier géré, saisissez
DELETE
dans le champ Supprimer.Cliquez sur Supprimer.
Le dossier et son contenu (y compris les objets stockés et les autres dossiers gérés), sont supprimés de votre bucket Cloud Storage.
Pour supprimer un dossier vide, exécutez la commande gcloud storage folders delete
:
gcloud storage folders delete gs://BUCKET_NAME /FOLDER_NAME
Où :
BUCKET_NAME
est le nom du bucket. Exemple :my-bucket
.FOLDER_NAME
correspond au nom du dossier que vous souhaitez supprimer. Exemple :my-folder/
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.
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.
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.
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.
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.
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.
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.
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.
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
.Utilisez
cURL
pour appeler l'API JSON avec une requêteDELETE
Dossier:curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/
BUCKET_NAME /folders/FOLDER_NAME "Où :
BUCKET_NAME
correspond au nom du bucket contenant le dossier géré que vous souhaitez supprimer. Exemple :my-bucket
.FOLDER_NAME
correspond au nom de l'objet encodé au format URL que vous souhaitez supprimer. Par exemple,my-folder/
, encodé au format URL :my-folder%2F
.
Obtenir les métadonnées d'un dossier
Cette section explique comment obtenir les métadonnées d'un dossier.
Rôles requis
Pour disposer des autorisations requises pour obtenir les métadonnées d'un dossier, demandez à votre administrateur de vous accorder le rôle IAM "Lecteur des objets Storage" (roles/storage.objectViewer
) sur le bucket.
Ce rôle contient l'autorisation storage.folders.get
, qui est requise pour obtenir les métadonnées d'un dossier.
Pour savoir comment attribuer des rôles aux buckets, consultez la section Utiliser IAM avec des buckets.
Vous pouvez également obtenir cette autorisation avec d'autres rôles personnalisés ou rôles prédéfinis. Pour un rôle plus permissif qui vous permet de gérer des dossiers en plus d'obtenir les métadonnées d'un dossier, demandez à votre administrateur de vous attribuer l'un des rôles suivants :
- Administrateur de dossier de l'espace de stockage (
roles/storage.folderAdmin
) - Administrateur des objets de l'espace de stockage (
roles/storage.objectAdmin
) - Utilisateur des objets de l'espace de stockage (
roles/storage.objectUser
) - Administrateur de l'espace de stockage (
roles/storage.admin
)
Pour connaître les rôles et les autorisations associées, consultez la page Rôles IAM pour Cloud Storage.
Pour obtenir les métadonnées d'un dossier, exécutez la commande gcloud storage folders describe
:
gcloud storage folders describe gs://BUCKET_NAME /FOLDER_NAME
Où :
BUCKET_NAME
correspond au nom du bucket contenant le dossier dont vous souhaitez récupérer les métadonnées. Exemple :my-bucket
FOLDER_NAME
est le nom du dossier dont vous souhaitez récupérer les métadonnées. Exemple :my-folder/
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.
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.
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.
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.
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.
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.
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.
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.
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
.Utilisez
cURL
pour appeler l'API JSON avec une requêteGET
Dossier:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/
BUCKET_NAME /folders/FOLDER_NAME "Où :
BUCKET_NAME
correspond au nom du bucket contenant le dossier dont vous souhaitez récupérer les métadonnées. Exemple :my-bucket
FOLDER_NAME
correspond au nom encodé en URL du dossier dont vous souhaitez récupérer les métadonnées. Par exemple,my-folder/
, encodé au format URL :my-folder%2F
.
Gérer l'accès à un dossier
Cette section explique comment gérer les accès à votre dossier en définissant des stratégies Identity and Access Management (IAM), afin d'obtenir un contrôle d'accès précis sur des groupes spécifiques d'objets dans un bucket.
Pour gérer l'accès à votre dossier, procédez comme suit:
Activez la gestion de votre dossier en créant un dossier géré portant le même nom que votre dossier existant. Pour obtenir des instructions détaillées, consultez la section Créer un dossier géré.
Étape suivante
- Renommer des dossiers
- Créez des buckets avec l'espace de noms hiérarchique activé.
- Utilisez un espace de noms hiérarchique pour les charges de travail Hadoop.
- Optimisez la gestion des dossiers.
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