벡터 인덱스 나열하기

벡터 인덱스 나열하기

벡터 버킷 안의 모든 벡터 인덱스를 보는 방법을 설명해요. 나열 작업은 프리픽스 기반 필터링을 지원해 버킷에 인덱스가 많을 때 특정 인덱스를 쉽게 찾을 수 있어요.

출처: Listing vector indexes

본문

벡터 버킷 안의 모든 벡터 인덱스를 볼 수 있어요. 나열 작업은 프리픽스 기반 필터링을 지원해 버킷에 인덱스가 많을 때 특정 인덱스를 찾기 쉽게 해줘요. ListIndexes, 프리픽스 제한, 응답 제한에 대한 자세한 내용은 Amazon Simple Storage Service API Reference의 ListIndexes 문서를 참고해 주세요.

프리픽스 검색 기능 (Prefix search capability)

프리픽스 검색을 사용하면 특정 프리픽스로 시작하는 인덱스를 나열할 수 있어, 관련된 벡터 인덱스를 쉽게 정리하고 찾을 수 있어요. 특히 관련 인덱스를 묶는 명명 규칙을 사용할 때 유용해요.

  • 데이터 유형별: 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. 왼쪽 탐색 창에서 Vector buckets를 선택합니다.
  3. 벡터 버킷 목록에서 확인하려는 인덱스가 들어 있는 버킷 이름을 선택합니다.
  4. 콘솔이 버킷 안의 모든 벡터 인덱스를 포괄적인 목록으로 보여줘요: Name – 각 인덱스의 이름, Create date – 인덱스 생성 시각, Amazon Resource Name (ARN) – 각 인덱스의 전체 ARN.
  5. 인덱스 목록 위의 검색 상자에 인덱스 이름이나 프리픽스를 입력합니다. 프리픽스를 사용해 관련 인덱스 그룹을 찾을 수 있어요.
  6. 입력할 때 목록이 실시간으로 업데이트됩니다.

다음 예시 명령을 사용하고, 사용자 입력 플레이스홀더를 여러분의 정보로 바꿔 넣으세요.

벡터 버킷에서 특정 프리픽스의 인덱스 나열하기

요청 예시:

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 (Python/boto3)

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)

더 알아보기 (Learn more)