MENU
      PutContainer

        PutContainer


        기사 요약

        Classic/VPC 환경에서 이용 가능합니다.

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

        참고

        Subaccount의 경우, Subaccount 전용 External API Gateway를 통해 사용할 수 있습니다.
        자세한 내용은 SubAccount의 PutContainer API를 참조해 주십시오.

        요청

        요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

        메서드URI
        PUT/v1/AUTH_{project_id}/{container}

        요청 헤더

        헤더에 대한 설명은 다음과 같습니다.

        필드타입필수 여부설명
        X-Auth-TokenStringRequired발급한 토큰(Token) 값
        X-Container-ReadStringOptional해당 컨테이너(버킷)의 READ ACL(접근 권한)
        X-Container-WriteStringOptional해당 컨테이너(버킷)의 WRITE ACL(접근 권한)
        X-Container-Sync-KeyStringOptional사용하지 않음
        X-Container-Sync-ToStringOptional사용하지 않음
        X-Versions-LocationStringOptional사용하지 않음
        X-History-LocationStringOptional사용하지 않음
        X-Container-Meta-nameStringOptional해당 컨테이너(버킷)의 메타데이터
        • 헤더명의 name 부분이 메타데이터의 키 역할을 함
        • 추가, 업데이트, 삭제 가능하며, 삭제는 빈 값으로 요청
        X-Container-Meta-Access-Control-Allow-OriginStringOptionalCORS 설정
        • 접근 가능한 소스 도메인
        X-Container-Meta-Access-Control-Max-AgeStringOptionalCORS 설정(초)
        • 결과를 캐싱할 수 있는 최대 시간
        X-Container-Meta-Access-Control-Expose-HeadersStringOptionalCORS 설정
        • 노출되지 않으나 접근을 허용하는 헤더
        X-Container-Meta-Quota-BytesStringOptional해당 컨테이너(버킷)의 용량 제한값
        X-Container-Meta-Quota-CountStringOptional해당 컨테이너(버킷)의 오브젝트 수의 제한값
        X-Container-Meta-Temp-URL-KeyStringOptionaltemporary URL을 위한 Secret Key 값
        X-Container-Meta-Temp-URL-Key-2StringOptionaltemporary URL을 위한 두 번째 Secret Key 값

        요청 경로 파라미터

        파라미터에 대한 설명은 다음과 같습니다.

        필드타입필수 여부설명
        project_idStringRequired프로젝트 ID
        containerStringRequired생성할 컨테이너(버킷) 이름

        요청 예시

        요청 예시는 다음과 같습니다.

        컨테이너(버킷) 생성 요청

        컨테이너(버킷)를 생성하는 요청 예시는 다음과 같습니다.

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

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

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

        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"
        Curl

        ACL을 포함한 컨테이너(버킷) 생성 요청

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

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

        응답

        응답 형식을 설명합니다.

        응답 헤더

        Archive Storage API에서 공통으로 사용하는 응답 헤더에 대한 자세한 내용은 Archive Storage 공통 응답 헤더를 참조해 주십시오.

        응답 상태 코드

        응답 상태 코드에 대한 설명은 다음과 같습니다.

        HTTP 상태 코드코드메시지설명
        200-OK요청 성공
        204-No ContentContent-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

        메타데이터를 포함한 컨테이너 생성을 요청한 경우의 응답

        메타데이터를 포함한 컨테이너 생성을 요청했을 때의 응답 예시는 다음과 같습니다.

        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
        HTTP

        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
        HTTP

        이 문서가 도움이 되었습니까?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.