Cloud Storage-Buckets mit hierarchischem Namespace übertragen

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

Mit dem Storage Transfer Service können Daten in und aus Cloud Storage-Buckets mit hierarchischem Namespace übertragen werden. Damit die Ordner und Ordner-Metadaten übertragen werden können, müssen dem Storage Transfer Service-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 erteilt 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-Agent finden Sie hier:

Übertragungsverhalten

Beim Übertragen zwischen zwei Buckets mit hierarchischem Namespace gilt Folgendes:

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

Beim Übertragen von einem Bucket mit hierarchischem Namespace in einen 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.
  • Ordner-Metadaten werden nicht übertragen.
  • Das Löschen von Ordnern in der Quelle wird nicht unterstützt.

Beim Übertragen von einem Bucket mit flachem Namespace in einen Bucket mit hierarchischem Namespace gilt Folgendes:

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