액세스 포인트에 태그 추가

액세스 포인트에 태그 추가 (Adding a tag to an access point)

Amazon S3 액세스 포인트에 태그를 추가하고 이 태그를 수정할 수 있어요. 표준 S3 API 요청 요율 외에 액세스 포인트에 태그를 사용하는 데는 추가 요금이 없어요. 자세한 내용은 Amazon S3 요금을 참고하세요. 액세스 포인트 태깅에 대한 자세한 내용은 일반용 버킷의 S3 액세스 포인트에 태그 사용하기를 참고하세요.

출처: 문서

본문

권한

액세스 포인트에 태그를 추가하려면 다음 권한이 있어야 해요.

s3:TagResource

오류 문제 해결

액세스 포인트에 태그를 추가하려 할 때 오류가 발생하면 다음을 수행할 수 있어요.

1. 액세스 포인트에 태그를 추가하는 데 필요한 권한이 있는지 확인하세요.
2. AWS 예약 접두사 aws:로 시작하는 태그 키를 추가하려 했다면 태그 키를 변경하고 다시 시도하세요.

단계

Amazon S3 콘솔, AWS Command Line Interface(AWS CLI), Amazon S3 REST API, AWS SDKs로 액세스 포인트에 태그를 추가할 수 있어요.

Amazon S3 콘솔로 액세스 포인트에 태그를 추가하려면

1. Amazon S3 콘솔에 로그인합니다.
2. 왼쪽 탐색 창에서 액세스 포인트(일반용 버킷)(Access Points (General Purpose Buckets)) 를 선택해요.
3. 액세스 포인트 이름을 선택해요.
4. 속성(Properties) 탭을 선택해요.
5. 태그(Tags) 섹션까지 스크롤하고 새 태그 추가(Add new Tag) 를 선택해요. 이렇게 하면 태그 추가(Add Tags) 페이지가 열려요. 최대 50개의 태그 키-값 쌍을 입력할 수 있어요.
6. 기존 태그와 같은 키 이름으로 새 태그를 추가하면 새 태그의 값이 기존 태그의 값을 재정의해요. 이 페이지에서 기존 태그의 값도 편집할 수 있어요.
7. 태그를 추가한 후 변경 사항 저장(Save changes) 을 선택해요.

SDK for Java 2.x

이 예시는 AWS SDK for Java 2.x로 액세스 포인트에 태그를 추가하는 방법을 보여줘요. 명령을 사용하려면 user input 자리 표시자를 자신의 정보로 바꾸세요.

TagResourceRequest tagResourceRequest = TagResourceRequest.builder().resourceArn(arn:aws::s3:region:111122223333:accesspoint/my-access-point/*)
.accountId(111122223333)
.tags(List.of(Tag.builder().key("key1").value("value1").build(),
Tag.builder().key("key2").value("value2").build()))
.build();
awss3Control.tagResource(tagResourceRequest);

액세스 포인트에 태그 추가에 대한 Amazon S3 REST API 지원은 Amazon Simple Storage Service API Reference의 다음 섹션을 참고하세요. TagResource

AWS CLI를 설치하려면 AWS Command Line Interface User Guide의 AWS CLI 설치를 참고하세요.

다음 CLI 예시는 AWS CLI로 액세스 포인트에 태그를 추가하는 방법을 보여줘요. 명령을 사용하려면 user input 자리 표시자를 자신의 정보로 바꾸세요.

요청(Request):

aws s3control tag-resource \
--account-id 111122223333 \
--resource-arn arn:aws::s3:region:111122223333:accesspoint/my-access-point/* \
--tags "Key=key1,Value=value1"

응답(Response):

{
  "ResponseMetadata": {
      "RequestId": "EXAMPLE123456789",
      "HTTPStatusCode": 200,
      "HTTPHeaders": {
          "date": "Wed, 19 Jun 2025 10:30:00 GMT",
          "content-length": "0"
      },
      "RetryAttempts": 0
  }
}

더 알아보기 (Learn more)

• 태그가 있는 액세스 포인트 만들기
• 액세스 포인트 태그 보기