버킷에 태그 추가

Amazon S3 버킷에 태그를 추가하고 수정할 수 있어요. 버킷에 태그를 사용한다고 해서 표준 S3 API 요청 요금 외에 추가 비용은 발생하지 않아요. 자세한 내용은 Amazon S3 요금을 참고하세요. 버킷 태그 지정에 대한 자세한 내용은 S3 일반 목적 버킷에서 태그 사용을 참고하세요.

출처: 문서

본문

권한 (Permissions)

버킷에 태그를 추가하려면 다음 권한이 필요해요.

s3:TagResource

오류 문제 해결 (Troubleshooting errors)

버킷에 태그를 추가하려다 오류가 발생하면 다음을 확인할 수 있어요.

버킷에 태그를 추가하는 데 필요한 권한이 있는지 확인해요.
AWS 예약 접두사 aws:로 시작하는 태그 키를 추가하려 했다면, 태그 키를 바꿔 다시 시도해요.

단계 (Steps)

Amazon S3 콘솔, AWS Command Line Interface(AWS CLI), Amazon S3 REST API, AWS SDK를 사용해 버킷에 태그를 추가할 수 있어요.

Amazon S3 콘솔로 버킷에 태그를 추가하는 방법은 다음과 같아요.

https://console.aws.amazon.com/s3/에서 Amazon S3 콘솔에 로그인해요.
왼쪽 탐색 창에서 buckets를 선택해요.
버킷 이름을 선택해요.
Properties 탭을 선택해요.
Tags 섹션으로 스크롤해 Add new Tag를 선택해요.
Add Tags 페이지가 열리면 최대 50개의 태그 키-값 쌍을 입력할 수 있어요.
기존 태그와 같은 키 이름으로 새 태그를 추가하면, 새 태그의 값이 기존 태그의 값을 덮어써요.
이 페이지에서 기존 태그의 값도 수정할 수 있어요.
태그를 추가한 뒤 Save changes를 선택해요.

SDK for Java 2.x — 다음 예시는 AWS SDK for Java 2.x로 일반 목적 버킷에 태그를 추가하는 방법을 보여줘요. 명령을 사용하려면 user input placeholders를 자신의 정보로 바꾸세요.

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.Tag;
import software.amazon.awssdk.services.s3control.model.TagResourceRequest;
import software.amazon.awssdk.services.s3control.model.TagResourceResponse;

public class TagResourceExample {
    public static void tagResourceExample() {
        S3ControlClient s3Control = S3ControlClient.builder().region(Region.US_WEST_2).build();
        TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
                .resourceArn("arn:aws::s3:::bucket/my-bucket")
                .accountId("111122223333")
                .tags(Tag.builder().key("MyTagKey").value("MyTagValue").build())
                .build();
        TagResourceResponse response = s3Control.tagResource(tagResourceRequest);
        System.out.println("Status code (should be 204):");
        System.out.println(response.sdkHttpResponse().statusCode());
    }
}

일반 목적 버킷에 태그를 추가하는 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 placeholders를 자신의 정보로 바꾸세요.

요청 (Request):

aws s3control tag-resource --resource-arn arn:aws:s3:::amzn-s3-demo-bucket --region us-east-2 --account-id 444455556666 --tags '[{"Key":"mykey","Value":"myvalue"}]'

버킷에 태그 추가