列出向量索引 - Amazon Simple Storage Service

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

列出向量索引

注意

Amazon S3 Vectors 為 Amazon Simple Storage Service 的預覽版本,可能會有所變更。

您可以檢視向量儲存貯體中的所有向量索引。列出操作支援字首型篩選,可協助您在儲存貯體中有許多索引時尋找特定索引。如需 ListIndexes、字首限制和回應限制的詳細資訊,請參閱《Amazon Simple Storage Service API 參考》中的 ListIndexes

字首搜尋功能

字首搜尋可讓您列出以特定字首開頭的索引,讓您更輕鬆地組織和尋找相關的向量索引。當您使用將相關索引分組在一起的命名慣例時,這特別有用:

  • 依資料類型:text-embeddings-image-features-audio-vectors-

  • 依模型:model1-embeddings-model2-vectors-custom-model-

  • 依使用案例:search-index-recommendation-similarity-

  • 依環境:prod-vectors-staging-vectors-dev-vectors-

列出向量索引
  1. 登入 AWS Management Console ,並在 https://https://console.aws.amazon.com/s3/ 開啟 Amazon S3 主控台。

  2. 在左側導覽窗格中,選擇向量儲存貯體。

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

  4. 主控台會顯示儲存貯體中所有向量索引的完整清單,包括:

    • 名稱 – 每個索引的名稱。

    • 建立日期 – 建立索引的時間。

    • Amazon Resource Name (ARN) – 每個索引的完整 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" } ] }