本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 列出向量索引
<a name="s3-vectors-index-list"></a>

您可以檢視向量儲存貯體中的所有向量索引。列表操作支援以字首為主的篩選，可協助您在存在許多索引的儲存貯體中尋找特定索引。如需有關 `ListIndexes`、字首限制和回應限制的詳細資訊，請參閱《Amazon Simple Storage Service API 參考》中的 [ListIndexes](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListIndexes.html)。

## 字首搜尋功能
<a name="s3-vectors-index-prefix-search-capability"></a>

字首搜尋功能可讓您列出以特定字首開頭的索引，讓您能更輕鬆地組織和尋找相關的向量索引。當您使用命名慣例將相關索引分在同一組時，這特別有用：
+ **依資料類型：**`text-embeddings-`、`image-features-`、`audio-vectors-`
+ **依模型：**`model1-embeddings-`、`model2-vectors-`、`custom-model-`
+ **依使用案例：**`search-index-`、`recommendation-`、`similarity-`
+ **依環境：**`prod-vectors-`、`staging-vectors-`、`dev-vectors-`

### 使用 S3 主控台
<a name="s3-vectors-index-list-console"></a>

**列出向量索引**

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 開啟 Amazon S3 主控台。

1. 在左側導覽窗格中，選擇**向量儲存貯體**。

1. 在向量儲存貯體清單中，選擇包含您要檢視之索引的儲存貯體名稱。

1. 主控台會顯示儲存貯體中所有向量索引的完整清單，包括：
   + **名稱** – 每個索引的名稱。
   + **建立日期** – 建立索引的時間。
   + **Amazon Resource Name (ARN)** – 每個索引的完整 ARN。

**篩選清單**

1. 在索引清單上方的搜尋方塊中，輸入索引名稱或字首。使用字首尋找相關索引的群組。

1. 清單會在您輸入時即時更新。

### 使用 AWS CLI
<a name="s3-vectors-list-cli"></a>

若要使用下列範例命令，請以您自己的資訊取代*使用者輸入預留位置*。

**列出向量儲存貯體中具有特定字首的索引**

範例請求：

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

回應範例：

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

**列出使用分頁的索引**

範例請求：

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

回應範例：

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

### 使用 AWS SDKs
<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)
```

------