디렉터리 버킷에 태그 추가 - Amazon Simple Storage Service
권한오류 해결단계

디렉터리 버킷에 태그 추가

Amazon S3 디렉터리 버킷에 태그를 추가하고 이러한 태그를 수정할 수 있습니다. 디렉터리 버킷에서 태그를 사용하는 데 표준 S3 API 요청 속도 외에는 추가 요금이 부과되지 않습니다. 자세한 내용은 Amazon S3 요금을 참조하십시오. 디렉터리 버킷 태그 지정에 대한 자세한 내용은 S3 디렉터리 버킷에서 태그 사용 섹션을 참조하세요.

권한

디렉터리 버킷에 태그를 추가하려면 다음 권한이 있어야 합니다.

  • s3express:TagResource

오류 해결

디렉터리 버킷에 태그를 추가하려고 할 때 오류가 발생하면 다음을 수행할 수 있습니다.

  • 디렉터리 버킷에 태그를 추가하는 데 필요한 권한이 있는지 확인합니다.

  • AWS 예약된 접두사 aws:로 시작하는 태그 키를 추가하려고 했다면 태그 키를 변경하고 다시 시도합니다.

단계

Amazon S3 콘솔, AWS Command Line Interface(AWS CLI), Amazon S3 REST API, AWS SDK를 사용해 디렉터리 버킷에 태그를 추가할 수 있습니다.

Amazon S3 콘솔을 사용하여 디렉터리 버킷에 태그를 추가하는 방법:

  1. https://console.aws.amazon.com/s3/에서 Amazon S3 콘솔에 로그인합니다.

  2. 왼쪽 탐색 창에서 디렉터리 버킷을 선택합니다.

  3. 버킷 이름을 선택합니다.

  4. 속성(Properties) 탭을 선택합니다.

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

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

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

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

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

SDK for Java 2.x

이 예시는 AWS SDK for Java 2.x를 사용하여 디렉터리 버킷에 태그를 추가하는 방법을 보여줍니다. 명령을 사용하려면 사용자 입력 자리 표시자를 사용자의 정보로 대체합니다.

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:s3express:us-west-2:111122223333:bucket/my-directory-bucket--usw2-az1--x-s3")
                .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 참조의 다음 섹션을 참조하세요.

AWS CLI를 설치하려면 AWS Command Line Interface 사용 설명서에서 AWS 설치를 참조하세요.

다음 CLI 예시는 AWS CLI를 사용하여 디렉터리 버킷에 태그를 추가하는 방법을 보여줍니다. 명령을 사용하려면 사용자 입력 자리 표시자를 사용자의 정보로 대체합니다.

요청:

aws s3control tag-resource \
--account-id 111122223333 \
--resource-arn arn:aws:s3express:us-east-1:444455556666:bucket/prefix--use1-az4--x-s3 \
--tags "Key=mykey,Value=myvalue"

응답:

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