列出向量索引 - Amazon Simple Storage Service
前缀搜索功能
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

列出向量索引

注意

适用于 Amazon Simple Storage Service 的 Amazon S3 Vectors 为预览版，可能会发生变化。

可以查看向量存储桶中的所有向量索引。列出操作支持基于前缀的筛选，有助于您在存储桶中有许多索引时找到特定的索引。有关 ListIndexes、前缀限制和响应限制的更多信息，请参阅《Amazon Simple Storage Service API Reference》中的 ListIndexes。

前缀搜索功能

前缀搜索支持您列出以特定前缀开头的索引，从而可以更轻松地整理和查找相关的向量索引。当您使用将相关索引分组在一起的命名约定时，这特别有用：

  • 按数据类型：text-embeddings-、image-features-、audio-vectors-

  • 按模型：model1-embeddings-、model2-vectors-、custom-model-

  • 按使用案例：search-index-、recommendation-、similarity-

  • 按环境：prod-vectors-、staging-vectors-、dev-vectors-

列出向量索引

  1. 登录到 Amazon Web Services Management Console，然后通过以下网址打开 Amazon S3 控制台：https://console.aws.amazon.com/s3/。

  2. 在左侧导航窗格中，选择向量存储桶。

  3. 在向量存储桶列表中，选择存储桶的名称，该存储桶包含您要查看的索引。

  4. 控制台会显示存储桶中所有向量索引的完整列表，包括：

    • 名称：每个索引的名称。

    • 创建日期：创建索引的时间。

    • Amazon 资源名称（ARN）：每个索引的 Amazon 资源名称（ARN）。

筛选列表

  1. 在索引列表上方的搜索框中输入索引名称或前缀。使用前缀来查找相关索引的分组。

  2. 当您键入时，列表会实时更新。

使用以下示例命令，并将用户输入占位符替换为您自己的信息。

列出向量存储桶中带有特定前缀的索引

请求示例：


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