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 mit Buckets verwenden.
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 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 Ordnerverwaltung aktivieren? wird angezeigt.
Klicken Sie auf Aktivieren.
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
Dabei gilt:
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
Dabei gilt:
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.
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
Authorization
zu 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_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 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_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/
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
Authorization
zu 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_NAME
der 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_NAME
ist der Name des Buckets, der die verwalteten Ordner enthält, die Sie auflisten möchten. Beispiel:my-bucket
.MANAGED_FOLDER_NAME
ist 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
Authorization
zu 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_NAME
ist der Name des Buckets, der die verwalteten Ordner enthält, die Sie aufrufen möchten. Beispiel:my-bucket
MANAGED_FOLDER_NAME
ist 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_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 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
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
Dabei gilt:
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/
.
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
Authorization
zu 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_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.