Verwaltete Cloud Storage-Ordner bieten eine detaillierte Zugriffssteuerung für Objekte in Cloud Storage-Buckets. Berechtigungen können auf Ordnerebene in Buckets festgelegt werden, für die der einheitliche Zugriff auf Bucket-Ebene verwendet wird. Wenn Sie Objekte mit Storage Transfer Service zwischen Cloud Storage-Buckets übertragen, können diese Berechtigungen für verwaltete Ordner beibehalten werden.
Beschränkungen
Für die Übertragung verwalteter Ordner gelten die folgenden Einschränkungen:
- Sowohl der Quell- als auch der Ziel-Bucket müssen den einheitlichen Zugriff auf Bucket-Ebene verwenden.
- Übertragungen von verwalteten Ordnern unterstützen die Optionen
deleteObjectsUniqueInSinkunddeleteObjectsFromSourceAfterTransfernicht. - Es dürfen keine IAM-Bedingungen für den Ziel-Bucket oder sein Projekt vorhanden sein, die den Ressourcentyp Bucket (
storage.googleapis.com/Bucket) oder den Ressourcentyp Objekt (storage.googleapis.com/Object) verwenden. Wenn ein Bucket in einem Projekt eine IAM-Bedingung hat, die einen dieser Ressourcentypen verwendet, können verwaltete Ordner nicht in einen der Buckets in diesem Projekt übertragen werden, auch wenn die Bedingung später entfernt wird. - Ereignisgesteuerte Übertragungen werden nicht unterstützt.
- Manifestübertragungen werden nicht unterstützt.
IAM-Berechtigungen
Die folgenden Google Cloud IAM-Berechtigungen (Identity and Access Management) sind für den Dienst-Agent von Storage Transfer Service erforderlich.
Sowohl für die Quelle als auch für das Ziel können Berechtigungen auf Bucket-Ebene oder für den verwalteten Ordner festgelegt werden. Wenn Sie Berechtigungen für einen verwalteten Zielordner festlegen möchten, muss dieser Ordner bereits vorhanden sein.
Wir empfehlen nicht, Berechtigungen für verwaltete Ordner auf Projektebene festzulegen. Weitere Informationen finden Sie unter Sicherheitsaspekte.
Für den Quell-Bucket oder den verwalteten Quellordner:
storage.managedFolders.getIamPolicystorage.managedFolders.liststorage.managedFolders.get
Im Ziel-Bucket oder verwalteten Ordner:
storage.managedFolders.setIamPolicystorage.managedFolders.liststorage.managedFolders.create
Diese Berechtigungen sind zusätzlich zu den Standardberechtigungen erforderlich, die für den Storage Transfer Service benötigt werden:
- Zugriff auf eine Quelle konfigurieren: Cloud Storage
- Zugriff auf eine Senke konfigurieren: Cloud Storage
Wenn Sie die erforderlichen Berechtigungen für verwaltete Ordner gewähren möchten, erstellen Sie eine benutzerdefinierte Rolle, die nur die erforderlichen Berechtigungen enthält.
Übertragung eines verwalteten Ordners erstellen
Wenn Sie eine Übertragung mit einem verwalteten Ordner erstellen möchten, geben Sie managedFolderTransferEnabled: true in Ihrer transferSpec an. Optional können Sie einen path-Wert angeben, um nur einen bestimmten verwalteten Ordner zu übertragen.
POST https://storagetransfer./v1/transferJobs { "name": "transferJobs/NAME", "projectId": "PROJECT_ID", "transferSpec": { "gcsDataSource": { "bucketName": "SOURCE_BUCKET", "path": "SOURCE_PATH", "managedFolderTransferEnabled": true }, "gcsDataSink": { "bucketName": "DESTINATION_BUCKET", "path": "DESTINATION_PATH" } }, "status": "ENABLED" }
Wenn die richtigen Berechtigungen für die verwaltete Übertragung nicht für die Quelle und das Ziel festgelegt sind, schlägt die Übertragung fehl.
Weitere Informationen zum Erstellen einer Übertragung mit der REST API finden Sie unter Übertragungen erstellen oder in der transferJobs.create-Referenz.
Sicherheitsaspekte
Wenn Sie einem Dienst-Agent Berechtigungen für verwaltete Ordner gewähren, kann das Konto IAM-Richtlinien für Zielordner oder für alle Ordner ändern, wenn die Rolle auf Projektebene gewährt wird. Dies stellt ein Sicherheitsrisiko dar: Ein Nutzer mit Bearbeitungsberechtigungen für Jobs könnte dies ausnutzen, um einem böswilligen Akteur Berechtigungen zu gewähren. Um dieses Risiko zu minimieren, sollten Sie Übertragungen von verwalteten Ordnern in einem dedizierten Google Cloud -Projekt isolieren.
Cloud Logging
Aktionen für verwaltete Ordner werden von Cloud Logging protokolliert. Weitere Informationen finden Sie unter Cloud Logging für Storage Transfer Service.
Fehlerbehebung
Informationen zum Erstellen und Verwalten von verwalteten Ordnern finden Sie auf der Seite zur Fehlerbehebung.