벡터 인덱스에 태그 추가하기
벡터 인덱스에 태그 추가하기 (Adding a tag to a vector index)
Amazon S3 벡터 인덱스(vector index)에 태그를 추가하거나 기존 태그를 수정할 수 있어요. 벡터 인덱스에 태그를 쓴다고 해서 표준 S3 API 요청 요금 외에 별도 비용이 들지는 않아요. 자세한 내용은 Amazon S3 요금 문서를 참고하세요. 벡터 인덱스 태깅에 대한 더 자세한 설명은 S3 벡터 인덱스에 태그 사용하기를 참고하면 좋아요.
출처: 문서
본문
권한 (Permissions)
벡터 인덱스에 태그를 추가하려면 다음 권한이 필요해요.
s3vectors:TagResource
오류 해결하기 (Troubleshooting errors)
벡터 인덱스에 태그를 추가하다가 오류가 나면 다음을 확인해 볼 수 있어요.
- 벡터 인덱스에 태그를 추가하는 데 필요한 권한을 갖고 있는지 확인해요.
- AWS 예약 접두사인
aws:로 시작하는 태그 키를 추가하려고 했다면, 태그 키를 바꿔서 다시 시도해 보세요.
단계 (Steps)
Amazon S3 콘솔, AWS Command Line Interface(AWS CLI), Amazon S3 REST API, AWS SDK를 사용해 벡터 인덱스에 태그를 추가할 수 있어요.
Amazon S3 콘솔로 벡터 인덱스에 태그 추가하기
- AWS Management Console에 로그인하고 Amazon S3 콘솔을 엽니다: https://console.aws.amazon.com/s3/
- 왼쪽 탐색 창에서 vector indexes를 선택해요.
- 벡터 인덱스 이름을 선택해요.
- Properties 탭을 선택해요.
- Tags 섹션까지 스크롤한 뒤 Add new Tag를 선택해요.
- Add Tags 페이지가 열려요. 태그 키-값(key-value) 쌍을 최대 50개까지 입력할 수 있어요.
- 기존 태그와 같은 키 이름으로 새 태그를 추가하면 새 태그의 값이 기존 태그 값을 덮어써요.
- 이 페이지에서 기존 태그의 값도 수정할 수 있어요.
- 태그를 모두 추가했다면 Save changes를 선택해요.
벡터 인덱스에 태그를 추가하는 Amazon S3 REST API 지원에 대한 자세한 내용은 Amazon S3 Vectors API Reference의 TagResource 섹션을 참고하세요.
AWS CLI를 설치하는 방법은 AWS Command Line Interface User Guide의 Installing the AWS CLI를 참고하세요. 다음 CLI 예시는 AWS CLI로 벡터 인덱스에 태그를 추가하는 방법을 보여줘요. 명령을 사용할 때 user input placeholders를 여러분의 정보로 바꿔주세요.
aws s3vectors tag-resource \
--resource-arn arn:aws:s3vectors:us-east-1:012345678900:bucket/acc-bucket/index/accounts-index \
--tags Stage=Prod,CostCenter=Marketing