HeadObject
    • PDF

    HeadObject

    • PDF

    기사 요약

    개요

    오브젝트의 메타데이터를 조회합니다.

    구문

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

    요청

    명칭In타입설명
    project_idpathstring프로젝트 ID 입력
    containerpathstring컨테이너(버킷) 이름 입력
    objectpathstring오브젝트의 이름 입력
    X-Auth-Token (Optional)headerstring발급한 Token 값 입력
    temp_url_sigquerystringtemp url
    temp_url_expiresqueryintegertemp url
    filename (Optional)querystringtem url
    multipart-manifest (Optional)querystringmultipart-manifest=get 이고, 해당 오브젝트가 대용량 오브젝인인 경우, 오브젝트의 메타데이터 대신 매니페스트 메타데이터와 dynamic 대용량 메타데이터의 X-Object-Manifest 헤더가 응답함
    X-Newest (Optional)headerbooleantrue인 경우, 모든 복제본에 대해 질의를 하고 가장 최근 복제본의 정보로 응답
    해당 헤더가 생략된 경우, 가장 응답이 빠른 정보로 응답
    If-Match (Optional)headerstringETag 조건 헤더 (자세한 정보는 해당 링크에서 확인 : RFC2616 )
    If-None-Match (Optional)headerstringETag 조건 헤더 (자세한 정보는 해당 링크에서 확인 : RFC2616)
    If-Modified-Since (Optional)headerstringLast-Modified 조건 헤더 (자세한 정보는 해당 링크에서 확인 : RFC2616)
    If-Unmodified-Since (Optional)headerstringLast-Modified 조건 헤더 (자세한 정보는 해당 링크에서 확인 : RFC2616)

    응답

    명칭In타입설명
    Content-Lengthheaderstring응답 결과의 길이 (Bytes)
    X-Object-Meta-name (Optional)headerstring해당 오브젝트의 메타데이터 (헤더명의 name 부분이 메타데이터의 키 역할을 함)
    Content-Disposition (Optional)headerstring브라우저에 대한 작동 재정의
    Content-Encoding (Optional)headerstring해당 오브젝트의 인코딩 방식
    X-Delete-At (Optional)headerinteger해당 오브젝트의 삭제 예정 시간 (UNIX Time)
    X-Object-Manifest (Optional)headerstring해당 오브젝트가 대용량 오브젝트(DLO)인 경우 응답되며 세그먼트 오브젝트의 경로가 나타남
    Last-Modifiedheaderstring해당 오브젝트가 수정된 가장 최근 시간 (UTC)
    ETagheaderstringETag 헤더 값
    X-Timestampheaderstring해당 요청의 응답 시간 (Unix Epoch timestamp)
    X-Trans-Idheaderstring해당 요청의 트랜젝션 ID
    X-Openstack-Request-Idheaderstring해당 요청의 트랜젝션 ID (X-Trans-Id와 동일)
    Dateheaderstring해당 요청의 응답 시간 (UTC)
    X-Static-Large-Objectheaderbooleantrue인 경우, 해당 오브젝트는 대용량 오브젝트(SLO)의 매니페스트 오브젝트
    Content-Typeheaderstring응답 결과의 MIME 타입

    예시

    요청 예시

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

    응답 예시

    HTTP/1.1 200 OK
    Content-Length: 10485760
    Accept-Ranges: bytes
    Last-Modified: Mon, 17 Sep 2018 07:43:40 GMT
    Etag: f1c9645dbc14efddc7d8a322685f26eb
    X-Timestamp: 1537170219.48936
    Content-Type: application/x-www-form-urlencoded
    X-Trans-Id: tx9cdb2e24ab934e55aebd6-005b9f6a91
    X-Openstack-Request-Id: tx9cdb2e24ab934e55aebd6-005b9f6a91
    Date: Mon, 17 Sep 2018 08:49:21 GMT
    

    오브젝트 메타데이터를 조회합니다.
    요청이 성공하게 되면 OK (200) 상태 코드를 응답합니다.


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

    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.