Speicherlayout eines Buckets abrufen

Auf dieser Seite wird beschrieben, wie Sie das Speicher-Layout 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 Speicher-Layout 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.

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

  1. Installieren und initialisieren Sie die gcloud CLI installed and initialized, um ein Zugriffstoken für den Authorization Header zu generieren.

  2. 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.s3nsapis.fr/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