# Enumeración de índices vectoriales
<a name="s3-vectors-index-list"></a>

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](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListIndexes.html) en la Referencia de la API de Amazon Simple Storage Service. 

## Capacidad de búsqueda de prefijos
<a name="s3-vectors-index-prefix-search-capability"></a>

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-`

### Uso de la consola de S3
<a name="s3-vectors-index-list-console"></a>

**Enumeración de índices vectoriales**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

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

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

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

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

### Uso de AWS CLI
<a name="s3-vectors-list-cli"></a>

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
```

Respuesta de ejemplo:

```
{
    "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"
```

Respuesta de ejemplo: 

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

### Uso de los AWS SDK
<a name="s3-vectors-list-sdk"></a>

------
#### [ 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)
```

------