In dieser Anleitung erfahren Sie, wie Sie verwaltete Ordner erstellen, auflisten und löschen.
Hinweise
Wenn Sie verwaltete Ordner erstellen und verwalten möchten, müssen Sie zuerst den einheitlichen Zugriff auf Bucket-Ebene aktivieren und die erforderlichen IAM-Rollen erhalten.
Einheitlichen Zugriff auf Bucket-Ebene aktivieren
Falls noch nicht geschehen, aktivieren Sie den einheitlichen Zugriff auf Bucket-Ebene.
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
Die folgenden Berechtigungen sind erforderlich, um verwaltete Ordner zu erstellen und zu verwalten:
-
So erstellen Sie verwaltete Ordner:
storage.managedFolders.create -
So validieren Sie neu erstellte verwaltete Ordner, indem Sie sie auflisten:
storage.objects.list -
So listen Sie verwaltete Ordner auf:
storage.managedFolders.list -
So rufen Sie verwaltete Ordner ab:
storage.managedFolders.get -
So verschieben Sie verwaltete Ordner:
-
storage.managedFolders.delete(für den Quell-Bucket) -
storage.managedFolders.create(für den Ziel-Bucket)
-
-
So löschen Sie verwaltete Ordner:
storage.managedFolders.delete
Informationen zum Zuweisen von Rollen für Buckets finden Sie unter IAM-Richtlinien für Buckets festlegen und verwalten.
Verwalteten Ordner erstellen
Console
Wenn Sie die Google Cloud Console verwenden, erstellen Sie verwaltete Ordner, indem Sie die Verwaltung für Ordner oder simulierte Ordner aktivieren. In den folgenden Schritten wird beschrieben, wie Sie einen Ordner oder einen simulierten Ordner erstellen und dann die Ordnerverwaltung aktivieren:
- Wechseln Sie in der Google Cloud Console unter „Cloud Storage“ zur Seite 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 Ordnerverwaltung aktivieren? wird angezeigt.
Klicken Sie auf Aktivieren.
Der Ordner wird in einen verwalteten Ordner konvertiert. Im Bereich Berechtigungen für
MANAGED_FOLDER_NAMEwerden 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
Dabei gilt:
BUCKET_NAMEist der Name des Buckets, in dem Sie einen verwalteten Ordner erstellen möchten. Beispiel:my-bucket.MANAGED_FOLDER_NAMEist 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
Dabei gilt:
BUCKET_NAMEist der Name des Buckets, in dem Sie einen verwalteten Ordner erstellt haben.MANAGED_FOLDER_NAMEist der Name des verwalteten Ordners, den Sie erstellt haben.
Clientbibliotheken
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
REST APIs
JSON API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorizationzu generieren.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"Dabei gilt:
BUCKET_NAMEist der Name des Buckets, in dem Sie einen verwalteten Ordner erstellen möchten. Beispiel:my-bucketMANAGED_FOLDER_NAMEist der Name des verwalteten Ordners, den Sie erstellen möchten. Beispiel:my-managed-folder/
Verwaltete Ordner auflisten
Console
- Wechseln Sie in der Google Cloud Console unter „Cloud Storage“ zur Seite 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 Ordner, simulierten Ordner 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
Dabei gilt:
BUCKET_NAMEist 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/
Clientbibliotheken
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
REST APIs
JSON API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorizationzu generieren.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_NAMEder Name des Buckets, der die verwalteten Ordner enthält, die Sie auflisten möchten. Beispiel:my-bucket
Metadaten eines verwalteten Ordners abrufen
Befehlszeile
Führen Sie den Befehl gcloud storage managed-folders describe aus, um die Metadaten eines verwalteten Ordners abzurufen:
gcloud storage managed-folders describe gs://BUCKET_NAME/MANAGED_FOLDER_NAME
Dabei gilt:
BUCKET_NAMEist der Name des Buckets, der die verwalteten Ordner enthält, die Sie auflisten möchten. Beispiel:my-bucket.MANAGED_FOLDER_NAMEist der Name des verwalteten Ordners, für den Sie Metadaten abrufen möchten.
Clientbibliotheken
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
REST APIs
JSON API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorizationzu generieren.Verwenden Sie
cURL, um die JSON API mit einer Anfrage zum Abrufen verwalteter Ordner aufzurufen:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/managedFolders/MANAGED_FOLDER_NAME"
Dabei gilt:
BUCKET_NAMEist der Name des Buckets, der die verwalteten Ordner enthält, die Sie aufrufen möchten. Beispiel:my-bucketMANAGED_FOLDER_NAMEist der Name des verwalteten Ordners, ausgedrückt als Pfad. Beispiel:example-dir/Wenn der verwaltete Ordner verschachtelt ist, muss das Schrägstrichzeichen (/) im Pfad des verwalteten Ordners mit einem Escapezeichen versehen werden. Beispiel:example-dir1%2Fexample-dir2.
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
Dabei gilt:
SOURCE_BUCKETist der Name des ursprünglichen Buckets. Zum Beispiel,my-source-bucket.DESTINATION_BUCKETist der Name des Buckets, in den Sie den verwalteten Ordner verschieben. Beispiel:my-destination-bucketMANAGED_FOLDER_NAMEist 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 Google Cloud Console unter „Cloud Storage“ zur Seite Buckets.
Klicken Sie in der Liste der Buckets auf den Namen des Buckets, der den verwalteten Ordner enthält, den Sie löschen möchten.
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
DELETEein, 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
Dabei gilt:
BUCKET_NAMEist der Name des Buckets, der den verwalteten Ordner enthält, den Sie löschen möchten. Beispiel:my-bucket.MANAGED_FOLDER_NAMEist der Name des verwalteten Ordners, den Sie löschen möchten. Beispiel:my-managed-folder/.
Clientbibliotheken
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
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
Authorizationzu generieren.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"
Dabei gilt:
BUCKET_NAMEist der Name des Buckets, der den verwalteten Ordner enthält, den Sie löschen möchten. Beispiel:my-bucketMANAGED_FOLDER_NAMEist 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=trueals Abfrageparameter in Ihre Anfrage ein.
Fehlerbehebung
Informationen zum Erstellen und Verwalten von verwalteten Ordnern finden Sie auf der Seite zur Fehlerbehebung.