PutContainer

Prev Next

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 해당 컨테이너(버킷)의 메타데이터
  • 헤더명의 name 부분이 메타데이터의 키 역할을 함
  • 추가, 업데이트, 삭제 가능하며, 삭제는 빈 값으로 요청
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.gov-ncloudstorage.com/v1/AUTH_{project_id}/{container}" 
-H "X-Auth-Token: $token"

메타데이터를 포함한 컨테이너(버킷) 생성 요청

메타데이터를 포함한컨테이너(버킷)를 생성하는 요청 예시는 다음과 같습니다.

curl -X POST "https://kr.archive.gov-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.gov-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