Auf dieser Seite wird beschrieben, wie Sie Informationen über die Größe und Metadaten von Cloud Storage-Buckets abrufen können.
Erforderliche Berechtigungen
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.
Clientbibliotheken
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 und benötigen die unter IAM-Berechtigungen für JSON-Methoden aufgeführten Berechtigungen. Um zu erfahren, welche JSON API-Methoden aufgerufen werden, wenn Sie Anfragen über eine Clientbibliothek stellen, können Sie die Rohanfragen protokollieren.
Eine Liste der relevanten IAM-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.
- Maximieren Sie im Bereich Messwert auswählen das Menü Messwert, geben Sie in die Filterleiste
Total bytes
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 und Gruppierungen hinzu und konfigurieren Sie die Ausrichtungsfelder. Standardmäßig fügt der Metrics Explorer eine Gruppierung hinzu, die einen Durchschnitt aller Zeitachsen ermittelt:
- Wenn Sie Zeitachsen nach Ressourcen- oder Messwertlabels gruppieren möchten, maximieren Sie im Abschnitt Gruppieren nach das Menü Labels und treffen Sie eine Auswahl. Sie können auch die Gruppierungsfunktion ändern.
- Klicken Sie im Eintrag Gruppieren nach auf deleteLöschen, um alle Zeitachsen anzuzeigen.
- Klicken Sie auf Weitere Optionen, um auf die Ausrichtungsfelder zuzugreifen.
- Optional: Ändern Sie die Einstellungen im Bereich Display:
- Legen Sie für Kontingente und andere Messwerte, die eine Stichprobe pro Tag melden, den Widgettyp auf Übereinander angeordnetes Balkendiagramm fest.
- Stellen Sie für Verteilungsmesswerte den Widget-Typ auf Heatmap-Diagramm ein.
- Optional: Legen Sie für Kontingente und andere Messwerte, die eine Stichprobe pro Tag melden, den Zeitraum auf mindestens eine Woche fest.
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.
Klicken Sie in der Bucket-Liste auf den Namen des Buckets, dessen Metadaten Sie aufrufen möchten.
Klicken Sie auf den Tab Konfiguration, um Bucket-Details wie die enthaltenen Regionen, die Speicherklasse, die Berechtigungen und den Replikationstyp aufzurufen.
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 type: multi-region Location constraint: US ...
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.
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.
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.
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.
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.
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.
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.
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.
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
.
Optional können Sie die Metadatenergebnisse mit dem Abfragestringparameter
fields
eingrenzen. Beispiele: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. Eine Liste der von der XML API unterstützten Metadatenfelder finden Sie auf der Referenzseite fürGET
-Buckets.
Die Antwort sieht in etwa so aus:
<LocationConstraint>US</LocationConstraint>
.
Nächste Schritte
- Übersicht über Bucket-Metadaten
- Objekte in Ihrem Bucket auflisten
- Objektmetadaten abrufen
- Standardspeicherklasse von Buckets ändern
- 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