

# 벡터 인덱스에 태그 추가
<a name="adding-tag-vector-index"></a>

Amazon S3 벡터 인덱스에 태그를 추가하고 이러한 태그를 수정할 수 있습니다. 벡터 인덱스에서 태그를 사용하는 데는 표준 S3 API 요청 요금 외에는 추가 요금이 부과되지 않습니다. 자세한 내용은 [Amazon S3 요금](https://docs.aws.amazon.com/s3/pricing/)을 참조하세요. 벡터 인덱스 태그 지정에 대한 자세한 내용은 [S3 벡터 인덱스에서 태그 사용](vector-index-tagging.md) 섹션을 참조하세요.

## 권한
<a name="add-index-tag-permissions"></a>

벡터 인덱스에 태그를 추가하려면 다음 권한이 있어야 합니다.
+ `s3vectors:TagResource`

## 오류 해결
<a name="add-index-tag-troubleshooting"></a>

벡터 인덱스에 태그를 추가하려고 할 때 오류가 발생하면 다음을 수행할 수 있습니다.
+ 벡터 인덱스에 태그를 추가하는 데 필요한 [권한](#add-index-tag-permissions)이 있는지 확인합니다.
+ AWS 예약된 접두사 `aws:`로 시작하는 태그 키를 추가하려고 했다면 태그 키를 변경하고 다시 시도합니다.

## 단계
<a name="add-index-tag-steps"></a>

Amazon S3 콘솔, AWS Command Line Interface(AWS CLI), Amazon S3 REST API, AWS SDK를 사용하여 벡터 인덱스에 태그를 추가할 수 있습니다.

### S3 콘솔 사용
<a name="add-index-tag-console"></a>

**Amazon S3 콘솔을 사용하여 벡터 인덱스에 태그를 추가하려면**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **벡터 인덱스**를 선택합니다.

1. 벡터 인덱스 이름을 선택합니다.

1. **속성** 탭을 선택합니다.

1. **태그** 섹션으로 스크롤하고 **새 태그 추가**를 선택합니다.

1. **태그 추가** 페이지가 열립니다. 최대 50개의 태그 키-값 페어를 입력할 수 있습니다.

1. 키 이름이 기존 태그와 동일한 새 태그를 추가하는 경우 새 태그의 값이 기존 태그의 값을 덮어씁니다.

1. 이 페이지에서 기존 태그의 값을 편집할 수도 있습니다.

1. 태그를 추가한 후 **변경 사항 저장**을 선택합니다.

### REST API 사용
<a name="add-index-tag-api"></a>

벡터 인덱스에 태그를 추가하기 위한 Amazon S3 REST API 지원에 대한 자세한 내용은 *Amazon S3 Vectors API 참조*의 다음 섹션을 참조하세요.

[TagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_TagResource.html)

### AWS CLI 사용
<a name="add-index-tag-cli"></a>

AWS CLI를 설치하려면 *AWS Command Line Interface 사용 설명서*의 [AWS CLI 설치](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)를 참조하세요.

다음 CLI 예제는 AWS CLI를 사용하여 벡터 인덱스에 태그를 추가하는 방법을 보여줍니다. 명령을 사용하려면 {{사용자 입력 자리 표시자}}를 사용자의 정보로 대체합니다.

```
aws s3vectors tag-resource \
--resource-arn arn:aws:s3vectors:us-east-1:{{012345678900}}:bucket/{{acc-bucket}}/index/{{accounts-index}} \
--tags {{Stage}}={{Prod}},{{CostCenter}}={{Marketing}}
```