HeadContainer
    • PDF

    HeadContainer

    • PDF

    기사 요약

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

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

    참고

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

    요청

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

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

    요청 헤더

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

    필드타입필수 여부설명
    X-Auth-TokenStringRequired발급한 토큰(Token) 값
    X-NewestBooleanOptional가장 최근 복제본의 정보로 응답할지 여부를 설정
    • true | false
      • true: 모든 복제본에 대해 질의를 하고 가장 최근 복제본의 정보로 응답
    • 헤더가 생략된 경우, 응답이 가장 빠른 정보로 응답

    요청 경로 파라미터

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

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

    요청 예시

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

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

    응답

    응답 형식을 설명합니다.

    응답 헤더

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

    필드타입필수 여부설명
    Content-TypeString-응답 결과의 MIME 타입
    Content-LengthString-응답 결과의 길이 (Byte)
    X-Container-Object-CountInteger-해당 컨테이너(버킷)의 전체 오브젝트 개수
    X-Container-Bytes-UsedInteger-해당 컨테이너(버킷)가 사용하는 전체 용량 크기(Byte)
    X-TimestampInteger-컨테이너(버킷)가 생성된 시각(UNIX timestamp)
    X-Container-ReadString-해당 컨테이너(버킷)의 READ ACL(접근 권한)
    X-Container-WriteString-해당 컨테이너(버킷)의 WRITE ACL(접근 권한)
    Last-ModifiedString-해당 컨테이너(버킷)의 가장 최근 수정 시간(UTC)
    Accept-RangesString-해당 컨테이너(버킷)가 허용하는 범위 유형
    X-Storage-PolicyString-해당 컨테이너(버킷)의 Storage Policy 값
    X-Trans-IdString-해당 요청의 트랜잭션 ID
    X-Openstack-Request-IdString-해당 요청의 트랜잭션 ID
    • X-Trans-Id와 동일
    X-Container-Meta-nameString-해당 컨테이너(버킷)의 메타데이터
    • 헤더명의 name 부분이 메타데이터의 키 역할을 함
    X-Container-Meta-Quota-CountString-해당 컨테이너(버킷)의 오브젝트 수의 제한값
    X-Container-Meta-Quota-BytesString-해당 컨테이너(버킷)의 용량 제한값
    X-Container-Meta-Access-Control-Allow-OriginString-CORS 설정
    • 입력된 접근 가능 도메인
    X-Container-Meta-Access-Control-Max-AgeString-CORS 설정
    • 입력된 결과 캐싱의 최대 시간(초)
    X-Container-Meta-Access-Control-Expose-HeadersString-CORS 설정
    • 입력된 접근 허용 헤더
    X-Container-Meta-Temp-URL-KeyString-Temporary URL을 위한 Secret Key 값
    X-Container-Meta-Temp-URL-Key-2String-Temporary URL을 위한 두 번째 Secret Key 값
    X-Container-Sync-KeyString-사용하지 않음
    X-Container-Sync-ToString-사용하지 않음
    X-Versions-LocationString-사용하지 않음
    X-History-LocationString-사용하지 않음
    DateString-해당 요청의 응답 시간(UTC)

    응답 예시

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

    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
    

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

    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.