PutContainer

Prev Next

개요

컨테이너(버킷)을 생성합니다.

구문

PUT /v1/AUTH_{project_id}/{container}

요청

명칭 In 타입 설명
project_id path string 프로젝트 ID 입력
container path string 생성할 컨테이너(버킷) 이름 입력
최소 3글자 이상, 최대 30자까지만 입력 가능
slash(/)가 포함되게 되면, {container}/{object}로 인식하므로 주의
X-Auth-Token (Optional) header string 발급한 Token 값 입력
X-Container-Read (Optional) header string 해당 컨테이너의 READ ACL
X-Container-Write (Optional) header string 해당 컨테이너의 WRITE ACL
X-Container-Sync-Key (Optional) header string not supported
X-Container-Sync-To (Optional) header string not supported
X-Versions-Location (Optional) header string not supported
X-History-Location (Optional) header string not supported
X-Container-Meta-name (Optional) header string 해당 컨테이너(버킷)의 메타데이터를 세팅 (헤더명의 name 부분이 메타데이터의 키 역할을 함)
추가, 업데이트, 삭제가 가능하며, 삭제는 빈 값으로 요청
X-Container-Meta-Access-Control-Allow-Origin (Optional) header string CORS
X-Container-Meta-Access-Control-Max-Age (Optional) header string CORS
X-Container-Meta-Access-Control-Expose-Headers (Optional) header string CORS
X-Container-Meta-Quota-Bytes (Optional) header string 해당 컨테이너(버킷)의 용량 제한값 입력
(bytes) 용량 제한을 넘어선 이후에 제한
X-Container-Meta-Quota-Count (Optional) header string 해당 컨테이너(버킷)의 오브젝트 수의 제한값 입력
X-Container-Meta-Temp-URL-Key (Optional) header string temporary URL을 위한 Secret Key 값 입력
X-Container-Meta-Temp-URL-Key-2 (Optional) header string temporary URL을 위한 두번째 Secret Key 값 입력

응답

명칭 In 타입 설명
Date header string 해당 요청의 응답 시간 (UTC)
Content-Length header string 응답 결과의 길이 (Bytes)
Content-Type (Optional) header string 응답 결과의 MIME 타입
X-Trans-Id header string 해당 요청의 트랜젝션 ID
X-Openstack-Request-Id header string 해당 요청의 트랜젝션 ID (X-Trans-Id와 동일)

예시

요청 예시(컨테이너 생성)

curl -i -X PUT -H "X-Auth-Token: $token" https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}/{container}

응답 예시

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

요청 예시(컨테이너 생성, 메타데이터 포함)

curl -i -X PUT -H "X-Auth-Token: $token" -H "X-Container-Meta-Book: ncloud-book" -H "X-Container-Meta-Subject: ncloud-test-subject" https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}/{container}

응답 예시

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 포함)

curl -i -X PUT -H "X-Auth-Token: $token" -H "X-Container-Read: .r:* https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}/{container}

응답 예시

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

요청이 성공하게 되면 Created (201), Accepted (202) 상태 코드를 응답합니다.
Accepted (202)인 경우는 이미 해당 컨테이너(버킷)가 존재 하고, 메타데이터 등을 변경 할 때 발생합니다.
컨테이너(버킷)이 존재하지 않는 경우는 Not Found (404) 상태 코드를 응답합니다.