Enumeración de índices vectoriales - Amazon Simple Storage Service
Capacidad de búsqueda de prefijos

Enumeración de índices vectoriales

nota

Amazon S3 Vectors se encuentra en versión preliminar para Amazon Simple Storage Service y está sujeto a cambios.

Puede ver todos los índices vectoriales de un bucket vectorial. La operación de enumeración admite el filtrado basado en prefijos para ayudarlo a encontrar índices específicos cuando tiene muchos índices en un bucket. Para obtener más información sobre ListIndexes, los límites de prefijos y los límites de respuesta, consulte ListIndexes en la Referencia de la API de Amazon Simple Storage Service.

Capacidad de búsqueda de prefijos

La búsqueda de prefijos le permite enumerar índices que comienzan por un prefijo específico, lo que facilita la organización y la búsqueda de índices vectoriales relacionados. Esto resulta especialmente útil cuando se utilizan convenciones de nomenclatura que agrupan índices relacionados:

  • Por tipo de datos: text-embeddings-, image-features- y audio-vectors-

  • Por modelo: model1-embeddings-, model2-vectors- y custom-model-

  • Por caso de uso: search-index-, recommendation- y similarity-

  • Por entorno: prod-vectors-, staging-vectors- y dev-vectors-

Enumeración de índices vectoriales

  1. Inicie sesión en la AWS Management Console y abra la consola de Amazon S3 en https://console.aws.amazon.com/s3/.

  2. En el panel de navegación izquierdo, elija Buckets vectoriales.

  3. En la lista de buckets vectoriales, elija el nombre del bucket que contiene los índices que desea visualizar.

  4. La consola muestra una lista completa de todos los índices vectoriales en el bucket, incluido lo siguiente:

    • Nombre: el nombre de cada índice.

    • Fecha de creación: fecha en que se creó el índice.

    • Nombre de recurso de Amazon (ARN): ARN completo de cada índice.

Filtrado de la lista

  1. Introduzca un nombre o prefijo de índice en el cuadro de búsqueda situado encima de la lista de índices. Utiliza prefijos para buscar grupos de índices relacionados.

  2. La lista se actualiza en tiempo real a medida que escribe.

Utilice los siguientes comandos de ejemplo y reemplace los marcadores de posición de entrada del usuario por información propia.

Enumeración de índices con un prefijo determinado en un bucket vectorial

Ejemplo de solicitud:


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

Ejemplo de respuesta:

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

Enumeración de índices con paginación

Ejemplo de solicitud:

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

Ejemplo de respuesta: 

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