À propos des dossiers dans les buckets avec l'espace de noms hiérarchique activé

Cette page fournit des informations sur les dossiers dans les buckets avec l'espace de noms hiérarchique activé.

Présentation

Les dossiers existent en tant que ressources dans les buckets avec l'espace de noms hiérarchique activé. Vous pouvez organiser les objets dans des dossiers dans une structure semblable à un système de fichiers. Cloud Storage fournit des API de gestion des dossiers qui permettent d'effectuer des opérations telles que la création, la suppression, le changement de nom et l'affichage de dossiers, ainsi que la récupération des métadonnées de dossiers.

Métadonnées des dossiers

Les métadonnées d'un dossier contiennent des informations structurées le concernant. Pour en savoir plus sur les métadonnées des dossiers, consultez la ressource Folder dans la documentation de référence de l'API Cloud Storage JSON.

Les composants clés des métadonnées d'un dossier sont les suivants :

  • bucket : nom du bucket dans lequel se trouve le dossier. Exemple :my-bucket
  • id : identifiant unique du dossier dans le bucket. Exemple :hns-bucket/dir1/
  • kind : type de la ressource. Pour un dossier, cette valeur est toujours storage#folder.
  • name : nom du dossier. Exemple :dir1/
  • selfLink : URL faisant référence au dossier dans l'API Cloud Storage.
  • timeCreated : code temporel de la création du dossier. Exemple :2023-05-05T16:32:08.878000+00:00
  • updated : code temporel de la dernière mise à jour de la ressource. Exemple :2024-05-06T16:32:08.878000+00:00

Remarques

Lorsque vous créez des dossiers, tenez compte des points suivants :

  • Noms d'objets et de dossiers : les buckets avec l'espace de noms hiérarchique activé acceptent tous les noms d'objets valides, y compris ceux qui comportent des barres obliques au début et à la fin (/) ou des barres obliques consécutives. Chaque barre oblique (/) dans un nom d'objet représente un dossier. Le tableau suivant présente des exemples de la relation entre les noms d'objets et leur emplacement correspondant dans la hiérarchie des dossiers :

    Nom de l'objet Emplacement dans la hiérarchie des dossiers
    foo.txt Chaque bucket inclut un dossier racine. L'objet foo.txt se trouve dans le dossier racine du bucket.
    dir1/foo.txt L'objet foo.txt se trouve dans un dossier de niveau supérieur nommé dir1/. Le dossier racine de niveau supérieur est distinct du dossier racine.
    dir1/ La barre oblique finale dans les noms d'objets tels que dir1/ indique que l'objet se trouve dans le dossier. Dans cet exemple, le nom de l'objet dir1/ est identique au nom du dossier parent dir1/.
    dir1//foo.txt L'objet foo.txt se trouve dans un dossier de deuxième niveau nommé dir1//, qui est un dossier enfant de dir1/.

  • Profondeur maximale des dossiers : les buckets avec l'espace de noms hiérarchique activé acceptent une profondeur maximale de 50 dossiers. Par conséquent, les noms d'objet ne peuvent pas comporter plus de 50 barres obliques (/).

  • Taille maximale du nom de dossier: 512 octets (encodés en UTF-8).

  • Création automatique de dossiers : la création d'un objet crée automatiquement tous les dossiers inexistants spécifiés dans le chemin d'accès de l'objet. Par exemple, la création d'un objet nommé dir1/foo.txt crée automatiquement le dossier dir1/ s'il n'existe pas déjà.

Étape suivante

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