Cloud Storage-Buckets mit hierarchischem Namespace übertragen

Im hierarchischen Cloud Storage-Namespace werden Daten in einer logischen Dateisystemstruktur gespeichert und Objekte mithilfe von Ordnern organisiert. Weitere Informationen finden Sie unter Hierarchischer Namespace.

Der Storage Transfer Service kann zwischen Cloud Storage-Buckets mit hierarchischem Namensraum übertragen. Damit die Ordner und Ordnermetadaten erfolgreich übertragen werden können, müssen dem Storage Transfer-Dienst-Agent zusätzliche Berechtigungen gewährt werden.

Erforderliche Berechtigungen

Zusätzlich zu den Standardberechtigungen, die für eine Übertragung erforderlich sind, müssen dem Storage Transfer Service-Dienst-Agent die folgenden IAM-Berechtigungen gewährt werden.

Wenn die Quelle ein Bucket mit hierarchischem Namespace ist:

  • storage.folders.list für den Quell-Bucket. Diese Berechtigung ist in der Rolle „Storage Object Viewer“ (roles/storage.objectViewer) enthalten, die für alle Übertragungen erforderlich ist. Es ist keine zusätzliche Rolle erforderlich.

Wenn das Ziel ein Bucket mit hierarchischem Namespace ist:

  • storage.folders.create für den Ziel-Bucket Diese Berechtigung ist in der Rolle „Storage Object User“ (roles/storage.objectUser) enthalten. Weisen Sie diese Rolle zusätzlich zu den Rollen zu, die unter Berechtigungen für die agentenlose Übertragung aufgeführt sind.

Eine Anleitung zum Hinzufügen von Rollen zum Dienst-Agenten finden Sie unter:

Übertragungsverhalten

Bei der Übertragung zwischen zwei Buckets mit hierarchischem Namespace gilt Folgendes:

  • Objekte und Objektmetadaten werden übertragen.
  • Ordner und Ordnermetadaten werden übertragen.
  • Das Löschen von Ordnern an der Quelle oder Senke wird nicht unterstützt.

Bei der Übertragung von einem Bucket mit hierarchischem Namespace zu einem Bucket mit flachem Namespace gilt Folgendes:

  • Objekte und Objektmetadaten werden übertragen.
  • Ordner werden als Objektpräfixe übertragen. Beispiel: object1 in folderA wird als folderA/object1 an das Ziel übertragen.
  • Ordnermetadaten werden nicht übertragen.
  • Das Löschen von Ordnern an der Quelle wird nicht unterstützt.

Bei der Übertragung von einem Bucket mit flachem Namespace zu einem Bucket mit hierarchischem Namespace gilt Folgendes:

  • Objekte und Objektmetadaten werden übertragen.
  • Mit Objektpräfixen werden fehlende Ordner erstellt. Wenn Sie beispielsweise folderA/object1 übertragen, erstellt der Storage Transfer Service einen neuen Ordner namens folderA und überträgt object1 in diesen Ordner.
  • Das Löschen von Ordnern in der Senke wird nicht unterstützt.