HeadContainer
    • PDF

    HeadContainer

    • PDF

    기사 요약

    개요

    컨테이너(버킷)의 메타데이터를 조회합니다.

    구문

    HEAD /v1/AUTH_{project_id}/{container}
    

    요청

    명칭In타입설명
    project_idpathstring프로젝트 ID 입력
    containerpathstring조회할 컨테이너(버킷) 이름 입력
    slash(/)가 포함되게 되면, {container}/{object}로 인식하므로 주의
    X-Auth-Token (Optional)headerstring발급한 Token 값 입력
    X-Newest (Optional)headerbooleantrue인 경우, 모든 복제본에 대해 질의를 하고 가장 최근 복제본의 정보로 응답
    해당 헤더가 생략된 경우, 가장 응답이 빠른 정보로 응답

    응답

    명칭In타입설명
    X-Container-Meta-nameheaderstring해당 컨테이너(버킷)의 메타데이터 (헤더명의 name 부분이 메타데이터의 키 역할을 함)
    Content-Lengthheaderstring응답 결과의 길이 (Bytes)
    X-Container-Object-Countheaderinteger해당 컨테이너(버킷)의 오브젝트 개수
    X-Container-Bytes-Usedheaderinteger해당 컨테이너(버킷)가 사용하는 전체 용량 크기 (Bytes)
    X-Container-Read (Optional)headerstring해당 컨테이너의 READ ACL
    X-Container-Write (Optional)headerstring해당 컨테이너의 WRITE ACL
    X-Container-Meta-Quota-Bytes (Optional)headerstring해당 컨테이너(버킷)의 용량 제한값 (bytes)
    X-Container-Meta-Quota-Count (Optional)headerstring해당 컨테이너(버킷)의 오브젝트 수의 제한값
    X-Container-Meta-Access-Control-Allow-Origin (Optional)headerstringCORS
    X-Container-Meta-Access-Control-Max-Age (Optional)headerstringCORS
    X-Container-Meta-Access-Control-Expose-Headers (Optional)headerstringCORS
    X-Container-Meta-Temp-URL-Key (Optional)headerstringtemporary URL을 위한 Secret Key 값
    X-Container-Meta-Temp-URL-Key-2 (Optional)headerstringtemporary URL을 위한 두번째 Secret Key 값
    X-Timestampheaderinteger해당 컨테이너(버킷)가 생성된 시각 (UNIX Time)
    X-Container-Sync-Key (Optional)headerstringnot supported
    X-Container-Sync-To (Optional)headerstringnot supported
    Dateheaderstring해당 요청의 응답 시간 (UTC)
    X-Trans-Idheaderstring해당 요청의 트랜젝션 ID
    X-Openstack-Request-Idheaderstring해당 요청의 트랜젝션 ID (X-Trans-Id와 동일)
    Content-Type (Optional)headerstring응답 결과의 MIME 타입
    X-Versions-Location (Optional)headerstringnot supported
    X-History-Location (Optional)headerstringnot supported

    예시

    요청 예시(컨테이너 메타데이터 조회)

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

    응답 예시

    HTTP/1.1 204 No Content
    Content-Length: 0
    X-Container-Object-Count: 3
    X-Timestamp: 1536631895.01856
    Accept-Ranges: bytes
    Last-Modified: Tue, 11 Sep 2018 02:11:36 GMT
    X-Container-Bytes-Used: 630036
    Content-Type: text/plain; charset=utf-8
    X-Trans-Id: tx51f8478e8e924403851a4-005b988014
    X-Openstack-Request-Id: tx51f8478e8e924403851a4-005b988014
    Date: Wed, 12 Sep 2018 02:55:16 GMT
    

    요청이 성공하게 되면 No Content (204) 상태 코드를 응답합니다.


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

    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.