Object Storage-Objekte in einem Bucket suchen

Suchen Sie nach Objekten in einem Object Storage-Bucket.

Sie können nach Objekten in einem Bucket suchen, indem Sie mindestens ein Zeichen eingeben, das mit den Namenspräfixen der Objekte übereinstimmt. Beispiel: Wenn Sie 100 Objekte in einem Bucket hatten und 10 davon mit "test" gestartet wurden, zeigt die Eingabe von "test" im Feld Nach Präfix suchen der Konsole nur das Objekt mit diesem "Test"-Präfix an. Verwenden Sie den Parameter prefix, wenn Sie dieselbe Funktion mit der CLI oder API ausführen. Weitere Informationen zur Verwendung der Präfixfunktion mit einem Objekt finden Sie unter Objektbenennung mit Präfixen und Hierarchien.

Die Suche nach einem Objekt in einem Bucket mit einer anderen Methode, wie z.B. die Verwendung von Segmenten im Namen eines Objekts oder die Verwendung von Platzhaltern ("*"), wird nicht unterstützt.

Hinweis

Die Suche nach Objekten in Buckets oder Präfixen mit einer hohen Objektanzahl kann aufgrund von Sessiontimeouts, Browserspeicherauslastung oder anderen Problemen nicht mehr reagieren. Timeout-Sessions für Konsolensessions werden normalerweise vom Cloud-Administrator festgelegt und können auf fünf Minuten gesetzt werden. Dies ist weniger Zeit für die Suche durch eine hohe Anzahl von Objekten.

Wir empfehlen die Suche mit der CLI oder API. Sie können hier auf ein python-Beispielskript zugreifen.

    1. Wählen Sie auf der Listenseite Buckets den Objektspeicher-Bucket aus, mit dem Sie arbeiten möchten. Wenn Sie Hilfe bei der Suche nach der Listenseite oder dem Objektspeicher-Bucket benötigen, finden Sie weitere Informationen unter Buckets auflisten.
    2. Wählen Sie auf der Detailseite Objekte aus.
    3. Geben Sie die Zeichen ein, nach denen die Objekte durchsucht werden sollen, in das Feld Nach Präfix suchen ein, und wählen Sie Eingabe aus.

    Alle Objekte, deren Namenspräfix mit den eingegebenen Zeichen übereinstimmt, werden in der Liste Objekte angezeigt. Je mehr Zeichen Sie eingeben, dass die Objektnamen übereinstimmen müssen, desto kleiner und genauer ist die Anzahl der zurückgegebenen Objekte.

    Um alle Objekte im Bucket anzuzeigen, deaktivieren Sie Nach Präfix suchen, und wählen Sie Eingabe aus.

  • Verwenden Sie den Befehl oci os object list und die erforderlichen Parameter, um die Objekte in einem Bucket aufzulisten. Nehmen Sie den Parameter prefix und den Präfixwert auf, mit dem die zurückgegebenen Objektnamen übereinstimmen müssen.

    oci os object list --bucket-name bucket_name --prefix prefix --query "data[?\"name\" == 'prefix/file name'].[*] [OPTIONS]

    Beispiel:

    oci os object list --bucket-name MyBucket --prefix myprefix --query "data[?\"name\" == 'myprefix/file1'].[*]"
    [
      [
        [ 
          "myprefix/file1",
          31457280,
          "/Ab1c2defGhi0JkLM3N4op==",
          "2025-01-23T21:41:17.046000+00:00",
          "12a3c3d4-567e-89f0-g123-h456783b9ad97",
          "Standard",
          "2025-01-23T21:41:17.046000+00:00"
        ]
      ]
    ]

    In der Rückgabe werden nur Objekte angezeigt, deren Namen mit dem Präfixwert übereinstimmen, den Sie in den Befehl aufgenommen haben.

    Wenn Sie nach einer Gruppe von Dateien mit einer ähnlichen Zeichenfolge suchen, verwenden Sie Folgendes:

    oci os object list --bucket-name bucket_name --prefix prefix --query "data[?contains(\"name\",'string')].[*]" [OPTIONS]

    Beispiel:

    oci os object list --bucket-name MyBucket --prefix myprefix --query "data[?contains(\"name\",'txt')].[*]"
    [
      [
        [
          "dir1/file.txt",
          4,
          "aBcdeFGhiJ+FkxgpvF/FUg==",
          "2025-01-23T21:34:20.551000+00:00",
          "abcdef12-bdce-3456-7c23-75646d059894",
          "Standard",
          "2025-09-19T21:34:20.551000+00:00"
        ]
      ],
      [
        [
          "dir1/foo.txt",
          4,
          "xYzabCDefG+HixgpvF/FAg==",
          "2025-09-19T21:34:20.551000+00:00",
          "12a3b456-3ee3-43db-a429-e6ce54e12fab",
          "Standard",
          "2025-09-19T21:34:20.551000+00:00"
        ]
      ],
      [
        [
          "dir1/bar.txt",
          4,
          "LMnopqrsTUVfTy1ZzLGtoeg==",
          "2025-09-19T21:34:20.565000+00:00",
          "a123b09f-faa3-4c52-a410-5e8c530ab1c2",
          "Standard",
          "2025-09-19T21:34:20.565000+00:00"
        ]
      ]
    ]

    Eine vollständige Liste der Parameter und Werte für CLI-Befehle finden Sie in der CLI-Befehlsreferenz.

  • Führen Sie den Vorgang ListObjects aus, um die Objekte in einem Bucket aufzulisten. Nehmen Sie den Parameter prefix und den Präfixwert auf, mit dem die zurückgegebenen Objektnamen übereinstimmen müssen.

    Beim Erstellen einer URL zur Verwendung mit der API fügt Object Storage die Object Storage-Namespace-Zeichenfolge und den Bucket-Namen an:

    /n/object_storage_namespace/b/bucket/o/object_name

    Der Objektname umfasst alles nach dem /o/, was Hierarchieebenen und Präfixzeichenfolgen beinhalten kann.