버킷을 만들 때 버킷의 지리적 위치와 버킷의 스토리지 클래스를 지정할 수 있습니다.
잘못된 이름으로 버킷을 만들려고 시도하면
400 잘못된 요청 오류 응답 본문에는InvalidBucketName 다음
Code 요소
프로젝트에 대한 권한이 있는 프로젝트에만 버킷을 만들 수 있습니다. 예를 들어 프로젝트에 대한 스토리지 관리자 역할이 있으면 버킷을 만드는 데 필요한 권한 (storage.objects.create)이 있는 것입니다.
또한 버킷 네임스페이스는 전역이므로 버킷 이름은 전체 Cloud Storage 네임스페이스에서 고유해야 합니다. 버킷 이름을 사용 중인 경우 409 충돌 상태 코드가 발생하고 버킷 생성 요청이 실패합니다. 오류 응답의 본문에서는 버킷이 네임스페이스에 이미 있거나 Code 요소에 BucketAlreadyOwnedByYou 요소가 있는 경우 Code 요소의 BucketAlreadyExists이 포함됩니다. 소유하고 있는지 확인합니다. 자세한 내용은 버킷 이름 지정 가이드라인 및 객체 이름 지정 가이드라인을 참조하세요.
쿼리 문자열 매개변수
이 요청에는 일반적으로 쿼리 문자열 매개변수가 포함되지 않습니다.
서명된 URL을 만들고 사용할 때 포함되는 매개변수에 대한 정보는 서명된 URL 쿼리 문자열 매개변수를 참조하세요.
요청 헤더
공통 요청 헤더 외에도 다음을 사용할 수 있습니다.
| 헤더 | 설명 | 필수 |
|---|---|---|
x-goog-acl |
버킷에 적용하려는 사전 정의된 액세스제어 목록 (ACL) acl 쿼리 문자열 매개변수를 사용하여 ACL을 적용하는 경우에는 사용하지 않습니다. |
없음 |
x-goog-bucket-retention-period |
버킷의 객체를 교체하거나 삭제하기 전에 유지해야 하는 시간(초)입니다. | 없음 |
x-goog-project-id |
프로젝트의 프로젝트 ID입니다. 상호 운용 가능한 액세스를 위해 기본 프로젝트를 설정하지 않은 경우 필요합니다. | 없음 |
요청 본문 요소
다음 요청 본문 요소는 버킷을 만들 때 적용됩니다. 요청 본문을 지정하지 않으면 Cloud Storage는 US 위치에 STANDARD 스토리지 클래스를 사용하여 버킷을 만듭니다.
| 요소 | 설명 |
|---|---|
CreateBucketConfiguration |
본문 만들기 요청 컨테이너 |
LocationConstraint |
버킷의 위치 |
StorageClass |
버킷의 스토리지 클래스(예: STANDARD, NEARLINE, COLDLINE 또는 ARCHIVE) |
요청 구문
PUT / HTTP/1.1 Host: BUCKET_NAME.storage.googleapis.com Date: DATE Content-Length: REQUEST_BODY_LENGTH Authorization: AUTHENTICATION_STRING x-goog-project-id: PROJECT_ID x-goog-acl: PREDEFINED_ACL x-goog-bucket-retention-period: TIME_IN_SECONDS <CreateBucketConfiguration> <LocationConstraint>LOCATION</LocationConstraint> <StorageClass>STORAGE_CLASS</StorageClass> </CreateBucketConfiguration>
응답 헤더
이 요청은 사용 중인 요청 헤더에 따라 다양한 응답 헤더를 반환할 수 있습니다.
응답 본문 요소
응답의 응답 본문에 XML 문서가 없습니다.
예
다음 샘플은 US 위치 및 지정된 프로젝트에서 acme-pets라는 표준 스토리지 버킷을 만듭니다 (요청 본문이 지정되지 않음).
요청
PUT / HTTP/1.1 Host: acme-pets.storage.googleapis.com Date: Mon, 15 Feb 2008 21:30:39 GMT Content-Length: 0 x-goog-project-id: 123456789123 Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg <CreateBucketConfiguration> <StorageClass>STANDARD</StorageClass> </CreateBucketConfiguration>
응답
HTTP/1.1 200 OK Date: Mon, 15 Feb 2010 12:30:40 GMT Content-Length: 0