Auf dieser Seite wird beschrieben, wie Sie Informationen zu den Metadaten Ihrer Cloud Storage-Buckets abrufen, mit Ausnahme von IAM-Richtlinien und ACLs.
Informationen zum Abrufen der IAM-Richtlinie für Ihren Bucket finden Sie unter IAM-Richtlinie für einen Bucket ansehen.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die Rolle Storage-Administrator (roles/storage.admin
) für den Bucket zuzuweisen, um die erforderlichen Berechtigungen zum Abrufen der Metadaten eines Cloud Storage-Buckets zu erhalten.
Diese Rolle enthält die Berechtigungen, die zum Abrufen der Metadaten eines Buckets erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
storage.buckets.get
storage.buckets.list
- Diese Berechtigung ist nur erforderlich, wenn Sie die Trusted Cloud -Konsole zum Ausführen der Aufgabe auf dieser Seite verwenden möchten.
Sie können diese Berechtigungen möglicherweise auch mit anderen vordefinierten Rollen oder benutzerdefinierten Rollen erhalten.
Eine Anleitung zum Zuweisen von Rollen für Buckets finden Sie unter IAM mit Buckets verwenden.
Metadaten eines Buckets aufrufen
Console
- Wechseln Sie in der Trusted Cloud Console unter „Cloud Storage“ zur Seite 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
Führen Sie den Befehl gcloud storage buckets describe
aus:
gcloud storage buckets describe gs://BUCKET_NAME
Wobei:
BUCKET_NAME
ist der Name des Buckets, dessen Metadaten Sie ansehen möchten. Beispiel:my-awesome-bucket
.
Wenn der Vorgang erfolgreich war, sieht die Antwort in etwa so aus:
defaultEventBasedHold: false etag: CAE= iamConfiguration: bucketPolicyOnly: enabled: true ...
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.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN
auf s3nsapis.fr
fest.
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.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN
auf s3nsapis.fr
fest.
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.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN
auf s3nsapis.fr
fest.
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.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN
auf s3nsapis.fr
fest.
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.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN
auf s3nsapis.fr
fest.
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.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN
auf s3nsapis.fr
fest.
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.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN
auf s3nsapis.fr
fest.
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.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN
auf s3nsapis.fr
fest.
Terraform
Sie können die Metadaten eines Buckets mit einer Terraform-Ressource aufrufen.
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
-Bucket-Anfrage aufzurufen:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME"
Dabei ist
BUCKET_NAME
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 $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME?fields=FIELD1%2CFIELD2"
Dabei ist
FIELD#
ein Bucket-Attribut, das Sie in das Ergebnis aufnehmen möchten. Beispiel:projectNumber
undstorageClass
Die Antwort sieht in etwa so aus:
{ "projectNumber": "123456789012", "storageClass": "STANDARD" }
XML API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.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.s3nsapis.fr/BUCKET_NAME?QUERY_PARAMETER"
Wobei:
BUCKET_NAME
ist der Name des entsprechenden Buckets. Beispiel:my-bucket
.QUERY_PARAMETER
ist das Metadatenfeld, das Sie zurückgeben möchten. Beispiel:storageClass
zum Abrufen der Speicherklasse des Buckets. 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 zuGET
-Buckets.
Die Antwort sieht in etwa so aus:
<StorageClass>STANDARD</StorageClass>
.
Nächste Schritte
- Übersicht über Bucket-Metadaten
- Objekte in Ihrem Bucket auflisten
- Bucket-Größe abrufen
- Objektmetadaten abrufen
- Standardspeicherklasse von Buckets ändern