À propos des dossiers

Cloud Storage propose différentes façons d'organiser vos données, et les dossiers jouent un rôle important dans ce processus. Comprendre les différents types de dossiers disponibles peut vous aider à choisir celui qui répond le mieux à vos besoins spécifiques.

Cette page présente les différents types de dossiers dans Cloud Storage, en mettant l'accent sur leur fonctionnement dans les buckets lorsque l'espace de noms hiérarchique est activé.

Types de dossiers

Dans Cloud Storage, il existe trois principaux types de dossiers:

• Dossiers simulés: un bucket Cloud Storage typique organise les objets dans un espace de noms plat. À l'aide de la console Google Cloud et de la Google Cloud CLI, vous pouvez simuler des dossiers qui imitent l'arborescence de fichiers pour vous aider à organiser les données dans votre bucket. Pour en savoir plus sur les dossiers simulés, consultez la section Dossiers simulés.

• Dossiers: dans un bucket avec l'espace de noms hiérarchique activé, vous pouvez créer des dossiers réels contenant des objets ou d'autres dossiers. Vous pouvez également effectuer des opérations telles que renommer des dossiers et les lister. La structure hiérarchique et les opérations de gestion des dossiers améliorent les performances, la cohérence et la gestion des charges de travail orientées fichiers et gourmandes en données.

• Dossiers gérés: les dossiers gérés vous permettent d'appliquer des contrôles d'accès précis à vos objets, ce qui renforce la sécurité et le contrôle de vos données. Vous pouvez utiliser des dossiers gérés dans des buckets avec ou sans espace de noms hiérarchique activé. Pour en savoir plus sur les dossiers gérés, consultez la section Dossiers gérés.

Présentation des dossiers

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 selon une structure semblable à celle d'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 renommage et la liste des dossiers, ainsi que la récupération des métadonnées des dossiers.

Métadonnées de dossier

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

Les principaux composants 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 ressource. Pour un dossier, cette valeur est toujours storage#folder.
• name: nom du dossier. Exemple :dir1/
• selfLink: URL qui fait référence au dossier dans l'API Cloud Storage.
• timeCreated: code temporel de création du dossier. Exemple :2023-05-05T16:32:08.878000+00:00
• updated: code temporel de la dernière mise à jour du dossier. 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 avec des barres obliques au début ou à 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 relations 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 racine nommé dir1/. Le dossier racine est distinct du dossier de premier niveau.
  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//, un dossier enfant de dir1/.

• Profondeur de dossier maximale: les buckets avec l'espace de noms hiérarchique activé acceptent une profondeur de dossier maximale de 50. Par conséquent, les noms d'objets 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

• Créer et gérer des dossiers
• Renommer un dossier
• Optimisez la gestion des dossiers.