Recherche d'objets Object Storage dans un bucket

Recherchez des objets dans un bucket Object Storage.

Vous pouvez rechercher des objets dans un bucket en entrant des caractères correspondant aux préfixes de nom des objets. Par exemple, si vous avez 100 objets dans un bucket et que 10 d'entre eux ont commencé par "test", la saisie de "test" dans la zone Rechercher par préfixe de la console affiche uniquement les objets avec ce préfixe "test". Utilisez le paramètre prefix lorsque vous utilisez l'interface de ligne de commande ou l'API pour exécuter la même fonction. Pour plus d'informations sur l'utilisation de la fonctionnalité de préfixe avec un objet, reportez-vous à Dénomination des objets à l'aide de préfixes et de hiérarchies.

La recherche d'un objet dans un bucket à l'aide d'une autre méthode, telle que l'utilisation de segments dans le nom d'un objet ou l'utilisation de caractères génériques ("*"), n'est pas prise en charge.

Remarque

La recherche d'objets dans des buckets ou des préfixes avec un nombre d'objets élevé peut cesser de répondre en raison des délais d'attente de session, de la consommation de mémoire du navigateur ou d'autres problèmes. Les sessions de délai d'expiration de session de console sont généralement définies par l'administrateur cloud et peuvent prendre jusqu'à cinq minutes, ce qui réduit le temps nécessaire à la recherche d'un grand nombre d'objets.

Nous vous recommandons d'effectuer une recherche à l'aide de l'interface de ligne de commande ou de l'API. Vous pouvez accéder à un exemple de script python ici.

1. Sur la page de liste Buckets, sélectionnez le bucket Object Storage à utiliser. Si vous avez besoin d'aide pour rechercher la page de liste ou le bucket Object Storage, reportez-vous à Liste des buckets.
2. Sur la page de détails, sélectionnez Objets.
3. Entrez les caractères à rechercher dans les objets dans la zone Rechercher par préfixe et sélectionnez Entrée.
Tous les objets dont le préfixe de nom correspond aux caractères que vous avez saisis apparaissent dans la liste Objets. Plus vous entrez de caractères pour que les noms d'objet correspondent, plus le nombre d'objets renvoyés est petit et précis.

Pour afficher tous les objets du bucket, désélectionnez Rechercher par préfixe et sélectionnez Entrée.

Utilisez la commande oci os object list et les paramètres requis pour répertorier les objets d'un bucket. Incluez le paramètre prefix et la valeur de préfixe que les noms d'objet renvoyés doivent correspondre.

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

Par exemple :

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

Seuls les objets dont le nom correspond à la valeur de préfixe que vous avez incluse dans la commande sont affichés dans le retour.

Lorsque vous recherchez un groupe de fichiers avec une chaîne similaire, utilisez ce qui suit :

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

Par exemple :

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

Pour obtenir la liste complète des paramètres et des valeurs des commandes de la CLI, reportez-vous à Référence des commandes de la CLI.

Exécutez l'opération ListObjects pour répertorier les objets d'un bucket. Incluez le paramètre prefix et la valeur de préfixe que les noms d'objet renvoyés doivent correspondre.

Object Storage ajoute la chaîne d'espace de noms Object Storage et le nom du bucket au début du nom d'objet lors de la construction d'une URL à utiliser avec l'API:
```
/n/object_storage_namespace/b/bucket/o/object_name
```
Le nom d'objet correspond à tout ce qui suit /o/, ce qui peut inclure des niveaux hiérarchiques et des chaînes de préfixe.

Documentation Oracle Cloud Infrastructure

Recherche d'objets Object Storage dans un bucket