Répertorier les index vectoriels

Note

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

Vous pouvez afficher tous les index vectoriels contenus dans un compartiment vectoriel. L'opération de listage prend en charge le filtrage basé sur les préfixes pour vous aider à trouver 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éfixes

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. Cela 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-

Utilisation de la console S3

Pour répertorier les index vectoriels

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 Vector buckets.

3. Dans la liste des compartiments vectoriels, choisissez le nom du compartiment contenant les index que vous souhaitez afficher.

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

   • Nom : nom de chaque index.

   • Date de création : date de création de l'index.

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

Pour filtrer la liste

1. Entrez 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 au fur et à mesure que vous tapez.

À l'aide du AWS CLI

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 vectoriel

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