Verwaltete Ordner erstellen und verwalten

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.

  1. Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.

    Buckets aufrufen

  2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, in dem Sie verwaltete Ordner erstellen möchten.

  3. 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.

  4. Geben Sie im Feld Name einen Namen für Ihren Ordner ein. Hinweise zur Benennung finden Sie unter Namen verwalteter Ordner.

  5. Klicken Sie auf Erstellen.

    Der neu erstellte Ordner wird im Bereich Ordnerbrowser angezeigt.

  6. 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.

  7. 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

  1. 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.

  2. Verwenden Sie cURL, um die JSON API mit einer POST-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

  1. Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.

    Buckets aufrufen

  2. 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

  1. 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.

  2. 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

  1. Erstellen Sie einen neuen verwalteten Ordner im Ziel-Bucket.

  2. Kopieren Sie die IAM-Richtlinien aus dem ursprünglichen verwalteten Ordner im Quell-Bucket in den neuen verwalteten Ordner im Ziel-Bucket.

  3. Kopieren Sie die Objekte aus dem ursprünglichen verwalteten Ordner im Quell-Bucket in den neuen verwalteten Ordner im Ziel-Bucket.

  4. 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:

  1. Erstellen Sie einen neuen verwalteten Ordner im Ziel-Bucket.

  2. Kopieren Sie die IAM-Richtlinien aus dem ursprünglichen verwalteten Ordner im Quell-Bucket in den neuen verwalteten Ordner im Ziel-Bucket.

  3. Kopieren Sie die Objekte aus dem ursprünglichen verwalteten Ordner im Quell-Bucket in den neuen verwalteten Ordner im Ziel-Bucket.

  4. Löschen Sie den ursprünglichen verwalteten Ordner aus dem Quell-Bucket.

Verwalteten Ordner löschen

Console

  1. Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.

    Buckets aufrufen

  2. Klicken Sie auf der Seite Bucket-Details neben dem verwalteten Ordner, den Sie löschen möchten, auf das Symbol Weitere Optionen .

  3. Klicken Sie auf Ordner löschen.

  4. Geben Sie in das Feld Löschen DELETE ein, um zu bestätigen, dass Sie den verwalteten Ordner löschen möchten.

  5. 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.

  1. 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.

  2. Verwenden Sie cURL, um die JSON API mit einer DELETE-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.

Nächste Schritte