Bucket-Metadaten abrufen (original) (raw)

Auf dieser Seite wird beschrieben, wie Sie Informationen zu den Metadaten Ihrer Cloud Storage-Buckets abrufen, mit Ausnahme von IAM-Richtlinien und ACLs.

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:

Console

  1. Wechseln Sie in der Google Cloud Console unter „Cloud Storage“ zur Seite Buckets.
    Buckets aufrufen
  2. Klicken Sie in der Bucket-Liste auf den Namen des Buckets, dessen Metadaten Sie aufrufen möchten.
  3. 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:

Wenn der Vorgang erfolgreich war, sieht die Antwort in etwa so aus:

defaultEventBasedHold: false etag: CAE= iamConfiguration: bucketPolicyOnly: enabled: true ...

Clientbibliotheken

Terraform

Sie können die Metadaten eines Buckets mit einer Terraform-Ressource aufrufen.

REST APIs

JSON-API

  1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Authorization-Header zu generieren.
  2. Verwenden Sie cURL, um die JSON API mit einer GET-Bucket-Anfrage aufzurufen:
    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://storage.googleapis.com/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.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: projectNumber und storageClass

Die Antwort sieht in etwa so aus:

{ "projectNumber": "123456789012", "storageClass": "STANDARD" }

XML API

  1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Authorization-Header zu generieren.
  2. Verwenden Sie cURL zum Aufrufen der XML API mit einer GET Bucket-Anfrage:
    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://storage.googleapis.com/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 für GET-Buckets.
      Die Antwort sieht in etwa so aus:<StorageClass>STANDARD</StorageClass>.