Transférer des buckets avec espace de noms hiérarchique Cloud Storage

L'espace de noms hiérarchique Cloud Storage stocke les données dans une structure de système de fichiers logique, en utilisant des dossiers pour organiser les objets. Pour en savoir plus, consultez Espace de noms hiérarchique.

Le service de transfert de stockage peut transférer des données vers et depuis des buckets Cloud Storage qui utilisent un espace de noms hiérarchique. Pour transférer correctement les dossiers et les métadonnées de dossiers, des autorisations supplémentaires doivent être accordées à l'agent de service service de transfert de stockage.

Autorisations requises

En plus des autorisations standards requises pour un transfert, les autorisations IAM suivantes doivent être accordées à l'agent de service service de transfert de stockage.

Lorsque la source est un bucket avec espace de noms hiérarchique :

  • storage.folders.list sur le bucket source. Cette autorisation est incluse dans le rôle Lecteur d'objets Storage (roles/storage.objectViewer), qui est obligatoire pour tous les transferts. Aucun rôle supplémentaire n'est requis.

Lorsque la destination est un bucket avec espace de noms hiérarchique :

  • storage.folders.create sur le bucket de destination Cette autorisation est incluse dans le rôle Utilisateur des objets Storage (roles/storage.objectUser). Accordez ce rôle en plus de ceux listés dans Autorisations de transfert sans agent.

Pour savoir comment ajouter des rôles à l'agent de service, consultez les pages suivantes :

Comportement de transfert

Lorsque vous transférez des données entre deux buckets avec espace de noms hiérarchique :

  • Les objets et leurs métadonnées sont transférés.
  • Les dossiers et les métadonnées des dossiers sont transférés.
  • La suppression de dossiers au niveau de la source ou du récepteur n'est pas acceptée.

Lorsque vous transférez des données d'un bucket avec espace de noms hiérarchique vers un bucket avec espace de noms plat :

  • Les objets et leurs métadonnées sont transférés.
  • Les dossiers sont transférés en tant que préfixes d'objet. Par exemple, object1 dans folderA est transféré vers la destination en tant que folderA/object1.
  • Les métadonnées des dossiers ne sont pas transférées.
  • La suppression de dossiers à la source n'est pas acceptée.

Lorsque vous transférez des données d'un bucket avec espace de noms plat vers un bucket avec espace de noms hiérarchique :

  • Les objets et leurs métadonnées sont transférés.
  • Les préfixes d'objet sont utilisés pour créer les dossiers manquants. Par exemple, lors du transfert de folderA/object1, le service de transfert de stockage crée un dossier nommé folderA et y transfère object1.
  • La suppression de dossiers au niveau du récepteur n'est pas acceptée.