태그가 있는 일반 목적 버킷 생성
태그가 있는 일반 목적 버킷 생성
Amazon S3 일반 목적 버킷을 만들 때 태그를 지정할 수 있어요. 버킷에 태그를 사용한다고 해서 표준 S3 API 요청 요금 외에 추가 비용은 발생하지 않아요. 자세한 내용은 Amazon S3 요금을 참고하세요. 버킷 태그 지정에 대한 자세한 내용은 S3 일반 목적 버킷에서 태그 사용을 참고하세요.
출처: 문서
본문
권한 (Permissions)
태그가 있는 버킷을 만들려면 다음 권한이 필요해요.
s3:CreateBuckets3:TagResource
Amazon S3 콘솔과 CloudFormation은 이제 이 기능을 사용해 태그가 있는 버킷을 만들어요.
오류 문제 해결 (Troubleshooting errors)
태그가 있는 버킷을 만들려다 오류가 발생하면 다음을 확인할 수 있어요.
- 버킷을 만들고 여기에 태그를 추가하는 데 필요한 권한이 있는지 확인해요.
- IAM 정책에
aws:TagKeys또는aws:RequestTag/key-name조건 키가 있는지 확인해요. 특정 태그 키와 값으로만 버킷에 레이블을 붙이도록 요구될 수 있어요. 자세한 내용은 특성 기반 접근 제어(ABAC)에 태그 사용을 참고하세요.
참고 Amazon S3와 CloudFormation은 이제 이 기능을 사용해 태그가 있는 버킷을 만들어요. 태그가 있는 버킷을 만들 때,
aws:ResourceTag와s3:BucketTag조건 키로 버킷에 접근하는 태그 기반 조건은 버킷에서 ABAC를 활성화한 후에만 적용된다는 점을 기억하세요. 자세한 내용은 일반 목적 버킷에서 ABAC 활성화를 참고하세요.
단계 (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를 선택해요.
- 새 버킷을 만들려면 create bucket을 선택해요.
- 평소처럼 일반 목적 버킷을 만들어요. 일반 목적 버킷 생성을 참고하세요.
- Create bucket 페이지에서 Tags는 버킷을 만들 때 사용할 수 있는 옵션이에요.
- 버킷 이름을 입력해요. 자세한 내용은 일반 목적 버킷 이름 규칙을 참고하세요.
- Add new Tag를 선택해 Tags 편집기를 열고 태그 키-값 쌍을 입력해요. 태그 키는 필수이고 값은 선택 사항이에요.
- 태그를 더 추가하려면 Add new Tag를 다시 선택해요. 최대 50개의 태그 키-값 쌍을 입력할 수 있어요.
- 새 버킷의 옵션 지정을 마쳤으면 Create bucket을 선택해요.
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.s3.S3Client;
import software.amazon.awssdk.services.s3.model.BucketLocationConstraint;
import software.amazon.awssdk.services.s3.model.CreateBucketConfiguration;
import software.amazon.awssdk.services.s3.model.CreateBucketRequest;
import software.amazon.awssdk.services.s3.model.CreateBucketResponse;
import software.amazon.awssdk.services.s3.model.Tag;
public class CreateBucketWithTagsExample {
public static void createBucketWithTagsExample() {
S3Client s3 = S3Client.builder().region(Region.US_WEST_2).build();
CreateBucketConfiguration bucketConfiguration = CreateBucketConfiguration.builder()
.locationConstraint(BucketLocationConstraint.US_WEST_2)
.tags(Tag.builder().key("MyTagKey").value("MyTagValue").build())
.build();
CreateBucketRequest createBucketRequest = CreateBucketRequest.builder()
.bucket("mybucket")
.createBucketConfiguration(bucketConfiguration)
.build();
CreateBucketResponse response = s3.createBucket(createBucketRequest);
System.out.println("Status code (should be 200):");
System.out.println(response.sdkHttpResponse().statusCode());
}
}
태그가 있는 일반 목적 버킷을 만드는 Amazon S3 REST API 지원에 대한 자세한 내용은 Amazon Simple Storage Service API Reference의 다음 섹션을 참고하세요.
AWS CLI 설치는 AWS Command Line Interface User Guide의 AWS CLI 설치를 참고하세요.
다음 CLI 예시는 AWS CLI로 태그가 있는 버킷을 만드는 방법을 보여줘요. 명령을 사용하려면 user input placeholders를 자신의 정보로 바꾸세요.
버킷을 만들 때 구성 정보를 제공하고 다음 명명 규칙을 사용해야 해요: amzn-s3-demo-bucket
요청 (Request):
aws s3api create-bucket \
--bucket mybucket \
--create-bucket-configuration 'LocationConstraint=us-west-2,Tags=[{Key=MyTagKey,Value=MyTagValue}]' --region us-west-2
응답 (Response):
{
"Location": "http://mybuckets3.amazonaws.com/"
}