버킷 이름 지정 규칙 - Amazon Simple Storage Service
범용 버킷 이름 지정 규칙디렉터리 버킷 이름 지정 규칙

버킷 이름 지정 규칙

Amazon S3의 범용 버킷 및 디렉터리 버킷 이름 지정에는 다음 규칙이 적용됩니다.

범용 버킷 이름 지정 규칙

범용 버킷에는 다음 이름 지정 규칙이 적용됩니다.

  • 버킷 이름은 3자(최소)에서 63자(최대) 사이여야 합니다.

  • 버킷 이름은 소문자, 숫자, 점(.) 및 하이픈(-)으로만 구성될 수 있습니다.

  • 버킷 이름은 문자 또는 숫자로 시작하고 끝나야 합니다.

  • 버킷 이름에 두 마침표를 나란히 붙여 사용하면 안 됩니다.

  • 버킷 이름은 IP 주소 형식(예: 192.168.5.4)을 사용하지 않습니다.

  • 버킷 이름은 접두사 xn--로 시작해서는 안됩니다.

  • 버킷 이름은 접두사 sthree- 및 접두사 sthree-configurator로 시작해서는 안됩니다.

  • 버킷 이름은 접미사 -s3alias로 끝나서는 안됩니다. 이 접미사는 액세스 포인트 별칭 이름 용도로 예약되어 있습니다. 자세한 내용은 S3 버킷 액세스 지점에 버킷 스타일 별칭 사용 단원을 참조하십시오.

  • 버킷 이름은 접미사 --ol-s3로 끝나서는 안됩니다. 이 접미사는 객체 Lambda 액세스 포인트 별칭 이름 용도로 예약되어 있습니다. 자세한 내용은 S3 버킷 객체 Lambda 액세스 포인트에 버킷 스타일 별칭을 사용하는 방법 단원을 참조하십시오.

  • 버킷 이름은 파티션 내 모든 AWS 리전의 모든 AWS 계정에서 고유해야 합니다. 파티션은 리전 그룹입니다. AWS에는 aws(표준 리전), aws-cn(중국 리전) 및 aws-us-gov(AWS GovCloud (US))의 세 가지 파티션이 있습니다.

  • 동일한 파티션의 다른 AWS 계정은 버킷이 삭제될 때까지 버킷 이름을 사용할 수 없습니다.

  • Amazon S3 Transfer Acceleration에 사용되는 버킷은 이름에 점(.)을 사용할 수 없습니다. Transfer Acceleration에 대한 자세한 내용은 Amazon S3 Transfer Acceleration을 사용하여 빠르고 안전한 파일 전송 구성 단원을 참조하세요.

최상의 호환성을 위해 정적 웹 사이트 호스팅에만 사용되는 버킷을 제외하고 버킷 이름에 점(.)을 사용하지 않는 것이 좋습니다. 버킷 이름에 점을 포함하는 경우 자체 인증서 검증을 수행하지 않는 한 HTTPS를 통해 가상 호스트 스타일 주소 지정을 사용할 수 없습니다. 이는 버킷의 가상 호스팅에 사용되는 보안 인증서가 이름에 점이 있는 버킷에 대해 작동하지 않기 때문입니다.

정적 웹 사이트 호스팅은 HTTP를 통해서만 사용할 수 있기 때문에 이 제한은 정적 웹 사이트 호스팅에 사용되는 버킷에는 영향을 주지 않습니다. 가상 호스트 방식 주소 지정에 대한 자세한 내용은 버킷의 가상 호스팅 단원을 참조하세요. 정적 웹 사이트 호스팅에 대한 자세한 내용은 Amazon S3를 사용하여 정적 웹 사이트 호스팅 단원을 참조하세요.

참고

2018년 3월 1일 이전에 미국 동부(버지니아 북부) 리전에서 생성된 버킷의 이름은 최대 255자이며 대문자와 밑줄을 포함할 수 있었습니다. 2018년 3월 1일부터 미국 동부(버지니아 북부)의 새 버킷은 그 외 모든 리전에서 적용되는 것과 동일한 규칙을 준수해야 합니다.

객체 키 이름에 대한 자세한 내용은 객체 키 이름 생성을 참조하세요.

범용 버킷 이름 예시

다음 예시 버킷 이름은 유효하며 범용 버킷에 대한 권장 이름 지정 지침을 따릅니다.

  • docexamplebucket1

  • log-delivery-march-2020

  • my-hosted-content

다음 예제 버킷 이름은 유효하지만 정적 웹 사이트 호스팅 이외의 용도에는 권장되지 않습니다.

  • docexamplewebsite.com

  • www.docexamplewebsite.com

  • my.example.s3.bucket

다음 예제 버킷 이름은 유효하지 않습니다.

  • doc_example_bucket(밑줄 포함)

  • DocExampleBucket(대문자 포함)

  • doc-example-bucket-(하이픈으로 끝남)

디렉터리 버킷 이름 지정 규칙

디렉터리 버킷 이름은 다음과 같아야 합니다.

  • 선택한 AWS 리전 및 가용 영역 내에서 고유해야 합니다.

  • 접미사를 포함하여 길이가 3~63자를 넘지 않아야 합니다.

  • 소문자, 숫자, 하이픈(-)으로만 구성해야 합니다.

  • 문자나 숫자로 시작하고 끝나야 합니다.

  • --azid--x-s3을 접미사로 포함해야 합니다.

참고

콘솔을 사용하여 디렉터리 버킷을 생성하면 제공하는 기본 이름에 접미사가 자동으로 추가됩니다. 이 접미사에는 선택한 가용 영역의 가용 영역 ID가 포함됩니다.

API를 사용하여 디렉터리 버킷을 생성할 때는 요청에 가용 영역 ID를 포함한 전체 접미사를 제공해야 합니다. 가용 영역 ID 목록은 S3 Express One Zone 가용 영역 및 리전 섹션을 참조하세요.