ベクトルインデックスの一覧表示 - 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 にサインインし、Amazon S3 コンソール https://console.aws.amazon.com/s3/ を開きます。

  2. 左側のナビゲーションペインで、[ベクトルバケット] を選択します。

  3. ベクトルバケットのリストで、表示するインデックスが含まれるバケットの名前を選択します。

  4. コンソールには、以下を含む、バケット内のすべてのベクトルインデックスの包括的なリストが表示されます。

    • 名前 – 各インデックスの名前。

    • 作成日 – インデックスが作成された日時。

    • Amazon リソースネーム (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"
        }
    ]
}