Diese Seite wurde von der Cloud Translation API übersetzt.

Speicherlayout eines Buckets abrufen

Auf dieser Seite wird beschrieben, wie Sie das Speicherlayout Ihres Buckets ermitteln. 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 Speicherort 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

Befehlszeile

Verwenden Sie den Befehl gcloud alpha storage buckets describe mit dem Flag --format:

gcloud alpha storage buckets describe gs://BUCKET_NAME --raw --format="default(hierarchicalNamespace)"

Dabei gilt:

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

Wenn der erfolgreiche und hierarchische Namespace aktiviert ist, sieht die Antwort in etwa so aus:

  hierarchicalNamespace:
    enabled: true

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 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