Speicherlayout eines Buckets abrufen

Auf dieser Seite wird beschrieben, wie Sie das Speicherlayout Ihres Buckets bestimmen. Das Speicher-Layout bezieht sich darauf, wie Objekte in einem Bucket angeordnet sind, entweder in einer flachen Namespace oder einem hierarchischer Namespace. Das Layout ist wichtig für Anwendungen, die mit dem Bucket interagieren, da sich Objektzugriffs- und -Manipulierungsmethoden unterscheiden je nach Layout. Das Speicherlayout enthält auch Informationen zum Standort des Buckets.

Mit der getStorageLayout API kann Ihre Anwendung ihre Verhalten anpassen, abhängig davon, ob ein Bucket den hierarchischen Namespace verwendet oder nicht, und die optimale Kompatibilität und die Nutzung geeigneter Funktionen basierend auf der Bucket-Konfiguration sicherstellen.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die Rolle Storage-Objekt-Nutzer (roles/storage.objectUser) für den Bucket zuzuweisen, um die erforderlichen Berechtigungen zum Abrufen der Speicherlayouts eines Cloud Storage-Buckets zu erhalten.

Die Rolle enthält die Berechtigung storage.objects.list, die nötig ist, um das Speicherlayout des Buckets abzurufen.

Möglicherweise können Sie diese Berechtigung auch mit anderen benutzerdefinierten Rollen oder vordefinierten Rollen) erhalten. Informationen dazu, welche Rollen mit welchen Berechtigungen verknüpft sind, finden Sie unter IAM-Rollen für Cloud Storage.

Eine Anleitung zum Zuweisen von Rollen für Buckets finden Sie unter IAM mit Buckets verwenden.

Speicherlayout eines Buckets abrufen

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 getStorageLayout-Anfrage aufzurufen:

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/storageLayout"

Dabei ist BUCKET_NAME der Name des entsprechenden Buckets. Beispiel: my-bucket.

Wenn der Vorgang erfolgreich ausgeführt wurde, sieht die Antwort in etwa so aus:

  {
      "kind": "storage#storageLayout",
      "bucket": "my-bucket",
      "location": "us-central1",
      "locationType": "region",
      "hierarchicalNamespace":{enabled: true},
  }

Nächste Schritte

Überzeugen Sie sich selbst

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