PostContainer
    • PDF

    PostContainer

    • PDF

    기사 요약

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

    컨테이너(버킷)에 메타데이터를 설정하거나 변경합니다.

    참고

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

    요청

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

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

    요청 헤더

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

    필드타입필수 여부설명
    X-Auth-TokenStringOptional발급한 토큰(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-Remove-Versions-LocationStringOptional사용하지 않음
    X-Remove-History-LocationStringOptional사용하지 않음
    X-Container-Meta-nameStringOptional해당 컨테이너(버킷)의 메타데이터
    • 헤더명의 name 부분이 메타데이터의 키 역할을 함
    • 추가, 업데이트, 삭제 가능하며, 삭제는 빈 값으로 요청
    X-Remove-Container-Meta-nameStringOptional해당 컨테이너(버킷)의 메타데이터 삭제
    • 헤더명의 name 부분이 메타데이터의 키 역할을 함
    • X-Remove-Container-Read 혹은 X-Remove-Container-Meta-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 POST "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}" 
    -H "X-Auth-Token: $token"
    -H "X-Container-Meta-{name}: $container-metadata-string"
    

    컨테이너 메타데이터 업데이트 요청

    컨테이너의 메타데이터를 업데이트하는 요청 예시는 다음과 같습니다.

    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 -X POST "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}" 
    -H "X-Auth-Token: $token"
    -H "X-Remove-Container-Meta-{name}: $container-metadata-string"
    

    응답

    응답 형식을 설명합니다.

    응답 헤더

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

    응답 예시

    응답 예시는 다음과 같습니다.

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

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

    HTTP/1.1 204 No Content
    Content-Length: 0
    Content-Type: text/html; charset=UTF-8
    X-Trans-Id: txefe14b178c56469b8576f-005b987d66
    X-Openstack-Request-Id: txefe14b178c56469b8576f-005b987d66
    Date: Wed, 12 Sep 2018 02:43:50 GMT
    

    컨테이너 메타데이터 업데이트를 요청한 경우의 응답

    컨테이너의 메타데이터 업데이트를 요청했을 때의 예시는 다음과 같습니다.

    HTTP/1.1 204 No Content
    Content-Length: 0
    Content-Type: text/html; charset=UTF-8
    X-Trans-Id: tx66932a917b854a458544a-005b987d78
    X-Openstack-Request-Id: tx66932a917b854a458544a-005b987d78
    Date: Wed, 12 Sep 2018 02:44:08 GMT
    

    컨테이너 메타데이터 삭제를 요청한 경우의 응답

    컨테이너의 메타데이터 삭제를 요청했을 때의 예시는 다음과 같습니다.

    HTTP/1.1 204 No Content
    Content-Length: 0
    Content-Type: text/html; charset=UTF-8
    X-Trans-Id: tx590d9493661147e780d99-005b987df5
    X-Openstack-Request-Id: tx590d9493661147e780d99-005b987df5
    Date: Wed, 12 Sep 2018 02:46:13 GMT
    

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

    What's Next
    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.