MENU
      HeadObject

        HeadObject


        기사 요약

        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'
        Curl

        응답

        응답 형식을 설명합니다.

        응답 헤더

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

        필드타입필수 여부설명
        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
        HTTP

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

        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.