Im hierarchischen Namespace von Cloud Storage werden Daten in einer logischen Dateisystemstruktur gespeichert. Objekte werden dabei in Ordnern organisiert. Weitere Informationen finden Sie unter Hierarchischer Namespace.
Storage Transfer Service kann Daten in und aus Cloud Storage-Buckets übertragen, die einen hierarchischen Namespace verwenden. Damit die Ordner und Ordnermetadaten erfolgreich ü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 gewährt werden.
Wenn die Quelle ein Bucket mit hierarchischem Namespace ist:
storage.folders.listfür den Quell-Bucket. Diese Berechtigung ist in der Rolle „Storage Object Viewer“ (roles/storage.objectViewer) enthalten, die für den Quell-Bucket erforderlich ist. Es ist keine zusätzliche Rolle erforderlich.
Wenn das Ziel ein Bucket mit hierarchischem Namespace ist:
storage.folders.createfür den Ziel-Bucket Diese Berechtigung ist in der Rolle „Storage-Objekt-Nutzer“ (roles/storage.objectUser) enthalten, die für den Ziel-Bucket erforderlich ist. Es ist keine zusätzliche Rolle erforderlich.
Eine Anleitung zum Hinzufügen von Rollen zum Dienst-Agent finden Sie hier:
- Zugriff auf eine Quelle konfigurieren: Cloud Storage
- Zugriff auf eine Senke konfigurieren: Cloud Storage
Übertragungsverhalten
Bei der Übertragung zwischen zwei Buckets mit hierarchischem Namespace:
- Objekte und Objektmetadaten werden übertragen.
- Ordner und Ordnermetadaten werden übertragen.
- Das Löschen von Ordnern in der Quelle oder Senke wird nicht unterstützt.
Bei der Übertragung von einem Bucket mit hierarchischem Namespace in einen Bucket mit flachem Namespace:
- Objekte und Objektmetadaten werden übertragen.
- Ordner werden als Objektpräfixe übertragen. Beispiel:
object1infolderAwird alsfolderA/object1an das Ziel übertragen. - Ordnermetadaten werden nicht übertragen.
- Das Löschen von Ordnern in der Quelle wird nicht unterstützt.
Bei der Übertragung von einem Bucket mit flachem Namespace in einen Bucket mit hierarchischem Namespace:
- Objekte und Objektmetadaten werden übertragen.
- Objektpräfixe werden verwendet, um fehlende Ordner zu erstellen. Wenn Sie beispielsweise
folderA/object1übertragen, erstellt Storage Transfer Service einen neuen Ordner mit dem NamenfolderAund überträgtobject1in diesen Ordner. - Das Löschen von Ordnern in der Senke wird nicht unterstützt.