PutBucket
최신 업데이트：2025-08-18 15:50:16
이 API는 스토리지 버킷을 생성하는 데 사용됩니다. 해당 작업을 수행하려면 wos:PutBucket 권한이 필요합니다.
요청 문법
PUT / HTTP/1.1
Host: BucketName.s3-cn-south-6.wcsapi.com
Date: GMT Date
Authorization: SignatureValue
URI 요청 파라미터
없음
요청 헤더
common request headers 만 사용하세요.
요청 본문
요청 본문은 아래와 같은 XML 포맷이어야 합니다:
| 요소명 | 설명 | 필수 여부 |
|---|---|---|
| CreateBucketConfiguration | 버킷 설정 목록을 정의합니다. 타입: XML 자식 노드: Rule 부모 노드: 없음 |
예 |
| StorageClass | 버킷의 스토리지 클래스를 지정합니다. 지원 값: Standard, IA, Archive (기본값은 사용자 설정 값). 타입: XML 부모 노드: CreateBucketConfiguration |
아니오 |
응답 문법
HTTP/1.1 200 OK
x-wos-request-id: request id
Content-Type: type
Date: date
Content-Length: length
Server: WS-web-server
응답 헤더
common response headers 만 사용하세요.
응답 요소
없음
예외 시나리오
| 사유 | HTTP 상태 코드 | 오류 코드 |
|---|---|---|
| 버킷 이름이 유효하지 않음 | 400 | InvalidBucketName |
| 이미 버킷이 존재함 | 409 | BucketAlreadyExists |
| IAM 인증 실패 | 403 | AccessDenied |
| 올바르지 않은 스토리지 클래스 | 400 | InvalidStorageClass |
| 지역에 스토리지 서비스가 활성화되지 않음 | 403 | Standard storage service in XX not enabled. |
| 지정된 스토리지 클래스가 존재하지 않음(대소문자 구분) | 400 | InvalidStorageClass |
예시
아래 예시는 x-amz-storage-class 헤더 또는 XML 본문의 StorageClass 요소를 사용해 스토리지 클래스를 지정하는 방법을 보여줍니다.
PUT / HTTP/1.1
Host: BucketName.s3-cn-south-6.wcsapi.com
Date: GMT Date
Authorization: SignatureValue
x-amz-storage-class: Standard, IA, Archive
<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>
<StorageClass>Standard</StorageClass>
</CreateBucketConfiguration>
HTTP/1.1 200 OK
x-amz-request-id: 534B371674E88A4D8906****
Date: Fri, 24 Feb 2017 03:15:40 GMT
Content-Length: 0
Connection: keep-alive
Server: WCS-Web-Server
Location: /bucketName
이 문서의 내용이 도움이 되었습니까?
예
아니오