

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

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

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

1. コンソールには、以下を含む、バケット内のすべてのベクトルインデックスの包括的なリストが表示されます。
   + **名前** – 各インデックスの名前。
   + **作成日** – インデックスが作成された日時。
   + **Amazon リソースネーム (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 SDK の使用
<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)
```

------