GetObject
    • PDF

    GetObject

    • PDF

    기사 요약

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

    컨테이너(버킷)의 오브젝트를 다운로드하고 메타데이터를 조회합니다.
    응답 헤더를 통해 오브젝트 메타데이터를 확인하고, 응답 바디를 통해 오브젝트 내용을 다운 받습니다.
    대용량 오브젝트인 경우, 응답 바디는 세그먼트 오브젝트의 연결 내용이 포함됩니다.

    요청

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

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

    요청 헤더

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

    필드타입필수 여부설명
    X-Auth-TokenStringOptional발급한 토큰 값
    X-NewestBooleanOptional가장 최근 복제본의 정보로 응답할지 여부를 설정
    • true | false
      • true: 모든 복제본에 대해 질의를 하고 가장 최근 복제본의 정보로 응답
    • 헤더가 생략된 경우, 응답이 가장 빠른 정보로 응답
    RangeStringOptional대상 오브젝트의 범위 지정
    • Bytes=-5: 마지막 5 바이트
    • Bytes=10-15: 10 바이트부터 15 바이트까지의 6 바이트
    • Bytes=10-15,-5: 10 바이트부터 15 바이트까지의 6 바이트와 마지막 5 바이트를 함께 응답, Content-Type 헤더를 multipart/byteranges로 응답
    • Bytes=6-: 6 바이트부터 마지막까지
    • Bytes=1-3,2-5: 1 바이트부터 3 바이트까지의 3 바이트와 2 바이트부터 5 바이트까지의 3 바이트를 함께 응답, Content-Type 헤더를 multipart/byteranges로 응답
    If-MatchStringOptionalETag 조건 헤더
    • 자세한 내용은 RFC2616에서 확인
    If-None-MatchStringOptionalETag 조건 헤더
    • 자세한 내용은 RFC2616에서 확인
    If-Modified-SinceStringOptionalLast-Modified 조건 헤더
    • 자세한 내용은 RFC2616에서 확인
    If-Unmodified-SinceStringOptionalLast-Modified 조건 헤더
    • 자세한 내용은 RFC2616에서 확인

    요청 경로 파라미터

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

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

    요청 쿼리 파라미터

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

    필드타입필수 여부설명
    temp_url_sigStringRequired저장할 리소스에 접근할 수 있는 임시 URL의 서명
    • 승인된 요청임을 검증
    temp_url_expiresIntegerRequired저장할 리소스에 접근할 수 있는 임시 URL의 만료 시간(Unix Timestamp)
    filenameStringConditional오브젝트를 저장할 위치 및 파일 이름
    multipart-manifestStringConditional대용량 오브젝트의 멀티파트 업로드 선언
    • Static 대용량 오브젝트에 대한 매니페스트를 가져올 때 사용
    • 값으로 put을 입력하면 멀티파트 업로드로 인식되어 파트를 한 파일로 조합하도록 서버에 지시
    • 요청 바디에 파트 조합에 대한 매니페스트를 작성해야 함

    요청 예시

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

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

    응답

    응답 형식을 설명합니다.

    응답 헤더

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

    필드타입필수 여부설명
    Content-TypeString-응답 결과의 MIME 타입
    ETagString-ETag 헤더 값
    Last-ModifiedString-오브젝트의 가장 최근 수정 시간(UTC)
    X-TimestampInteger-오브젝트가 생성된 시각(Unix Timestamp)
    Accept-RangesString-해당 오브젝트가 허용하는 범위 유형
    Content-LengthString-응답 결과의 길이(Byte)
    X-Trans-IdString-해당 요청의 트랜잭션 ID
    X-Openstack-Request-IdString-해당 요청의 트랜잭션 ID
    • X-Trans-Id와 동일
    X-Object-Meta-{name}String-설정할 메타데이터
    • {name} 부분에 메타데이터의 키 입력
    • 헤더 값에 메타데이터 값 입력
    Content-DispositionString-브라우저의 응답 처리 방식
    Content-EncodingString-오브젝트의 인코딩 방식
    X-Delete-AtInteger-오브젝트의 자동 삭제 예정 시각(Unix Timestamp)
    • 데이터를 일시적으로 저장하기 원할 때 사용
    • 입력된 일시에 오브젝트 삭제
    X-Object-ManifestString-대용량 오브젝트를 업로드할 경우 오브젝트(SLO)의 매니페스트
    • 포맷: {container}/{prefix}
    DateString-해당 요청의 응답 시간(UTC)
    X-Static-Large-ObjectBoolean-대용량 오브젝트(SLO) 여부
    • true | false

    응답 상태 코드

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

    HTTP 상태 코드코드메시지설명
    200-OK요청 성공
    206-Partial ContentRange 파라미터를 통해 오브젝트 내용 일부분의 요청 성공
    403-Not Found컨테이너(버킷)가 존재하지 않음

    응답 예시

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

    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
    

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

    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.