# 태그가 있는 디렉터리 버킷의 액세스 포인트 만들기
<a name="access-points-db-create-tag"></a>

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

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

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

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

태그가 있는 디렉터리 버킷의 액세스 포인트를 만들려고 할 때 오류가 발생하면 다음을 수행할 수 있습니다.
+ 디렉터리 버킷의 액세스 포인트를 만들고 여기에 태그를 추가하는 데 필요한 [권한](#access-points-db-create-tag-permissions)이 있는지 확인합니다.
+ IAM 사용자 정책에서 속성 기반 액세스 제어(ABAC) 조건을 확인합니다. 디렉터리 버킷의 액세스 포인트에 특정 태그 키 및 값으로만 레이블을 지정해야 할 수 있습니다. 자세한 내용은 [속성 기반 액세스 제어(ABAC)에 태그 사용](tagging.md#using-tags-for-abac) 섹션을 참조하세요.

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

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

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

Amazon S3 콘솔을 사용하여 태그가 있는 디렉터리 버킷의 액세스 포인트 만들기:

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

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

1. **액세스 포인트 생성**을 선택하여 새 액세스 포인트를 만듭니다.

1. 액세스 포인트의 이름을 입력합니다. 자세한 내용은 [디렉터리 버킷의 액세스 포인트 이름 지정 규칙, 제한 및 한계](access-points-directory-buckets-restrictions-limitations-naming-rules.md) 섹션을 참조하세요.

1. **액세스 포인트 생성** 페이지에서 **태그**는 새 액세스 포인트를 만들 때의 옵션입니다.

1. **새 태그 추가**를 선택하여 태그 편집기를 열고 태그 키-값 페어를 입력합니다. 태그 키는 필수지만 값은 선택 사항입니다.

1. 다른 태그를 추가하려면 **새 태그 추가**를 다시 선택합니다. 최대 50개의 태그 키-값 페어를 입력할 수 있습니다.

1. 새 액세스 포인트에 대한 옵션 지정을 완료한 후 **액세스 포인트 생성**을 선택합니다.

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

------
#### [ SDK for Java 2.x ]

이 예제에서는 AWS SDK for Java 2.x를 사용하여 태그가 있는 액세스 포인트를 만드는 방법을 보여줍니다. 명령을 사용하려면 *사용자 입력 자리 표시자*를 사용자의 정보로 대체합니다.

```
CreateAccessPointRequest createAccessPointRequest = CreateAccessPointRequest.builder()
                .accountId(111122223333)
                .name(my-access-point)
                .bucket(amzn-s3-demo-bucket--zone-id--x-s3)
                .tags(Collections.singletonList(Tag.builder().key("key1").value("value1").build()))
                .build();
 awss3Control.createAccessPoint(createAccessPointRequest);
```

------

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

태그가 있는 디렉터리 버킷을 만들기 위한 Amazon S3 REST API 지원에 대한 자세한 내용은 *Amazon Simple Storage Service API 참조*의 다음 섹션을 참조하세요.
+ [:CreateBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)

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

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

다음 CLI 예제는 AWS CLI를 사용하여 태그가 있는 디렉터리 버킷의 액세스 포인트를 만드는 방법을 보여줍니다. 명령을 사용하려면 *사용자 입력 자리 표시자*를 사용자의 정보로 대체합니다.

디렉터리 버킷의 액세스 포인트를 만들 때는 구성 세부 정보를 제공하고 다음과 같은 이름 지정 규칙을 사용해야 합니다. `my-access-point` 

**요청**

```
aws s3control create-access-point \
--account-id 111122223333 \ 
--name my-access-point \
--bucket amzn-s3-demo-bucket--zone-id--x-s3 \
--profile personal \
--tags Key=key1,Value=value1 Key=MyKey2,Value=value2 \
--region region
```