# 벡터 인덱스 나열
<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 Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 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)
```

------