Auf dieser Seite wird beschrieben, wie Sie Ordner in Buckets mit aktiviertem hierarchischem Namespace erstellen, auflisten, hochladen, löschen und deren Metadaten abrufen.
Hinweise
Prüfen Sie, ob für Ihren Bucket der hierarchische Namespace aktiviert ist. Eine detaillierte Anleitung zum Aktivieren des hierarchischen Namespaces für einen Bucket finden Sie unter Buckets mit aktiviertem hierarchischen Namespace erstellen.
Ordner erstellen
In diesem Abschnitt wird beschrieben, wie Sie einen Ordner erstellen.
Console
- 
        Wechseln Sie in der Google Cloud Console unter „Cloud Storage“ zur Seite Buckets.
 
- Klicken Sie in der Bucket-Liste auf den Namen des Buckets, in dem Sie den Ordner erstellen möchten.
- Klicken Sie auf der Seite Bucket-Details auf Ordner erstellen, um einen leeren Ordner zu erstellen.
- Geben Sie im Feld Name einen Namen für Ihren Ordner ein. Hinweise zur Benennung finden Sie unter Überlegungen.
- 
        Klicken Sie auf Erstellen.
        Der neu erstellte Ordner wird im Bereich Ordnerbrowser angezeigt. 
Befehlszeile
- 
    
    In the Google Cloud console, activate Cloud Shell. At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize. 
- 
        Führen Sie in Ihrer Entwicklungsumgebung den Befehl gcloud storage folders createaus:gcloud storage folders create --recursive gs://BUCKET_NAME/FOLDER_NAME Wobei: - BUCKET_NAMEist der Name des Buckets. Beispiel:- my-bucket.
- FOLDER_NAMEist der Name des Ordners, den Sie erstellen möchten. Beispiel:- my-folder/. Informationen zu Ordnernamen finden Sie in der Übersichtsdokumentation zu Ordnern.
- --recursiveist ein Flag, das automatisch alle nicht vorhandenen übergeordneten Ordner erstellt und zwar zusammen mit dem Ordner. Diese Einstellung ist optional, wenn bereits übergeordnete Ordner vorhanden sind.
 Wenn die Anfrage erfolgreich ist, gibt der Befehl die folgende Meldung zurück: Completed 1/1 
- Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header - Authorizationzu generieren.
- Erstellen Sie eine JSON-Datei mit den Einstellungen für den Ordner. Sie muss einen
      namefür den Ordner enthalten. Eine vollständige Liste der Einstellungen finden Sie in der Dokumentation zu Folders: Insert. Folgende Einstellungen sind erforderlich:{ "name": "FOLDER_NAME", } FOLDER_NAME ist der Name des Ordners, den Sie erstellen möchten. Beispiel: my-folder/. Informationen zu Ordnernamen finden Sie in der Übersichtsdokumentation zu Ordnern.
- Verwenden Sie cURLzum Aufrufen der JSON API:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/folders?recursive=true" Dabei gilt: - JSON_FILE_NAMEist der Name der JSON-Datei, die die Einstellungen für den Ordner enthält.
- BUCKET_NAMEist der Name des Buckets, in dem Sie den Ordner erstellen möchten.
- recursiveist auf „true“ gesetzt, um automatisch alle nicht vorhandenen übergeordneten Ordner zusammen mit dem Ordner zu erstellen. Diese Einstellung ist optional, wenn bereits übergeordnete Ordner vorhanden sind.
 
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
Ordner auflisten
In diesem Abschnitt wird beschrieben, wie Sie Ordner auflisten.
Console
- Wechseln Sie in der Google Cloud Console unter „Cloud Storage“ zur Seite Buckets.
 
- Klicken Sie in der Bucket-Liste auf den Namen des Buckets, dessen Ordner Sie auflisten möchten. 
- Maximieren Sie im Bereich Ordnerbrowser die Liste der Ordner in Ihrem Bucket mit dem Aufklapppfeil . - In einer Liste werden die Ordner, simulierten Ordner und verwalteten Ordner in Ihrem Bucket angezeigt. 
Befehlszeile
Führen Sie den Befehl gcloud storage folders list aus, um alle Ordner in einem Bucket aufzulisten:
gcloud storage folders list gs://BUCKET_NAME/
Wobei:
- BUCKET_NAMEist der Name des Buckets, der die Ordner enthält, die Sie auflisten möchten. Beispiel:- my-bucket.
Eine erfolgreiche Antwort sieht in etwa so aus:
bucket: hns-bucket id: hns-bucket/A/ kind: storage#folder name: A/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/A timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' --- bucket: hns-bucket id: hns-bucket/B/ kind: storage#folder name: B/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/B timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' --- bucket: hns-bucket id: hns-bucket/B/D/ kind: storage#folder name: D/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/B/D timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' --- bucket: hns-bucket id: hns-bucket/C/ kind: storage#folder name: C/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/C timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' --- bucket: hns-bucket id: hns-bucket/C/E/ kind: storage#folder name: E/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/C/E timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' ...
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 von Ordnern aufzurufen:- curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/folders" - Dabei ist - BUCKET_NAMEder Name des Buckets, der die Ordner enthält, die Sie auflisten möchten. Beispiel:- my-bucket
Ordner hochladen
In diesem Abschnitt wird beschrieben, wie Sie Ordner in einen Bucket hochladen.
Console
- Wechseln Sie in der Google Cloud Console unter „Cloud Storage“ zur Seite Buckets.
 
- Klicken Sie in der Bucket-Liste auf den Namen des Buckets, in den Sie den Ordner hochladen möchten. 
- Führen Sie auf dem Tab Bucket-Details eine der folgenden Aktionen aus: - Ziehen Sie Ordner von Ihrem Desktop oder Dateimanager in den Hauptbereich der Google Cloud -Konsole. 
- Klicken Sie auf Hochladen > Ordner hochladen, wählen Sie im angezeigten Dialogfeld den Ordner aus, den Sie hochladen möchten, und klicken Sie auf Öffnen. 
 
Unter Fehlerbehebung erfahren Sie, wie Sie detaillierte Fehlerinformationen zu fehlgeschlagenen Cloud Storage-Vorgängen in der Google Cloud Console abrufen.
Befehlszeile
Verwenden Sie den Befehl gcloud storage cp mit dem Flag --recursive:
gcloud storage cp --recursive FOLDER_LOCATION gs://DESTINATION_BUCKET_NAME
Wobei:
- FOLDER_LOCATIONist der lokale Pfad zu dem Ordner, den Sie hochladen möchten. Beispiel:- ../uploads/my-folder/.
- DESTINATION_BUCKET_NAMEist der Name des Buckets, in den Sie den Ordner hochladen. Beispiel:- my-bucket
Wenn der Vorgang erfolgreich ausgeführt wurde, sieht die Antwort in etwa so aus:
Copying file://DIR/OBJ1 at 10.06.32 PM.png to gs://BUCKET_NAME/DIR/OBJ1 at 10.06.32 PM.png Copying file://DIR/OBJ1 at 10.06.32 PM.png to gs://BUCKET_NAME/DIR/OBJ1 at 10.06.32 PM.png Completed files 2/2 | 1.7MiB/1.7MiB
Ordner löschen
In diesem Abschnitt wird beschrieben, wie Sie Ordner löschen.
Console
- Wechseln Sie in der Google Cloud Console unter „Cloud Storage“ zur Seite Buckets.
 
- Klicken Sie in der Bucket-Liste auf den Namen des Buckets, dessen Ordner Sie löschen möchten. 
- Maximieren Sie im Bereich Ordnerbrowser die Liste der Ordner in Ihrem Bucket mit dem Aufklapppfeil . 
- Suchen Sie den Ordner, den Sie löschen möchten. 
- Klicken Sie auf das Menü Weitere Aktionen des Ordners. 
- Klicken Sie auf Ordner löschen. 
- Geben Sie in das Feld Löschen - DELETEein, um zu bestätigen, dass Sie den Ordner löschen möchten.
- Klicken Sie auf Löschen. - Der 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 folders delete aus, um einen leeren Ordner zu löschen:
gcloud storage folders delete gs://BUCKET_NAME/FOLDER_NAME
Wobei:
- BUCKET_NAMEist der Name des Buckets. Beispiel:- my-bucket.
- FOLDER_NAMEist der Name des Ordners, den Sie löschen möchten. Beispiel:- my-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- DELETE-Ordneranfrage aufzurufen:- curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/folders/FOLDER_NAME" - Dabei gilt: - BUCKET_NAMEist der Name des Buckets mit dem Ordner, den Sie löschen möchten. Beispiel:- my-bucket
- FOLDER_NAMEist der URL-codierte Name des Ordners, den Sie löschen möchten. Beispiel:- my-folder/, URL-codiert als- my-folder%2F.
 
Metadaten eines Ordners abrufen
In diesem Abschnitt wird beschrieben, wie Sie die Metadaten eines Ordners abrufen.
Befehlszeile
Führen Sie den Befehl gcloud storage folders describe aus, um die Metadaten eines Ordners abzurufen:
gcloud storage folders describe gs://BUCKET_NAME/FOLDER_NAME
Wobei:
- BUCKET_NAMEist der Name des Buckets, der enthält den Ordner, dessen Metadaten Sie abrufen möchten. Beispiel:- my-bucket.
- FOLDER_NAMEist der Name des Ordners, dessen Metadaten Sie abrufen möchten. Beispiel:- my-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- GET-Ordneranfrage aufzurufen:- curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/folders/FOLDER_NAME" - Dabei gilt: - BUCKET_NAMEist der Name des Buckets mit dem Ordner, dessen Metadaten Sie abrufen möchten. Beispiel:- my-bucket.
- FOLDER_NAMEist der URL-codierte Name des Ordners, dessen Metadaten Sie abrufen möchten. Beispiel:- my-folder/, URL-codiert als- my-folder%2F.
 
Zugriff auf einen Ordner verwalten
In diesem Abschnitt wird beschrieben, wie Sie den Zugriff auf Ihren Ordner verwalten, indem Sie IAM-Richtlinien (Identity and Access Management) festlegen, um eine detaillierte Zugriffssteuerung für bestimmte Gruppen von Objekten in einem Bucket zu erhalten.
So verwalten Sie den Zugriff auf Ihren Ordner:
- Aktivieren Sie die Verwaltung für Ihren Ordner, indem Sie einen verwalteten Ordner mit demselben Namen wie Ihr vorhandener Ordner erstellen. Eine detaillierte Anleitung finden Sie unter Verwalteten Ordner erstellen. 
Nächste Schritte
- Ordner umbenennen
- Buckets mit aktiviertem hierarchischen Namespace erstellen
- Verwenden Sie einen hierarchischen Namespace für Hadoop-Arbeitslasten.
- Ordnerverwaltung optimieren:
Überzeugen Sie sich selbst
Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit von Cloud Storage in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
Cloud Storage kostenlos testen