벡터 인덱스 나열 - 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://console.aws.amazon.com/s3/에서 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"
        }
    ]
}