Download Files
최신 업데이트：2025-08-18 15:32:05
이 인터페이스는 오브젝트 스토리지 플랫폼에서 지정된 리소스 파일을 다운로드할 수 있는 기능을 제공합니다. 표준 HTTP 파일 다운로드 프로토콜을 지원하여, 다양한 리소스 유통 시나리오의 요구를 충족할 수 있습니다.
요청 설명
기본 요청 형식
파일 다운로드는 표준 HTTP GET 방식을 사용합니다. 자세한 내용은 RFC2616 Standard를 참고하세요.
http://<domain>/<key>?<param1>=<value1>&<param2>=<value2>...
분할 다운로드(구간 다운로드) 요청 형식
다운로드 시, 표준 HTTP Range 요청 헤더를 사용하여 구간(부분) 다운로드 및 중단 후 이어받기(resume) 기능을 지원할 수 있습니다.
Range: bytes=<first-byte>-<last-byte>
- 예를 들어, 파일의 전체 길이가 1000 byte인 경우, 다양한 Range 헤더 값에 따른 응답 동작은 아래와 같습니다.
| Range 헤더 | 응답 설명 | 상태 코드 |
|---|---|---|
Range: bytes=0-888 |
0~888 byte(총 889 byte) 반환 | 206 Partial Content |
Range: bytes=666-888 |
666~888 byte(총 223 byte) 반환 | 206 Partial Content |
Range: bytes=-888 |
파일의 마지막 888 byte 반환 | 206 Partial Content |
Range: bytes=-1888 (끝 오프셋이 파일 크기를 초과) |
전체 파일(1000 byte) 반환 | 206 Partial Content |
Range: bytes=666- |
666 byte부터 파일 끝(334 byte)까지 반환 | 206 Partial Content |
Range: bytes=1-1888 (끝 오프셋이 파일 크기를 초과) |
1 byte부터 파일 끝까지 반환 | 206 Partial Content |
Range: bytes=1666-1888 (시작 오프셋이 파일 크기 초과) |
반환되는 데이터 없음 | 416 Requested Range Not Satisfiable |
Range: bytes=888-666 (시작 오프셋이 끝 오프셋보다 큼) |
반환되는 데이터 없음 | 416 Requested Range Not Satisfiable |
Range: bytes=-a888- (잘못된 범위 형식) |
반환되는 데이터 없음 | 416 Requested Range Not Satisfiable |
응답 설명
표준 다운로드 응답
다운로드 요청의 응답은 HTTP GET 요청 명세에 따릅니다. 자세한 내용은 RFC2616 Standard를 참고하세요.
Append-Uploaded 객체를 위한 특수 헤더
Append 업로드된 오브젝트의 경우, 응답 시 다음 두 개의 헤더가 추가됩니다.
x-wcs-object-type: Appendable
x-next-append-position: <Content-Length int64>
위 두 헤더는 오브젝트의 타입 및 다음 append 위치를 식별하는 데 사용됩니다.
예시
curl -v -o 1.png http://downloadDomain/1.png
이 문서의 내용이 도움이 되었습니까?
예
아니오