Oracle Cloud Infrastructureドキュメント

バケット内のオブジェクト・ストレージ・オブジェクトの検索

オブジェクト・ストレージ・バケット内のオブジェクトを検索します。

バケット内のオブジェクトを検索するには、オブジェクトの名前接頭辞に一致する1つ以上の文字を入力します。たとえば、バケットに100個のオブジェクトがあり、そのうち10個がtestで起動した場合、コンソールの「接頭辞で検索」ボックスにtestと入力すると、そのtest接頭辞を持つオブジェクトのみが表示されます。CLIまたはAPIを使用して同じ機能を実行する場合は、prefixパラメータを使用します。オブジェクトで接頭辞機能を使用する方法の詳細は、接頭辞および階層を使用したオブジェクト・ネーミングを参照してください。

オブジェクト名内のセグメントの使用やワイルドカード(*)の使用など、他の方法を使用したバケット内のオブジェクトの検索はサポートされていません。

ノート

バケットまたは接頭辞でオブジェクト数が多いオブジェクトを検索すると、セッション・タイムアウト、ブラウザのメモリー消費またはその他の問題により、応答が停止する可能性があります。コンソール・セッション・タイムアウト・セッションは通常、クラウド管理者によって設定され、5分以内に設定される場合があります。これは、多数のオブジェクトの検索にかかる時間を短縮します。

CLIまたはAPIを使用して検索することをお薦めします。ここからpythonスクリプトの例にアクセスできます。

    1. 「バケット」リスト・ページで、操作するオブジェクト・ストレージ・バケットを選択します。リスト・ページまたはオブジェクト・ストレージ・バケットの検索に関するヘルプが必要な場合は、バケットのリストを参照してください。
    2. 詳細ページで「オブジェクト」を選択します。
    3. 「接頭辞で検索」ボックスに、オブジェクトを検索する文字を入力し、「入力」を選択します。

    名前の接頭辞が入力した文字と一致するすべてのオブジェクトが、「オブジェクト」リストに表示されます。入力する文字数が多いほど、オブジェクト名が一致する必要があり、返されるオブジェクトの数は小さくなります。

    バケット内のすべてのオブジェクトを表示するには、「接頭辞で検索」をクリアし、「入力」を選択します。

  • バケット内のオブジェクトをリストするには、oci os object listコマンドと必要なパラメータを使用します。prefixパラメータと、返されるオブジェクト名が一致する必要がある接頭辞値を含めます。

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

    例:

    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"
    ]
  ]
]

    名前がコマンドに指定した接頭辞値と一致するオブジェクトのみが戻り値に表示されます。

    類似した文字列を含むファイルのグループを検索する場合は、次を使用します。

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

    例:

    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"
    ]
  ]
]

    CLIコマンドのパラメータおよび値の完全なリストは、CLIコマンド・リファレンスを参照してください。

  • ListObjects操作を実行して、バケット内のオブジェクトをリストします。prefixパラメータと、返されるオブジェクト名が一致する必要がある接頭辞値を含めます。

    オブジェクト・ストレージは、APIで使用するURLを作成する際に、オブジェクト・ストレージ・ネームスペース文字列とバケット名をオブジェクト名の先頭に付加します:

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

    オブジェクト名は、/o/の後のすべてになります。これには、階層レベルおよび接頭辞文字列を含めることができます。