# Listar buckets de vetores
<a name="s3-vectors-buckets-list"></a>

É possível visualizar todos os buckets de vetores usando o console do Amazon S3, a AWS CLI ou SDKs da AWS. As operações de listagem permitem a filtragem baseada em prefixo para ajudar você a encontrar buckets específicos quando houver muitos buckets de vetores em sua conta. Para ter mais informações sobre `ListVectorBuckets`, limites de prefixo e limites de resposta, consulte [ListVectorBuckets](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListVectorBuckets.html) na *Referência de API do Amazon S3*.

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

A pesquisa de prefixo permite listar buckets que começam com um prefixo específico, o que facilita a organização e a localização de buckets de vetores relacionados. Isso é especialmente útil ao usar convenções de nomenclatura que agrupam buckets relacionados:
+ **Baseados no ambiente**: `production-vectors-`, `staging-vectors-`, `dev-vectors-`
+ **Baseados em casos de uso**: `ml-model-vectors-`, `document-search-`, `image-similarity-`
+ **Baseados em equipe**: `data-science-vectors-`, `ml-platform-vectors-`

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

Como listar buckets 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, escolha **Buckets de vetores**.

   O console exibirá uma lista de todos os buckets de vetores com as seguintes informações:
   + **Nome**: o nome exclusivo do bucket de vetores.
   + **Data de criação**: quando o bucket foi criado.
   + **Nome do recurso da Amazon (ARN)**: o ARN completo para acesso programático.

Para filtrar a lista:
+ Para encontrar um bucket com base no início do respectivo nome, insira um nome ou prefixo de bucket de vetores na caixa de pesquisa acima da lista de buckets.
+ Use prefixos para encontrar grupos de buckets relacionados (por exemplo, digite “prod-” para encontrar todos os buckets de produção).

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

## Como usar o AWS CLI
<a name="list-vector-bucket-CLI"></a>

```
aws s3vectors list-vector-buckets
```

## Usar SDKs da AWS
<a name="s3-vectors-buckets-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 buckets
response = s3vectors.list_vector_buckets()
buckets = response["vectorBuckets"]
print(buckets)
```

------