GetObject
    • PDF

    GetObject

    • PDF

    기사 요약

    개요

    오브젝트를 다운로드하고 메타데이터를 조회합니다.
    Response Header를 통해 오브젝트 메타데이터를 응답받고 Response Body를 통해 오브젝트 내용을 다운 받습니다.
    만약 대용량 오브젝트인 경우 Response Body는 세그먼트 오브젝트의 연결 내용을 포함합니다.
    Static 대용량 오브젝트에 대한 매니페스트를 가져오려면 multipart-manifest 파라미터를 사용하시면 됩니다.

    구문

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

    요청

    명칭In타입설명
    project_idpathstring프로젝트 ID 값 입력
    containerpathstring컨테이너(버킷) 이름 입력
    objectpathstring오브젝트의 이름 입력
    X-Auth-Token (Optional)headerstring발급한 Token 값 입력
    X-Newest (Optional)headerbooleantrue인 경우, 모든 복제본에 대해 질의를 하고 가장 최근 복제본의 정보로 응답
    해당 헤더가 생략된 경우, 가장 응답이 빠른 정보로 응답
    temp_url_sigquerystringtemporary url
    temp_url_expiresqueryintegertemporary url
    filename (Optional)querystringtemporary url
    multipart-manifest (Optional)querystring해당 오브젝트가 대용량 오브젝트이고 (X-Static-Large-Object: True) 해당 파라미터가 True인 경우, 세그먼트 오브젝트들의 연결 정보로 응답
    Range (Optional)headerstring대상 오브젝트의 범위를 지정하여 호출
    Range: Bytes=-5 (마지막 5Bytes)
    Range: Bytes=-6 (6Byte 이후부터 Range: Bytes=10-15 (10Byte부터 6Bytes)
    Range: Bytes=10-15, -5 (10Bytes부터 6Bytes, 마지막 5Bytes, Content-Type이 multipart/byteranges)
    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)
    Content-Typeheaderstring응답 결과의 MIME 타입
    X-Object-Meta-name (Optional)headerstring해당 오브젝트의 메타데이터 (헤더명의 name 부분이 메타데이터의 키 역할을 함)
    Content-Disposition (Optional)headerstring브라우저에 대한 작동 재정의
    Content-Encoding (Optional)headerstring해당 오브젝트의 인코딩 방식
    X-Delete-At (Optional)headerinteger해당 오브젝트의 삭제 예정 시간 (Unix Epoch timestamp)
    Accept-Rangesheaderstring해당 오브젝트가 허용하는 Range 타입
    X-Object-Manifest (Optional)headerstring- 대용량 오브젝트(DLO) 매니페스트
    형태는 {container}/{prefix}
    Last-Modifiedheaderstring해당 오브젝트가 수정된 가장 최근 시간 (UTC)
    ETagheaderstringETag 헤더 값
    X-Timestampheaderinteger해당 오브젝트가 처음으로 생성된 시각 (UNIX Time)
    X-Trans-Idheaderstring해당 요청의 트랜젝션 ID
    X-Openstack-Request-Idheaderstring해당 요청의 트랜젝션 ID (X-Trans-Id와 동일합니다.)
    Dateheaderstring해당 요청의 응답 시간 (UTC)
    X-Static-Large-Objectheaderboolean대용량 오브젝트(SLO) 여부

    예시

    요청 예시

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

    응답 예시

    HTTP/1.1 200 OK
    Content-Length: 210012
    Accept-Ranges: bytes
    Last-Modified: Tue, 11 Sep 2018 02:12:30 GMT
    Etag: 9bd5b4f25faf491080654a34d57c3636
    X-Timestamp: 1536631949.99141
    Content-Type: text/plain
    X-Trans-Id: tx9b5c78b06d0f41c5bd4bf-005b989fb7
    X-Openstack-Request-Id: tx9b5c78b06d0f41c5bd4bf-005b989fb7
    Date: Wed, 12 Sep 2018 05:10:15 GMT
    

    요청이 성공하게 되면 OK (200) 상태 코드를 응답합니다.
    Range 파라미터를 통해 오브젝트 내용의 일부분의 요청이 성공하게 되면 Partial Content (206) 상태코드를 응답합니다.
    해당 오브젝트가 없으면 Not Found (400) 상태코드를 응답합니다.


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

    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.