# Listagem de índices de vetores
<a name="s3-vectors-index-list"></a>

Você pode visualizar todos os índices de vetores em um bucket de vetores. A operação de listagem permite a filtragem baseada em prefixo para ajudar você a encontrar índices específicos quando houver muitos índices em um bucket. Para ter mais informações sobre `ListIndexes`, limites de prefixo e limites de resposta, consulte [ListIndexes](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListIndexes.html) na “Referência de API do Amazon Simple Storage Service”. 

## Recurso de pesquisa de prefixo
<a name="s3-vectors-index-prefix-search-capability"></a>

A pesquisa de prefixo permite listar índices que começam com um prefixo específico, o que facilita a organização e a localização de índices de vetores relacionados. Isso é especialmente útil quando você usa convenções de nomenclatura que agrupam índices relacionados:
+ **Por tipo de dados:** `text-embeddings-`, `image-features-`, `audio-vectors-`
+ **Por modelo:** `model1-embeddings-`, `model2-vectors-`, `custom-model-`
+ **Por caso de uso:** `search-index-`, `recommendation-`, `similarity-`
+ **Por ambiente:** `prod-vectors-`, `staging-vectors-`, `dev-vectors-`

### Usar o console do S3
<a name="s3-vectors-index-list-console"></a>

**Como listar índices de vetores**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação à esquerda, escolha **Buckets de vetores**.

1. Na lista de buckets de vetores, escolha o nome do bucket que contém os índices que você deseja visualizar.

1. O console exibe uma lista abrangente de todos os índices de vetores no bucket, incluindo:
   + **Nome**: o nome de cada índice.
   + **Data de criação**: quando o índice foi criado.
   + **Nome do recurso da Amazon (ARN)**: o ARN completo para cada índice.

**Como filtrar a lista**

1. Insira um nome ou prefixo de índice na caixa de pesquisa acima da lista de índices. Use prefixos para encontrar grupos de índices relacionados.

1. A lista é atualizada em tempo real enquanto você digita.

### Como usar o AWS CLI
<a name="s3-vectors-list-cli"></a>

Use os comandos de exemplo a seguir e substitua os *espaços reservados para entrada do usuário* por suas próprias informações.

**Como listar índices com um prefixo específico em um bucket de vetores**

Exemplo de solicitação:

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

Exemplo de resposta:

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

**Como listar índices com paginação**

Exemplo de solicitação:

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

Exemplo de resposta: 

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

### Usar SDKs da AWS
<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)
```

------