# 디렉터리 버킷의 액세스 포인트에 태그 추가
<a name="access-points-db-tag-add"></a>



디렉터리 버킷의 Amazon S3 Access Points에 태그를 추가하고 이러한 태그를 수정할 수 있습니다. 자세한 내용은 [디렉터리 버킷에 대해 S3 Access Points에서 태그 사용](access-points-db-tagging.md) 섹션을 참조하세요.

## 권한
<a name="access-points-db-tag-add-permissions"></a>

디렉터리 버킷의 액세스 포인트에 태그를 추가하려면 다음 권한이 있어야 합니다.
+ `s3express:TagResource`

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

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

## 단계
<a name="access-points-db-tag-add-steps"></a>

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

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

Amazon S3 콘솔을 사용하여 디렉터리 버킷의 액세스 포인트에 태그 추가:

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

1. 왼쪽 탐색 창에서 **Access Points(디렉터리 버킷)**를 선택합니다.

1. 액세스 포인트 이름을 선택합니다.

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

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

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

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

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

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

## AWS SDK 사용
<a name="access-points-db-tag-add-sdks"></a>

------
#### [ 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::s3:region:111122223333:accesspoint/my-access-point/*")
                .accountId("111122223333")
                .tags(Tag.builder().key("key1").value("value1").build())
                .build();

        TagResourceResponse response = s3Control.tagResource(tagResourceRequest);
        System.out.println("Status code (should be 204):");
        System.out.println(response.sdkHttpResponse().statusCode());
    }
}
```

------

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

디렉터리 버킷의 액세스 포인트에 태그를 추가하기 위한 Amazon S3 REST API 지원에 대한 자세한 내용은 *Amazon Simple Storage Service API 참조*의 다음 섹션을 참조하세요.
+ [TagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html)

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

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

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

**요청:**

```
aws s3control tag-resource \
--account-id 111122223333 \
--resource-arn arn:aws::s3express:region:444455556666:bucket/prefix--use1-az4--x-s3 \
--tags "Key=key1,Value=value1"
```

**응답:**

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