Auf dieser Seite wird beschrieben, wie Sie Informationen über die Größe und Metadaten von Cloud Storage-Buckets abrufen können.
Vorbereitung
Die Voraussetzungen können je nach verwendetem Tool variieren:
Console
Sie benötigen die entsprechenden IAM-Berechtigungen, um diesen Leitfaden mit der Google Cloud Console abzuschließen. Wenn Sie den Bucket, auf den Sie zugreifen möchten, nicht erstellt haben, muss Ihnen der Projektinhaber möglicherweise eine Rolle zuweisen, die die erforderlichen Berechtigungen enthält.
Eine Liste der erforderlichen Berechtigungen für bestimmte Aktionen finden Sie unter IAM-Berechtigungen für die Google Cloud Console.
Eine Liste der relevanten Rollen finden Sie unter Cloud Storage-Rollen. Alternativ können Sie eine benutzerdefinierte Rolle erstellen, die spezifische, eingeschränkte Berechtigungen hat.
Befehlszeile
Damit Sie diese Anleitung mit einem Befehlszeilen-Dienstprogramm ausführen können, benötigen Sie die entsprechenden IAM-Berechtigungen. Wenn Sie den Bucket, auf den Sie zugreifen möchten, nicht erstellt haben, muss Ihnen der Projektinhaber möglicherweise eine Rolle zuweisen, die die erforderlichen Berechtigungen enthält.
Eine Liste der erforderlichen Berechtigungen für bestimmte Aktionen finden Sie unter IAM-Berechtigungen für gsutil-Befehle.
Eine Liste der relevanten Rollen finden Sie unter Cloud Storage-Rollen. Alternativ können Sie eine benutzerdefinierte Rolle erstellen, die spezifische, eingeschränkte Berechtigungen hat.
Codebeispiele
Sie benötigen die entsprechenden IAM-Berechtigungen, um diesen Leitfaden mit den Cloud Storage-Clientbibliotheken abzuschließen. Wenn Sie den Bucket, auf den Sie zugreifen möchten, nicht erstellt haben, muss Ihnen der Projektinhaber möglicherweise eine Rolle zuweisen, die die erforderlichen Berechtigungen enthält. Sofern nicht anders angegeben, werden Clientbibliotheksanfragen über die JSON API gestellt.
Eine Liste der für bestimmte Aktionen erforderlichen Berechtigungen finden Sie unter IAM-Berechtigungen für JSON-Methoden.
Eine Liste der relevanten Rollen finden Sie unter Cloud Storage-Rollen. Alternativ können Sie eine benutzerdefinierte Rolle erstellen, die spezifische, eingeschränkte Berechtigungen hat.
REST APIs
JSON API
Sie benötigen die entsprechenden IAM-Berechtigungen, um diese Anleitung mit der JSON API abzuschließen. Wenn Sie den Bucket, auf den Sie zugreifen möchten, nicht erstellt haben, muss Ihnen der Projektinhaber möglicherweise eine Rolle zuweisen, die die erforderlichen Berechtigungen enthält.
Eine Liste der für bestimmte Aktionen erforderlichen Berechtigungen finden Sie unter IAM-Berechtigungen für JSON-Methoden.
Eine Liste der relevanten Rollen finden Sie unter Cloud Storage-Rollen. Alternativ können Sie eine benutzerdefinierte Rolle erstellen, die spezifische, eingeschränkte Berechtigungen hat.
Größe eines Buckets ermitteln
Console
So rufen Sie mit dem Metrics Explorer die Messwerte für eine überwachte Ressource auf:
- Rufen Sie in der Google Cloud Console unter „Monitoring“ die Seite „Metrics Explorer” auf.
- Wählen Sie in der Symbolleiste den Tab Explorer aus.
- Wählen Sie den Tab Konfiguration aus.
- Maximieren Sie das Menü Messwert auswählen, geben Sie
Total bytes
in die Filterleiste ein und wählen Sie dann über die Untermenüs einen bestimmten Ressourcentyp und Messwert aus:- Wählen Sie im Menü Aktive Ressourcen die Option GCS-Bucket aus.
- Wählen Sie im Menü Aktive Messwertkategorien die Option Speicher aus.
- Wählen Sie im Menü Aktive Messwerte die Option Bytes insgesamt aus.
- Klicken Sie auf Anwenden.
- Optional: Konfigurieren Sie die Daten, fügen Sie Filter hinzu und verwenden Sie die Menüs Gruppieren nach, Aggregator und Diagrammtyp. Sie können beispielsweise nach Ressourcen- oder Messwertlabels gruppieren. Weitere Informationen finden Sie unter Messwerte bei Verwendung von Metrics Explorer auswählen.
- Optional: Ändern Sie die Diagrammeinstellungen:
- Legen Sie für Kontingente und andere Messwerte, die eine Stichprobe pro Tag melden, den Zeitraum auf mindestens eine Woche fest und geben Sie als Darstellungstyp Übereinander angeordnetes Balkendiagramm an.
- Stellen Sie für Verteilungsmesswerte die Darstellung auf Heatmap-Diagramm ein.
Sie können Metrics Explorer auch verwenden, um andere Bucket-Messwerte zu ermitteln, z. B. storage.googleapis.com/storage/object_count und storage.googleapis.com/storage/total_byte_seconds, die die tägliche Anzahl der genutzten Objekte bzw. den täglich genutzten Speicher messen. Eine vollständige Liste der verfügbaren Messwerte finden Sie in der Dokumentation zu Google Cloud-Messwerten. Weitere Informationen zur Verwendung von Metrics Explorer finden Sie unter Messwerte, Zeitachsen und Ressourcen.
Befehlszeile
Verwenden Sie den Befehl gsutil du
mit dem Flag -s
:
gsutil du -s gs://BUCKET_NAME
Dabei ist BUCKET_NAME
der Name des entsprechenden Buckets.
Die Antwort sieht in etwa so aus:
134620 gs://my-bucket
In diesem Beispiel beträgt die Größe des Buckets mit dem Namen my-bucket
134.620 Byte.
Metadaten eines Buckets aufrufen
Console
- Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.
(Optional): Sie können die in der Bucket-Liste der Google Cloud Console angezeigten Spalten durch Klicken auf das Menü der Spaltenanzeigeoptionen einschränken ().
Suchen Sie den gewünschten Bucket in der Bucket-Liste und prüfen Sie die Spaltenüberschriften auf die Metadaten, die Sie darstellen möchten.
Befehlszeile
Verwenden Sie den folgenden gsutil ls
-Befehl:
gsutil ls -L -b gs://BUCKET_NAME
Dabei ist BUCKET_NAME
der Name des entsprechenden Buckets.
Die Antwort sieht in etwa so aus:
gs://my-bucket/ : Storage class: STANDARD Location constraint: US ...
Codebeispiele
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
Terraform
Sie können die Metadaten eines Buckets mit einer Terraform-Ressource aufrufen.
REST APIs
JSON API
- Rufen Sie ein Zugriffstoken für die Autorisierung aus dem OAuth 2.0 Playground ab. Konfigurieren Sie den Playground so, dass Ihre eigenen OAuth-Anmeldedaten verwendet werden. Eine Anleitung finden Sie unter API-Authentifizierung.
Rufen Sie mithilfe von
cURL
die JSON API mit einerGET
-Bucket-Anfrage auf:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"
Dabei gilt:
OAUTH2_TOKEN
ist der Name des Zugriffstokens, das Sie in Schritt 1 generiert haben.BUCKET_NAME
ist der Name des entsprechenden Buckets. Beispiel:my-bucket
Grenzen Sie die Ergebnisse mithilfe von Abfrageparametern auf die gewünschten Felder ein:
curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=FIELD1%2CFIELD2"
Dabei ist
FIELD#
ein Bucket-Attribut, das Sie in das Ergebnis aufnehmen möchten. Beispiel:location
undstorageClass
Die Antwort sieht in etwa so aus:
{ "location": "US", "storageClass": "STANDARD" }
XML API
- Rufen Sie ein Zugriffstoken für die Autorisierung aus dem OAuth 2.0 Playground ab. Konfigurieren Sie den Playground so, dass Ihre eigenen OAuth-Anmeldedaten verwendet werden. Eine Anleitung finden Sie unter API-Authentifizierung.
Verwenden Sie
cURL
, um die XML API mit einerGET
-Bucket-Anfrage aufzurufen:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME?QUERY_PARAMETER"
Wobei:
OAUTH2_TOKEN
ist der Name des Zugriffstokens, das Sie in Schritt 1 generiert haben.BUCKET_NAME
ist der Name des entsprechenden Buckets. Beispiel:my-bucket
QUERY_PARAMETER
ist das Metadatenfeld, das Sie zurückgeben möchten. Beispiel:location
zum Abrufen des Bucket-Standorts. Sie können jeweils immer nur einen Abfrageparameter mit der XML API verwenden.
Die Antwort sieht in etwa so aus:
<LocationConstraint>US</LocationConstraint>
.
Nächste Schritte
- Übersicht über Bucket-Metadaten
- Objekte in Ihrem Bucket auflisten
- Standardspeicherklasse von Buckets ändern
- Bucket-Labels hinzufügen, entfernen und anzeigen
- Ressourcen in Monitoring überwachen
Jetzt testen
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