Download Files_API_Object Storage-CDNetworks ドキュメント

このインターフェースは、オブジェクトストレージプラットフォームから指定したリソースファイルをダウンロードする機能を提供します。標準的なHTTPファイルダウンロードプロトコルをサポートしており、さまざまなリソース配信シナリオのニーズに対応します。

リクエスト説明

基本リクエスト形式
ファイルのダウンロードは、標準的なHTTP GET仕様を利用します。詳細はRFC2616 Standardをご参照ください。

 http://<domain>/<key>?<param1>=<value1>&<param2>=<value2>...

分割ダウンロードリクエスト形式
ダウンロードの際、標準HTTPヘッダー「Range」を利用することで、マルチパートダウンロードや中断からの再開ダウンロードに対応可能です。

 Range: bytes=<first-byte>-<last-byte>

Rangeヘッダー	レスポンス内容	ステータスコード
`Range: bytes=0-888`	バイト0〜888（合計889バイト）を返却	206 Partial Content
`Range: bytes=666-888`	バイト666〜888（合計223バイト）を返却	206 Partial Content
`Range: bytes=-888`	ファイルの最後の888バイトを返却	206 Partial Content
`Range: bytes=-1888` (終端オフセットがファイルサイズを超過)	ファイル全体（1,000バイト）を返却	206 Partial Content
`Range: bytes=666-`	666バイト目からファイル末尾（計334バイト）までを返却	206 Partial Content
`Range: bytes=1-1888` (終端オフセットがファイルサイズを超過)	1バイト目からファイル末尾までを返却	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アップロードオブジェクトの特殊ヘッダー
append方式でアップロードされたオブジェクトの場合、レスポンス時に次の2つのヘッダーが追加されます：

x-wcs-object-type: Appendable
x-next-append-position: <Content-Length int64>

これらのヘッダーは、オブジェクトの種別と次回append可能な位置を示します。

 curl -v -o 1.png http://downloadDomain/1.png