HeadObject
    • PDF

    HeadObject

    • PDF

    기사 요약

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

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

    요청

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

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

    요청 헤더

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

    필드타입필수 여부설명
    X-Auth-TokenStringOptional발급한 토큰 값
    X-NewestBooleanOptional가장 최근 복제본의 정보로 응답할지 여부를 설정
    • true | false
      • true: 모든 복제본에 대해 질의를 하고 가장 최근 복제본의 정보로 응답
    • 헤더가 생략된 경우, 응답이 가장 빠른 정보로 응답
    If-MatchStringOptionalETag 조건 헤더
    • 자세한 내용은 RFC2616에서 확인
    If-None-MatchStringOptionalETag 조건 헤더
    • 자세한 내용은 RFC2616에서 확인
    If-Modified-SinceStringOptionalLast-Modified 조건 헤더
    • 자세한 내용은 RFC2616에서 확인
    If-Unmodified-SinceStringOptionalLast-Modified 조건 헤더
    • 자세한 내용은 RFC2616에서 확인

    요청 경로 파라미터

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

    필드타입필수 여부설명
    project_idStringRequired프로젝트 ID
    containerStringRequired대상 오브젝트가 저장될 컨테이너 이름
    objectStringRequired대상 오브젝트 이름

    요청 예시

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

    curl -L -I 'https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}' \
    -H 'X-Auth-Token: {token}' \
    -H 'X-Newest: true'
    

    응답

    응답 형식을 설명합니다.

    응답 헤더

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

    필드타입필수 여부설명
    Content-TypeString-응답 결과의 MIME 타입
    Content-LengthString-응답 결과의 길이(Byte)
    X-Object-Meta-{name}String-오브젝트의 메타데이터
    • {name} 부분이 메타데이터의 키
    • 헤더 값이 메타데이터 값
    Cache-ControlString-요청과 응답의 캐싱 규칙
    ETagString-ETag 헤더 값
    Last-ModifiedString-오브젝트의 가장 최근 수정 시간(UTC)
    X-TimestampString-요청에 대한 응답 시간(Unix Timestamp)
    Content-DispositionString-브라우저의 응답 처리 방식
    Content-EncodingString-오브젝트의 인코딩 방식
    X-Delete-AtInteger-오브젝트의 자동 삭제 활성화 시 삭제 예정 시각(Unix Timestamp)
    X-Object-ManifestString-대용량 오브젝트(SLO)인 경우 응답
    • 파트의 저장 경로 표시
    X-Static-Large-ObjectBoolean-대용량 오브젝트(SLO) 여부
    • true | false
      • true: 해당 오브젝트는 대용량 오브젝트의 매니페스트
    Accept-RangesString-클라이언트의 일부 범위 요청에 대한 서버의 수용 여부
    X-Trans-IdString-해당 요청의 트랜잭션 ID
    X-Openstack-Request-IdString-해당 요청의 트랜잭션 ID
    • X-Trans-Id와 동일
    DateString-요청에 대한 응답 시간(UTC)

    응답 상태 코드

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

    HTTP 상태 코드코드메시지설명
    200-OK요청 성공

    응답 예시

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

    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
    

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

    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.