Auf dieser Seite erfahren Sie, wie Sie die in Ihren Cloud Storage-Buckets gespeicherten Objekte auflisten. Diese werden in der Liste lexikografisch nach dem Namen sortiert aufgeführt.
Hinweise
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Storage-Objekt-Betrachter (roles/storage.objectViewer
) für den Bucket zuzuweisen, der die aufzulistenden Objekte enthält, um die Berechtigungen zu erhalten, die Sie zum Auflisten benötigen.
Wenn Sie Objekt-ACLs als Teil Ihrer Anfrage zurückgeben oder die Aufgaben auf der Seite mit der Google Cloud Console ausführen möchten, benötigen Sie alternative Rollen:
Wenn Sie Objekt-ACLs als Teil Ihrer Anfrage zurückgeben möchten, bitten Sie Ihren Administrator, Ihnen die Rolle "Storage-Objekt-Administrator" (
roles/storage.objectAdmin
) anstelle von "Storage-Objekt-Betrachter" (roles/storage.objectViewer
) zuzuweisen. .Wenn Sie die Google Cloud Console zum Ausführen der Aufgaben auf dieser Seite verwenden möchten, bitten Sie Ihren Administrator, Ihnen die Rolle „Storage-Administrator“ (
roles/storage.admin
) anstelle der Rolle „Storage-Objekt-Betrachter“ (roles/storage.objectViewer
) zuzuweisen.Alternativ können Sie Ihren Administrator bitten, Ihnen zusätzlich zur Rolle „Storage-Objekt-Betrachter“ (
roles/storage.objectViewer
) die einfache Rolle „Betrachter“ (roles/viewer
) zuzuweisen.
Diese Rollen enthalten die Berechtigungen, die zum Auflisten von Objekten erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
storage.objects.list
storage.objects.getIamPolicy
- Diese Berechtigung ist nur erforderlich, wenn Sie Objekt-ACLs zurückgeben möchten
storage.buckets.list
- Diese Berechtigung ist nur erforderlich, wenn Sie die Aufgaben in der Google Cloud Console auf dieser Seite ausführen 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.
Objekte in einem Bucket auflisten
Führen Sie die folgenden Schritte aus, um die Objekte in einem Bucket aufzulisten:
Console
- Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.
Klicken Sie in der Bucket-Liste auf den Namen des Buckets, dessen Inhalt Sie sehen möchten.
Optional: Verwenden Sie Filtern und Sortieren, um die Ergebnisse in Ihrer Liste einzuschränken und zu organisieren.
Befehlszeile
Führen Sie den Befehl gcloud storage ls
mit dem Flag --recursive
aus:
gcloud storage ls --recursive gs://BUCKET_NAME/**
Dabei gilt:
BUCKET_NAME
ist der Name des Buckets, dessen Objekte Sie auflisten möchten. Beispiel:my-bucket
.
Die Antwort sieht in etwa so aus:
gs://my-bucket/cats.jpeg gs://my-bucket/dogs.jpeg gs://my-bucket/thesis.txt ...
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 eine lokale Entwicklungsumgebung einrichten.
Im folgenden Beispiel werden alle Objekte eines Buckets aufgelistet:
Im folgenden Beispiel werden Objekte mit einem bestimmten Präfix aufgelistet:
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 eine lokale Entwicklungsumgebung einrichten.
Im folgenden Beispiel werden alle Objekte eines Buckets aufgelistet:
Im folgenden Beispiel werden Objekte mit einem bestimmten Präfix aufgelistet:
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 eine lokale Entwicklungsumgebung einrichten.
Im folgenden Beispiel werden alle Objekte eines Buckets aufgelistet:
Im folgenden Beispiel werden Objekte mit einem bestimmten Präfix aufgelistet:
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 eine lokale Entwicklungsumgebung einrichten.
Im folgenden Beispiel werden alle Objekte eines Buckets aufgelistet:
Im folgenden Beispiel werden Objekte mit einem bestimmten Präfix aufgelistet:
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 eine lokale Entwicklungsumgebung einrichten.
Im folgenden Beispiel werden alle Objekte eines Buckets aufgelistet:
Im folgenden Beispiel werden Objekte mit einem bestimmten Präfix aufgelistet:
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 eine lokale Entwicklungsumgebung einrichten.
Im folgenden Beispiel werden alle Objekte eines Buckets aufgelistet:
Im folgenden Beispiel werden Objekte mit einem bestimmten Präfix aufgelistet:
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 eine lokale Entwicklungsumgebung einrichten.
Im folgenden Beispiel werden alle Objekte eines Buckets aufgelistet:
Im folgenden Beispiel werden Objekte mit einem bestimmten Präfix aufgelistet:
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 eine lokale Entwicklungsumgebung einrichten.
Im folgenden Beispiel werden alle Objekte eines Buckets aufgelistet:
Im folgenden Beispiel werden Objekte mit einem bestimmten Präfix aufgelistet:
REST APIs
JSON API
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.Verwenden Sie
cURL
, um die JSON API mit einer Anfrage zum Auflisten von Objekten aufzurufen:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o"
Dabei ist
BUCKET_NAME
der Name des Buckets, dessen Objekte Sie auflisten möchten. Beispiel:my-bucket
.Mit dem Abfrageparameter
includeFoldersAsPrefixes=True
können Sie verwaltete Ordner als Teil der Listenergebnisse zurückgeben. Wenn Sie den ParameterincludeFoldersAsPrefixes
verwenden, muss der Parameterdelimiter
auf/
festgelegt werden.Um Objekt-ACLs zurückzugeben, hängen Sie den Abfrageparameter
projection
mit dem Wertfull
an Ihre Anfrage an. ACLs sind deaktiviert und können nicht zurückgegeben werden, wenn der einheitliche Zugriff auf Bucket-Ebene für den Bucket aktiviert ist.
XML API
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.Verwenden Sie
cURL
, um die XML API mit einerGET
-Bucket-Anfrage aufzurufen:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?list-type=2"
Dabei ist
BUCKET_NAME
der Name des Buckets, dessen Objekte Sie auflisten möchten. Beispiel:my-bucket
.Sie können den Abfragestringparameter
prefix=PREFIX
verwenden, um die Ergebnisse auf Buckets mit dem angegebenen Präfix zu beschränken.
Objekte filtern
Console
Verwenden Sie auf der Seite Bucket-Details das Feld Objekte und Ordner filtern, um Objekte mit der Google Cloud Console nach Namenspräfix zu filtern.
Unter Filtern und Sortieren finden Sie weitere Filteroptionen, die über die Google Cloud Console verfügbar sind.
Befehlszeile
Beim Auflisten von Objekten mithilfe der Google Cloud CLI können Sie Platzhalter verwenden, um nach Objekten zu filtern, die mit einem angegebenen Präfix beginnen oder mit einem angegebenen Suffix enden. Der folgende Befehl gleicht beispielsweise .png
-Objekte ab, die mit image
beginnen:
gcloud storage ls gs://my-bucket/image*.png
Weitere Informationen zum Filtern mit der Google Cloud CLI finden Sie in der Dokumentation zu gcloud storage ls
.
REST APIs
JSON API
Beim Auflisten von Objekten mithilfe der Cloud Storage JSON API können Sie die Ergebnisse mit den Abfragestringparametern prefix
oder matchGlob
filtern. Weitere Informationen zur Verwendung dieser Abfragestringparameter finden Sie in der JSON API-Referenzdokumentation zur Objektliste.
Nach Präfix filtern
Mit dem Abfragestringparameter prefix=PREFIX
können Sie die Ergebnisse auf Objekte oder verwaltete Ordner mit dem angegebenen Präfix beschränken. Wenn Sie beispielsweise alle Objekte im Bucket my-bucket
mit dem Präfix folder/subfolder/
auflisten möchten, stellen Sie eine Anfrage zur Objektauflistung unter Verwendung der folgenden URL: "https://storage.googleapis.com/storage/v1/b/my-bucket?prefix=folder/subfolder/"
.
Die Verwendung von prefix
zum Auflisten der Inhalte eines verwalteten Ordners ist nützlich, wenn Sie nur die Berechtigung zum Auflisten von Objekten im verwalteten Ordner, aber nicht den gesamten Bucket haben. Angenommen, Sie haben die IAM-Rolle „Storage-Objekt-Betrachter“ (roles/storage.objectViewer
) für den verwalteten Ordner my-bucket/my-managed-folder-a/
, aber nicht für den verwalteten Ordner my-bucket/my-managed-folder-b/
. Wenn Sie nur die Objekte in my-managed-folder-a
zurückgeben möchten, können Sie prefix=my-managed-folder-a/
angeben.
Wenn Sie die Ergebnisse auf einen verwalteten Ordner und die darin enthaltenen Objekte beschränken, müssen Sie am Ende von PREFIX
einen /
setzen (z. B. prefix=my-managed-folder/
). Andernfalls können die Ergebnisse auch Objekte enthalten, die sich in der Nähe des verwalteten Ordners befinden. In diesem Beispiel haben Sie einen Bucket, der die folgenden Objekte enthält:
my-bucket/abc.txt
my-bucket/abc/object.txt
Wenn Sie prefix=abc/
angeben, können Sie die Objekte my-bucket/abc/object.txt
erhalten. Wenn Sie prefix=abc
angeben, können Sie sowohl my-bucket/abc.txt
als auch my-bucket/abc/object.txt
erhalten.
Nach glob-Ausdruck filtern
Sie können den Abfragestringparameter matchGlob=GLOB_PATTERN
verwenden, um die Ergebnisse nur nach den Objekten zu filtern, die einem bestimmten glob-Ausdruck entsprechen. Beispielsweise kann matchGlob=**.jpeg
verwendet werden, um alle Objekte abzugleichen, deren Namen mit .jpeg
enden.
Anfragen, die den Parameter matchGlob
verwenden, schlagen fehl, wenn sie auch einen delimiter
-Parameter enthalten, der auf einen anderen Wert als /
gesetzt ist.
Nächste Schritte
- Objekt aus dem Bucket herunterladen
- Objektmetadaten ansehen und bearbeiten
- Objekte im Bucket löschen
- Paginierung der Ergebnisse