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

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Création d’une liste des index vectoriels

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 ListIndexes les limites de préfixes et les limites de réponse, consultez le ListIndexesmanuel Amazon Simple Storage Service API Reference.

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 console Amazon S3 AWS Management Console et ouvrez-la à 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.

Utilisez les exemples de commandes suivants et remplacez-les user input placeholders 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"
        }
    ]
}
SDK for Python
import boto3

# Create a S3 Vectors client in the AWS Region of your choice. 
s3vectors = boto3.client("s3vectors", region_name="us-west-2")

#List vector indexes in your vector bucket
response = s3vectors.list_indexes(vectorBucketName="media-embeddings")
indexes = response["indexes"]
print(indexes)