

# Listing vector buckets
<a name="s3-vectors-buckets-list"></a>

You can view all your vector buckets using the Amazon S3 console, Amazon CLI, or Amazon SDKs. The listing operations support prefix-based filtering to help you find specific buckets when you have many vector buckets in your account. For more information about `ListVectorBuckets`, prefix limits, and response limits, see [ListVectorBuckets](https://docs.amazonaws.cn/AmazonS3/latest/API/API_S3VectorBuckets_ListVectorBuckets.html) in the *Amazon S3 API Reference*.

## Prefix search capability
<a name="s3-vectors-buckets-list-prefix-search"></a>

Prefix search allows you to list buckets that start with a specific prefix, making it easier to organize and find related vector buckets. This is particularly useful when you use naming conventions that group related buckets together:
+ **Environment-based**: `production-vectors-`, `staging-vectors-`, `dev-vectors-`
+ **Use case-based**: `ml-model-vectors-`, `document-search-`, `image-similarity-`
+ **Team-based**: `data-science-vectors-`, `ml-platform-vectors-`

## Using the S3 console
<a name="s3-vectors-buckets-list-console"></a>

To list vector buckets

1. Sign in to the Amazon Web Services Management Console and open the Amazon S3 console at [https://console.amazonaws.cn/s3/](https://console.amazonaws.cn/s3/).

1. In the navigation pane, choose **Vector buckets**.

   The console displays a list of all your vector buckets with the following information:
   + **Name** – The unique name of the vector bucket
   + **Creation date** – When the bucket was created
   + **Amazon Resource Name (ARN)** – The full ARN for programmatic access

To filter the list:
+ To find a bucket based on the start of the bucket name, enter a vector bucket name or prefix in the search box above the bucket list.
+ Use prefixes to find groups of related buckets (for example, type "prod-" to find all production buckets)

  The list updates in real-time as you type

## Using the Amazon CLI
<a name="list-vector-bucket-CLI"></a>

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

## Using the Amazon SDKs
<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)
```

------