# 下载文件 - GetFile 

## 简介

下载文件

## 定义

### 句法（Syntax）:

```
GET /<object_name> HTTP/1.1
Host: <bucket_name>.cn-bj.ufileos.com
Authorization: <token> 
Range: bytes=byte_range
If-Modified-Since: <timestamp>
```
### 请求参数（Request Parameters）

**请求头（Request Headers）**

|Name             |Type  |Description                       |Required|
|---|---|---|---|
|Authorization    |String|下载请求的授权签名，[API 签名算法](/docs/ufile/api/authorization?id=%e6%96%87%e4%bb%b6%e7%ae%a1%e7%90%86%e7%ad%be%e5%90%8d%e7%ae%97%e6%b3%95)  |No      |
|Range            |String|分片下载的文件范围                         |No      |
|If-Modified-Since|String|只返回从某时修改过的文件，否则返回304(not modified)|No      |

**请求元素（Request Elements）**

|Name             |Type  |Description                       |Required|
|---|---|---|---|
|ufileattname    |String|指定US3返回请求的Content-Disposition头                   |No      |

### 响应（Responses）

**响应头（Response Headers）**

|Name          |Type   |Description     |
|---|---|---|
|Content-Type  |String |请求下载文件的类型       |
|Content-Length|Integer|请求下载文件的长度       |
|Content-Range |String |请求下载文件的范围       |
|ETag          |String |请求下载文件在US3的哈希值|
|X-SessionId   |String |请求失败时返回本次请求的会话Id|
|X-Ufile-Meta- *   |String |US3中规定所有以X-Ufile-Meta-为前缀的参数视为用户自定义元数据（User Meta），比如x-ufile-meta-location。一个文件可以有多个类似的参数，但所有的User Meta总大小不能超过8KB。这些User Meta信息会在GetFile或者HeadFile的时候在HTTP头部中返回。|

**响应元素（Response Elements）**

|Name   |Type   |Description|
|---|---|---|
|RetCode|Integer|执行失败时的错误代码 |
|ErrMsg |String |执行失败时的错误提示 |

> 注意: 成功下载时返回HTTP 200或206和数据体。

## 示例

> 注意：示例中的Host为源站域名，如果您使用CDN下载，请将Host替换为CDN域名

### 请求示例（Example Request）:


```
GET /demofile HTTP/1.1
Host: <bucket_name>.cn-bj.ufileos.com
Authorization:  demouser@ucloud.cn13424346821929713944:S5FVD2w613MKb/hisjaqHdjvn9U=
```
### 响应示例（Example Response）:

```
HTTP/1.1 200 OK
ETag: "c5371fe3624d438cd8a59420a3221978"
Content-Type: image/jpg
Content-Length: 1234

<data>
```
### 部分响应示例 (Example Response Only Get Partial Content):

```
HTTP/1.1 206 Partial Content
Content-Type: image/jpg
Content-Length: 34
Content-Range: bytes 0-10/34

<data>
```