Création d’une liste des index vectoriels - Amazon Simple Storage Service
Fonctionnalité de recherche de préfixe

Création d’une liste des index vectoriels

Note

Amazon S3 Vectors est en version préliminaire pour Amazon Simple Storage Service et sujet à modification.

Vous pouvez afficher tous les index vectoriels contenus dans un compartiment de vecteur. L’opération de liste prend en charge le filtrage basé sur les préfixes pour vous aider à rechercher des index spécifiques lorsqu’un compartiment contient de nombreux index. Pour plus d’informations sur les ListIndexes, les limites de préfixes et de réponse, consultez ListIndexes dans la Référence des API Amazon Simple Storage Service.

Fonctionnalité de recherche de préfixe

La recherche par préfixe vous permet de répertorier les index commençant par un préfixe spécifique, ce qui facilite l’organisation et la recherche des index vectoriels associés. Cette fonctionnalité est particulièrement utile lorsque vous utilisez des conventions de dénomination qui regroupent des index connexes :

  • Par type de données : text-embeddings-, image-features-, audio-vectors-

  • Par modèle : model1-embeddings-, model2-vectors-, custom-model-

  • Par cas d’utilisation : search-index-, recommendation-, similarity-

  • Par environnement : prod-vectors-, staging-vectors-, dev-vectors-

Pour répertorier les index de vecteur

  1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon S3 à l’adresse https://console.aws.amazon.com/s3/.

  2. Dans le volet de navigation de gauche, choisissez Compartiments de vecteur.

  3. Dans la liste des compartiments de vecteur, choisissez le nom du compartiment qui contient les index que vous souhaitez afficher.

  4. La console affiche une liste complète de tous les index de vecteur du compartiment, notamment :

    • Nom : nom de chaque index.

    • Date de création : date à laquelle l’index a été créé.

    • Amazon Resource Name (ARN) : ARN complet pour chaque index.

Pour filtrer la liste

  1. Saisissez un nom ou un préfixe d’index dans le champ de recherche situé au-dessus de la liste d’index. Utilisez des préfixes pour rechercher des groupes d’index connexes.

  2. La liste est mise à jour en temps réel à mesure que vous tapez.

Pour utiliser l’exemple suivant, remplacez les espaces réservés à la saisie utilisateur par vos propres informations.

Pour répertorier les index dotés d’un préfixe spécifique dans un compartiment de vecteur

Exemple de demande :


aws s3vectors list-indexes \
  --vector-bucket-name "amzn-s3-demo-bucket" \
  --prefix "idx" \
  --max-results 1

Exemple de réponse :

{
    "nextToken": "lObb29ZkzxMGtBXs97Rkbs26xdtKemu4brsnq2jX8DCocADkILv5cRphemXS3PXXFnQBihQBmESgEeKaGA",
    "indexes": [
        {
            "vectorBucketName": "amzn-s3-demo-bucket",
            "indexName": "idx",
            "indexArn": "arn:aws:s3vectors:aws-region:111122223333:bucket/amzn-s3-demo-vector-bucket/index/idx",
            "creationTime": "2025-06-12T15:50:23+00:00"
        }
    ]
}

Pour répertorier les index avec pagination

Exemple de demande :

aws s3vectors list-indexes \
  --vector-bucket-name "amzn-s3-demo-bucket" \
  --prefix "idx" \
  --next-token "lObb29ZkzxMGtBXs97Rkbs26xdtKemu4brsnq2jX8DCocADkILv5cRphemXS3PXXFnQBihQBmESgEeKaGA"

Exemple de réponse : 

{
    "indexes": [
        {
            "vectorBucketName": "amzn-s3-demo-bucket",
            "indexName": "idx2",
            "indexArn": "arn:aws:s3vectors:aws-region:111122223333:bucket/amzn-s3-demo-vector-bucket/index/idx2",
            "creationTime": "2025-06-12T15:45:37+00:00"
        }
    ]
}