In dieser Anleitung erfahren Sie, wie Sie verwaltete Ordner erstellen, auflisten und löschen.
Hinweise
Bevor Sie beginnen, müssen Sie die erforderliche IAM-Rolle (Identity and Access Management) haben, um verwaltete Ordner zu erstellen und zu verwalten, und den einheitlichen Zugriff auf Bucket-Ebene aktivieren.
Erforderliche Rollen abrufen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Storage Folder Admin“ (roles/storage.folderAdmin
) für den Bucket zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen und Verwalten von verwalteten Ordnern benötigen.
Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen und Verwalten von verwalteten Ordnern erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
storage.managedfolders.create
storage.managedfolders.delete
storage.managedfolders.get
storage.managedfolders.list
storage.objects.list
- Diese Berechtigung ist nur erforderlich, wenn Sie neu erstellte verwaltete Ordner validieren möchten.
Sie können diese Berechtigungen auch mit anderen vordefinierten Rollen oder benutzerdefinierten Rollen erhalten.
Informationen zum Zuweisen von Rollen für Buckets finden Sie unter IAM mit Buckets verwenden.
Einheitlichen Zugriff auf Bucket-Ebene aktivieren
Falls noch nicht geschehen, aktivieren Sie den einheitlichen Zugriff auf Bucket-Ebene.
Verwalteten Ordner erstellen
Console
Wenn Sie die Google Cloud Console verwenden, erstellen Sie verwaltete Ordner, indem Sie simulierte Ordner konvertieren. In den folgenden Schritten wird beschrieben, wie Sie einen simulierten Ordner erstellen und in einen verwalteten Ordner konvertieren.
- Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.
Klicken Sie in der Liste der Buckets auf den Namen des Buckets, in dem Sie verwaltete Ordner erstellen möchten.
Klicken Sie auf der Seite Bucket-Details auf Ordner erstellen, um einen neuen Ordner zu erstellen. Wenn der Ordner, den Sie in einen verwalteten Ordner konvertieren möchten, bereits vorhanden ist, fahren Sie mit dem Schritt fort, in dem beschrieben wird, wie Sie das Menü Weitere Optionen
aufrufen.Geben Sie im Feld Name einen Namen für Ihren Ordner ein. Hinweise zur Benennung finden Sie unter Namen verwalteter Ordner.
Klicken Sie auf Erstellen.
Der neu erstellte Ordner wird im Bereich Ordnerbrowser angezeigt.
Klicken Sie im Bereich Ordnerbrowser auf das Menü Weitere Optionen
neben dem Ordner, den Sie in einen verwalteten Ordner konvertieren möchten, und klicken Sie dann auf Zugriff bearbeiten.Das Dialogfeld Verwalteten Ordner erstellen wird angezeigt.
Klicken Sie auf Verwalteten Ordner anhängen.
Der Ordner wird in einen verwalteten Ordner konvertiert. Im Bereich Berechtigungen für
MANAGED_FOLDER_NAME
werden die IAM-Richtlinien für den Ordner nach Hauptkonto und Rolle angezeigt. Informationen zum Erstellen neuer IAM-Richtlinien finden Sie unter IAM-Richtlinie für einen verwalteten Ordner festlegen.
Befehlszeile
Führen Sie den gcloud storage managed-folders create
-Befehl aus, um einen verwalteten Ordner zu erstellen:
gcloud storage managed-folders create gs://BUCKET_NAME/MANAGED_FOLDER_NAME
Wobei:
BUCKET_NAME
ist der Name des Buckets, in dem Sie einen verwalteten Ordner erstellen möchten. Beispiel:my-bucket
.MANAGED_FOLDER_NAME
ist der Name des verwalteten Ordners, den Sie erstellen möchten. Beispiel:my-managed-folder/
.
Führen Sie den Befehl gcloud storage managed-folders describe
aus, um zu prüfen, ob der verwaltete Ordner erstellt wurde:
gcloud storage managed-folders describe gs://BUCKET_NAME/MANAGED_FOLDER_NAME
Wobei:
BUCKET_NAME
ist der Name des Buckets, in dem Sie einen verwalteten Ordner erstellt haben.MANAGED_FOLDER_NAME
ist der Name des verwalteten Ordners, den Sie erstellt haben.
REST APIs
JSON API
Installieren und initialisieren Sie die dcloud CLI, um ein Zugriffstoken für den Header
Authorization
zu generieren.Alternativ können Sie mit dem OAuth 2.0 Playground ein Zugriffstoken erstellen und in den Header
Authorization
einfügen.Verwenden Sie
cURL
, um die JSON API mit einerPOST
-ManagedFolder-Anfrage aufzurufen:curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -d '{ "name": "MANAGED_FOLDER_NAME" }' \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/managedFolders"
Wobei:
BUCKET_NAME
ist der Name des Buckets, in dem Sie einen verwalteten Ordner erstellen möchten. Beispiel:my-bucket
MANAGED_FOLDER_NAME
ist der Name des verwalteten Ordners, den Sie erstellen möchten. Beispiel:my-managed-folder/
Verwaltete Ordner auflisten
Console
- Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.
Maximieren Sie im Bereich Ordnerbrowser die Ein-/Aus-Schaltfläche
, um die Liste der Ordner in dem Bucket zu maximieren.
In einer Liste werden die simulierten und verwalteten Ordner in Ihrem Bucket angezeigt.
Befehlszeile
Führen Sie den Befehl gcloud storage managed-folders list
aus, um verwaltete Ordner aufzulisten:
gcloud storage managed-folders list gs://BUCKET_NAME
Wobei:
BUCKET_NAME
ist der Name des Buckets, der die verwalteten Ordner enthält, die Sie auflisten möchten. Beispiel:my-bucket
.
Sie können auch einen Ordnerpfad anstelle eines Bucket-Namens angeben. Beispiel:
gcloud storage managed-folders list gs://my-bucket/folder/
REST APIs
JSON API
Installieren und initialisieren Sie die dcloud CLI, um ein Zugriffstoken für den Header
Authorization
zu generieren.Alternativ können Sie mit dem OAuth 2.0 Playground ein Zugriffstoken erstellen und in den Header
Authorization
einfügen.Verwenden Sie
cURL
, um die JSON API mit einer Anfrage zum Auflisten verwalteter Ordner aufzurufen:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/managedFolders"
Dabei ist
BUCKET_NAME
der Name des Buckets, der die verwalteten Ordner enthält, die Sie auflisten möchten. Beispiel:my-bucket
Verwalteten Ordner verschieben
Console
Erstellen Sie einen neuen verwalteten Ordner im Ziel-Bucket.
Kopieren Sie die IAM-Richtlinien aus dem ursprünglichen verwalteten Ordner im Quell-Bucket in den neuen verwalteten Ordner im Ziel-Bucket.
Kopieren Sie die Objekte aus dem ursprünglichen verwalteten Ordner im Quell-Bucket in den neuen verwalteten Ordner im Ziel-Bucket.
Löschen Sie den ursprünglichen verwalteten Ordner aus dem Quell-Bucket.
Befehlszeile
Führen Sie den Befehl gcloud storage mv
mit der Option --include-managed-folders
aus, um verwaltete Ordner und die darin enthaltenen Objekte zu verschieben:
gcloud storage mv --include-managed-folders gs://SOURCE_BUCKET_NAME/MANAGED_FOLDER_NAME gs://DESTINATION_BUCKET_NAME/MANAGED_FOLDER_NAME
Wobei:
SOURCE_BUCKET
ist der Name des ursprünglichen Buckets. Zum Beispiel,my-source-bucket
.DESTINATION_BUCKET
ist der Name des Buckets, in den Sie den verwalteten Ordner verschieben. Beispiel:my-destination-bucket
MANAGED_FOLDER_NAME
ist der Name des verwalteten Ordners, den Sie verschieben. Beispiel:my-managed-folder/
.
REST APIs
JSON API
So verschieben Sie verwaltete Ordner von einem Bucket in einen anderen:
Erstellen Sie einen neuen verwalteten Ordner im Ziel-Bucket.
Kopieren Sie die IAM-Richtlinien aus dem ursprünglichen verwalteten Ordner im Quell-Bucket in den neuen verwalteten Ordner im Ziel-Bucket.
Kopieren Sie die Objekte aus dem ursprünglichen verwalteten Ordner im Quell-Bucket in den neuen verwalteten Ordner im Ziel-Bucket.
Löschen Sie den ursprünglichen verwalteten Ordner aus dem Quell-Bucket.
Verwalteten Ordner löschen
Console
- Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.
Klicken Sie auf der Seite Bucket-Details neben dem verwalteten Ordner, den Sie löschen möchten, auf das Symbol Weitere Optionen
.Klicken Sie auf Ordner löschen.
Geben Sie in das Feld Löschen
DELETE
ein, um zu bestätigen, dass Sie den verwalteten Ordner löschen möchten.Klicken Sie auf Löschen.
Der verwaltete Ordner und sein Inhalt, einschließlich gespeicherter Objekte und anderer verwalteter Ordner, werden aus dem Cloud Storage-Bucket gelöscht.
Befehlszeile
Führen Sie den Befehl gcloud storage rm
aus, um einen verwalteten Ordner und die darin enthaltenen Objekte zu löschen:
gcloud storage rm -r gs://BUCKET_NAME/MANAGED_FOLDER_NAME
Wobei:
BUCKET_NAME
ist der Name des Buckets, der den verwalteten Ordner enthält, den Sie löschen möchten. Beispiel:my-bucket
.MANAGED_FOLDER_NAME
ist der Name des verwalteten Ordners, den Sie löschen möchten. Beispiel:my-managed-folder/
.
REST APIs
JSON API
Sie müssen zuerst die Objekte im verwalteten Ordner löschen, um einen verwalteten Ordner zu löschen.
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Alternativ können Sie mit dem OAuth 2.0 Playground ein Zugriffstoken erstellen und in den Header
Authorization
einfügen.Verwenden Sie
cURL
, um die JSON API mit einerDELETE
-ManagedFolder-Anfrage aufzurufen:curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/managedFolders/MANAGED_FOLDER_NAME"
Wobei:
BUCKET_NAME
ist der Name des Buckets, der den verwalteten Ordner enthält, den Sie löschen möchten. Beispiel:my-bucket
MANAGED_FOLDER_NAME
ist der Name des verwalteten Ordners, den Sie löschen möchten. Beispiel:my-managed-folder/
.
Standardmäßig müssen verwaltete Ordner leer sein, bevor sie gelöscht werden können. Wenn Sie einen nicht leeren verwalteten Ordner löschen möchten, fügen Sie
allowNonEmpty=true
als Abfrageparameter in Ihre Anfrage ein.
Fehlerbehebung
Informationen zum Erstellen und Verwalten von verwalteten Ordnern finden Sie auf der Seite zur Fehlerbehebung.