Auf dieser Seite wird beschrieben, wie Sie Ordner in Buckets mit aktiviertem hierarchischen Namespace erstellen, auflisten, hochladen, löschen und Metadaten abrufen.
Hinweise
Achten Sie darauf, dass 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 Hinweise.
-
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 create
aus:gcloud storage folders create --recursive gs://BUCKET_NAME/FOLDER_NAME
Wobei:
BUCKET_NAME
ist der Name des Buckets. Beispiel:my-bucket
.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.--recursive
ist ein Flag, das automatisch alle nicht vorhandenen übergeordneten Ordner erstellt und zwar zusammen mit dem Ordner. Diese Einstellung ist optional, wenn übergeordnete Ordner bereits vorhanden sind.
Wenn die Anfrage erfolgreich ist, gibt der Befehl die folgende Meldung zurück:
Completed 1/1
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.- Erstellen Sie eine JSON-Datei mit den Einstellungen für den Ordner. Sie muss einen
name
fü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
cURL
zum 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_NAME
ist der Name der JSON-Datei, die die Einstellungen für den Ordner enthält.BUCKET_NAME
ist der Name des Buckets, in dem Sie den Ordner erstellen möchten.recursive
ist auf „wahr“ gesetzt, um automatisch alle nicht vorhandenen übergeordneten Ordner zusammen mit dem Ordner zu erstellen. Diese Einstellung ist optional, wenn übergeordnete Ordner bereits vorhanden sind.
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 dem Bucket mit dem Maximierungspfeil
.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_NAME
ist 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
Authorization
zu 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_NAME
der 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 Liste der Buckets 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 Console.
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_LOCATION
ist der lokale Pfad zum Ordner, den Sie hochladen möchten. Beispiel:../uploads/my-folder/
.DESTINATION_BUCKET_NAME
ist 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 dem Bucket mit dem Maximierungspfeil
.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 die Zahl
DELETE
ein, 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_NAME
ist der Name des Buckets. Beispiel:my-bucket
.FOLDER_NAME
ist 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
Authorization
zu generieren.Verwenden Sie
cURL
, um die JSON API mit einerDELETE
-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_NAME
ist der Name des Buckets mit dem Ordner, den Sie löschen möchten. Beispiel:my-bucket
FOLDER_NAME
ist der URL-codierte Name des Ordners, den Sie löschen möchten. Beispiel:my-folder/
, URL-codiert alsmy-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_NAME
ist der Name des Buckets, der enthält den Ordner, dessen Metadaten Sie abrufen möchten. Beispiel:my-bucket
.FOLDER_NAME
ist 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
Authorization
zu generieren.Verwenden Sie
cURL
, um die JSON API mit einerGET
-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_NAME
ist der Name des Buckets mit dem Ordner, dessen Metadaten Sie abrufen möchten. Beispiel:my-bucket
.FOLDER_NAME
ist der URL-codierte Name des Ordners, dessen Metadaten Sie abrufen möchten. Beispiel:my-folder/
, URL-codiert alsmy-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. So können Sie die Zugriffssteuerung für bestimmte Objektgruppen in einem Bucket detaillierter steuern.
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 der vorhandene Ordner erstellen. Eine ausführliche 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