Ordner in Buckets mit aktiviertem hierarchischen Namespace

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

Übersicht

Wenn Sie einen Bucket mit aktiviertem hierarchischen Namespace erstellen, verwendet der Bucket eine echte Dateisystemstruktur im Gegensatz zu einem standardmäßigen flachen Namespace. Ordner sind in Buckets mit aktiviertem hierarchischen Namespace als Ressource vorhanden. Mit Ordnern können Sie Ihre Objekte effektiver organisieren und auf echte Verzeichnisfunktionen zugreifen, z. B. atomare Ordnerumbenennungen und effiziente Metadatenvorgänge.

Sie können Ordner mit den Vorgängen zum Erstellen, Löschen, Umbenennen, Auflisten und Abrufen verwalten. Informationen zum Ausführen dieser Vorgänge finden Sie unter Ordner erstellen und verwalten und Ordner umbenennen.

Ordner in Buckets mit aktiviertem hierarchischen Namespace unterscheiden sich von simulierten und verwalteten Ordnern. Simulierte Ordner sind in Buckets mit flachem Namespace vorhanden. Verwaltete Ordner können sowohl in Buckets mit flachem Namespace als auch in Buckets mit aktiviertem hierarchischen Namespace verwendet werden. Verwaltete Ordner werden hauptsächlich verwendet, um IAM-Berechtigungen für Gruppen von Objekten zu erteilen. Weitere Informationen zu diesen anderen Ordnerarten finden Sie unter Ordnerarten.

Ordner-Metadaten

Die Metadaten eines Ordners enthalten strukturierte Informationen zum Ordner. Detaillierte Informationen zu Ordner-Metadaten finden Sie in der Referenzdokumentation zur Cloud Storage JSON API unter der Ressource Folder.

Die wichtigsten Komponenten von Ordner-Metadaten sind:

  • bucket: Der Name des Buckets, in dem sich der Ordner befindet. Beispiel: my-bucket.
  • id: Eine eindeutige ID für den Ordner im Bucket. Beispiel: hns-bucket/dir1/.
  • kind ist der Ressourcentyp. Für einen 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 stellt einen Ordner dar. Die folgende Tabelle enthält Beispiele für die Beziehung zwischen Objektnamen und deren zugehöriger Position in der Ordnerhierarchie:

    Objektname Position in der Ordnerhierarchie
    foo.txt Jeder Bucket enthält einen Stammordner. Das Objekt foo.txt befindet sich im Stammordner des Buckets.
    dir1/foo.txt Das Objekt foo.txt befindet sich in einem Ordner der obersten Ebene mit dem Namen dir1/. Der Ordner der obersten Ebene unterscheidet sich vom Stammordner.
    dir1/ Der nachgestellte 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//, einem untergeordneten Ordner von dir1/.

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

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

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

  • Vertrauliche oder personenidentifizierbare Informationen (PII): Ordnernamen sind allgemeiner sichtbar als Ordner-Metadaten. Ordnernamen werden beispielsweise in URLs und beim Auflisten von Ordnern oder Objekten in einem Bucket angezeigt. Ordnernamen sollten keine vertraulichen Informationen oder PII enthalten.

  • Interaktion mit verwalteten Ordnern: In Buckets mit aktiviertem hierarchischem Namespace können Sie die Zugriffssteuerung verwalten, indem Sie verwaltete Ordner in Verbindung mit Ordnern verwenden.

Nächste Schritte