PutContainer
- 인쇄
- PDF
PutContainer
- 인쇄
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
Classic/VPC 환경에서 이용 가능합니다.
컨테이너(버킷)를 생성합니다.
참고
Subaccount의 경우, Subaccount 전용 External API Gateway를 통해 사용할 수 있습니다.
자세한 내용은 SubAccount의 PutContainer API를 참조해 주십시오.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
| 메서드 | URI |
|---|---|
| PUT | /v1/AUTH_{project_id}/{container} |
요청 헤더
헤더에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
X-Auth-Token | String | Required | 발급한 토큰(Token) 값 |
X-Container-Read | String | Optional | 해당 컨테이너(버킷)의 READ ACL(접근 권한) |
X-Container-Write | String | Optional | 해당 컨테이너(버킷)의 WRITE ACL(접근 권한) |
X-Container-Sync-Key | String | Optional | 사용하지 않음 |
X-Container-Sync-To | String | Optional | 사용하지 않음 |
X-Versions-Location | String | Optional | 사용하지 않음 |
X-History-Location | String | Optional | 사용하지 않음 |
X-Container-Meta-name | String | Optional | 해당 컨테이너(버킷)의 메타데이터
|
X-Container-Meta-Access-Control-Allow-Origin | String | Optional | CORS 설정
|
X-Container-Meta-Access-Control-Max-Age | String | Optional | CORS 설정(초)
|
X-Container-Meta-Access-Control-Expose-Headers | String | Optional | CORS 설정
|
X-Container-Meta-Quota-Bytes | String | Optional | 해당 컨테이너(버킷)의 용량 제한값 |
X-Container-Meta-Quota-Count | String | Optional | 해당 컨테이너(버킷)의 오브젝트 수의 제한값 |
X-Container-Meta-Temp-URL-Key | String | Optional | temporary URL을 위한 Secret Key 값 |
X-Container-Meta-Temp-URL-Key-2 | String | Optional | temporary URL을 위한 두 번째 Secret Key 값 |
요청 경로 파라미터
파라미터에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
project_id | String | Required | 프로젝트 ID
|
container | String | Required | 생성할 컨테이너(버킷) 이름 |
요청 예시
요청 예시는 다음과 같습니다.
컨테이너(버킷) 생성 요청
컨테이너(버킷)를 생성하는 요청 예시는 다음과 같습니다.
curl -X PUT "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}"
-H "X-Auth-Token: $token"
메타데이터를 포함한 컨테이너(버킷) 생성 요청
메타데이터를 포함한컨테이너(버킷)를 생성하는 요청 예시는 다음과 같습니다.
curl -X POST "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}"
-H "X-Auth-Token: $token"
-H "X-Container-Meta-{name}: $container-metadata-string"
ACL을 포함한 컨테이너(버킷) 생성 요청
ACL을 포함한 컨테이너(버킷)를 생성하는 요청 예시는 다음과 같습니다.
curl -X POST "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}"
-H "X-Auth-Token: $token"
-H "X-Container-Read: .r:*
응답
응답 형식을 설명합니다.
응답 헤더
Archive Storage API에서 공통으로 사용하는 응답 헤더에 대한 자세한 내용은 Archive Storage 공통 응답 헤더를 참조해 주십시오.
응답 상태 코드
응답 상태 코드에 대한 설명은 다음과 같습니다.
| HTTP 상태 코드 | 코드 | 메시지 | 설명 |
|---|---|---|---|
| 200 | - | OK | 요청 성공 |
| 204 | - | No Content | Content-Type이 plain이고, 요청에 해당되는 내용이 없는 경우 발생 |
| 403 | - | Not Found | 컨테이너(버킷)이 존재하지 않는 경우 발생 |
응답 예시
응답 예시는 다음과 같습니다.
컨테이너 생성을 요청한 경우의 응답
컨테이너 생성을 요청했을 때의 응답 예시는 다음과 같습니다.
HTTP/1.1 201 Created
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: txa8b5404ac864437293727-005b9878d1
X-Openstack-Request-Id: txa8b5404ac864437293727-005b9878d1
Date: Wed, 12 Sep 2018 02:24:17 GMT
메타데이터를 포함한 컨테이너 생성을 요청한 경우의 응답
메타데이터를 포함한 컨테이너 생성을 요청했을 때의 응답 예시는 다음과 같습니다.
HTTP/1.1 201 Created
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx8282719a30554e2b8e0c7-005b987946
X-Openstack-Request-Id: tx8282719a30554e2b8e0c7-005b987946
Date: Wed, 12 Sep 2018 02:26:14 GMT
ACL을 포함한 컨테이너 생성을 요청한 경우의 응답
ACL을 포함한 컨테이너 생성을 요청했을 때의 응답 예시는 다음과 같습니다.
HTTP/1.1 201 Created
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx691a8ed48a3f4152ae904-005b98799c
X-Openstack-Request-Id: tx691a8ed48a3f4152ae904-005b98799c
Date: Wed, 12 Sep 2018 02:27:41 GMT
이 문서가 도움이 되었습니까?