Ordner in Buckets mit aktiviertem hierarchischen Namespace

Auf dieser Seite finden Sie Informationen zu Ordnern in Buckets mit aktiviertem hierarchischen Namespace.

Übersicht

Ordner sind eine Ressource in Buckets mit aktiviertem hierarchischen Namespace. Sie können Objekte in Ordnern in einer Dateisystem-ähnlichen Struktur organisieren. Cloud Storage bietet APIs zur Ordnerverwaltung, die Vorgänge wie Erstellen, Löschen, Umbenennen und Auflisten von Ordnern sowie Abrufen von Ordnern-Metadaten ermöglichen.

Ordnermetadaten

Die Metadaten eines Ordners enthalten strukturierte Informationen zu diesem Ordner. Ausführliche Informationen zu Ordnermetadaten finden Sie in der Referenzdokumentation zur Cloud Storage JSON API unter Folder.

Die wichtigsten Komponenten von Ordnermetadaten sind:

  • bucket: Der Name des Buckets, in dem sich der Ordner befindet. Beispiel: my-bucket.
  • id: Eine eindeutige Kennung für den Ordner im Bucket. Beispiel: hns-bucket/dir1/.
  • kind ist der Ressourcentyp. Bei einem Ordner ist dieser Wert immer storage#folder.
  • name: Der Name des Ordners. Beispiel: dir1/.
  • selfLink: Eine URL, die auf den Ordner in der Cloud Storage API verweist.
  • timeCreated: Der Zeitstempel, der angibt, wann der Ordner erstellt wurde. Beispiel: 2023-05-05T16:32:08.878000+00:00.
  • updated: Der Zeitstempel, der angibt, wann die Ordner zuletzt aktualisiert wurde. Beispiel: 2024-05-06T16:32:08.878000+00:00.

Hinweise

Beachten Sie beim Erstellen von Ordnern Folgendes:

  • Objekt- und Ordnernamen: Buckets mit aktiviertem hierarchischen Namespace unterstützen alle gültigen Objektnamen, einschließlich der mit voran- oder nachgestellten Schrägstrichen (/) oder aufeinanderfolgenden Schrägstrichen. Jeder Schrägstrich (/) in einem Objektnamen steht für einen Ordner. Die folgende Tabelle enthält Beispiele für die Beziehung zwischen Objektnamen und deren zugehöriger Position in der Ordnerhierarchie:

    Objektname Speicherort in der Ordnerhierarchie
    foo.txt Jeder Bucket enthält einen Stammordner. Objekt foo.txt befindet sich im Stammverzeichnis des Buckets.
    dir1/foo.txt Das Objekt foo.txt befindet sich in einem übergeordneten Ordner namens dir1/. Der Ordner der obersten Ebene unterscheidet sich vom Stammordner.
    dir1/ Der abschließende Schrägstrich in Objektnamen wie dir1/ gibt an, dass sich das Objekt im Ordner befindet. In diesem Beispiel ist der Objektname dir1/ mit dem Namen des übergeordneten Ordners dir1/ identisch.
    dir1//foo.txt Das Objekt foo.txt befindet sich in einem Ordner der zweiten Ebene mit dem Namen dir1//, der ein untergeordneter Ordner von dir1/ ist.

  • Maximale Ordnertiefe: Buckets mit aktiviertem hierarchischen Namespace unterstützen eine maximale Ordnertiefe von 50. Daher dürfen Objektnamen keine mehr als 50 Schrägstriche (/) enthalten.

  • Maximale Größe des Ordnernamens: 512 Byte (UTF-8-codiert).

  • Automatische Ordnererstellung: Beim Erstellen eines neuen Objekts werden automatisch Alle nicht vorhandenen Ordner, die im Pfad des Objekts angegeben sind, erstellt. Beispiel: Wenn Sie ein Objekt mit dem Namen dir1/foo.txt erstellen, wird der Ordner dir1/ automatisch erstellt, sofern noch nicht vorhanden.

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