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 anstelle eines standardmäßigen flachen Namespaces. Ordner sind eine Ressource in Buckets mit aktiviertem hierarchischen Namespace. 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 „create“, „delete“, „rename“, „list“ und „get“ 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 Ordnern 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. Ausführliche Informationen zu Ordner-Metadaten finden Sie in der Folder-Ressource in der Referenzdokumentation zur Cloud Storage JSON API.

Die wichtigsten Komponenten von Ordner-Metadaten 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. 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.

Ordneraktionen

In diesem Abschnitt werden die Vorgänge beschrieben, die Sie für Ordner ausführen können.

Ordner erstellen

Sie können Ordner explizit mit dem Vorgang zum Erstellen von Ordnern erstellen. Wenn Sie ein Objekt erstellen und einen nicht vorhandenen Ordner im Pfad angeben, wird der fehlende übergeordnete Ordner automatisch für Sie erstellt. Wenn Sie beispielsweise ein Objekt mit dem Namen dir1/foo.txt erstellen, wird der Ordner dir1/ automatisch erstellt, sofern noch nicht vorhanden.

Informationen zur Ordnerbenennung finden Sie unter Hinweise.

Ordner auflisten

Mit dem Vorgang „list folders“ können Sie eine Liste der Ordner in Ihrem Bucket abrufen. Da Ordner in Buckets mit aktiviertem hierarchischen Namespace separate Ressourcen sind, wird bei diesem Vorgang die tatsächliche Ordnerstruktur ausgewertet, anstatt Ordner aus Objektpfaden zu simulieren.

Beim Auflisten von Ordnern können Sie die Ergebnisse mit Parametern wie prefix, delimiter, lexicographicStart und lexicographicEnd filtern. Wenn Sie den Parameter „delimiter“ beispielsweise auf / festlegen, können Sie Ordner in einem verzeichnisähnlichen Modus auflisten. Es werden dann nur die Ordner zurückgegeben, die mit dem Präfix übereinstimmen oder sich eine Ebene darunter befinden.

Der Vorgang zum Auflisten von Ordnern gibt paginierte Ergebnisse zurück. Eine einzelne Antwortseite kann maximal 1.000 Ordner enthalten.

Metadaten eines Ordners abrufen

Sie können die Eigenschaften eines Ordners mit dem Vorgang „Ordner-Metadaten abrufen“ abrufen. Bei diesem Vorgang werden Informationen zur Ordnerressource selbst und nicht zu den darin enthaltenen Objekten abgerufen.

Dieser Vorgang gibt die Metadaten eines Ordners zurück, die strukturierte Informationen wie den Zeitstempel der Erstellung, die eindeutige Kennung und den Bucket enthalten, in dem sich der Ordner befindet. Eine detaillierte Liste der von diesem Vorgang zurückgegebenen Eigenschaften finden Sie unter Ordner-Metadaten.

Ordner umbenennen oder verschieben

Das Umbenennen und Verschieben eines Ordners basiert auf demselben zugrunde liegenden Vorgang. Der Vorgang ist eine atomare Änderung, die nur Metadaten betrifft. Dabei wird der Pfad des Ordners aktualisiert, ohne die zugrunde liegenden Objekte physisch zu kopieren oder zu löschen. Wenn Sie einen Ordner umbenennen, wird auch der Pfad des Ordners für Ressourcen im Ordner aktualisiert, z. B. für untergeordnete Ordner, Objekte und verwaltete Ordner. Dadurch wird der Vorgang beschleunigt und es fallen keine Kosten für das Kopieren von Objekten an.

In der JSON API und der Google Cloud CLI wird für das Umbenennen und Verschieben derselbe URL-Endpunkt oder Befehl verwendet. In der Google Cloud Console werden Ordner umbenennen und Ordner verschieben als zwei separate Optionen angezeigt, aber beide führen denselben Backend-Vorgang aus.

Während des Umbenennens eines Ordners können Sie die umzubenennenden Ordner lesen und auflisten, aber keine Schreibvorgänge für sie ausführen.

Durch das Umbenennen des Ordners wird ein Vorgang mit langer Ausführungszeit initiiert.

Ordner löschen

Sie können einen leeren Ordner endgültig löschen, indem Sie den Vorgang zum Löschen von Ordnern verwenden. Ordner können zwar automatisch bei Objektvorgängen erstellt werden, sie werden aber nicht automatisch entfernt, wenn sie leer werden. Sie müssen sie explizit löschen.

Wenn Sie einen Ordner löschen, der einen verwalteten Ordner am selben Pfad hat, wird auch der verwaltete Ordner gelöscht.

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. 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 namens 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/ derselbe wie der Name des übergeordneten Ordners dir1/.
    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 hierarchischen Namespace unterstützen eine maximale Ordnerstruktur von 50. Daher dürfen Objektnamen keine mehr als 50 Schrägstriche (/) enthalten.

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

  • 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 dürfen keine vertraulichen Informationen oder personenidentifizierbaren Informationen enthalten.

  • Interaktion mit verwalteten Ordnern: In Buckets mit aktiviertem hierarchischen Namespace können Sie die Zugriffssteuerung mit verwalteten Ordnern in Verbindung mit Ordnern verwalten.

Nächste Schritte

Überzeugen Sie sich selbst

Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um sich von der Leistungsfähigkeit von Cloud Storage in der Praxis zu überzeugen. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

Cloud Storage kostenlos testen