# 获取备份文件下载链接
#### 功能介绍
获取指定实例的备份文件下载链接，用于下载备份文件。
![](https://support.huaweicloud.com/api-dcs/public_sys-resources/note_3.0-zh-cn.png)
该接口当前仅在华北-北京四区域开放。
#### URI
POST /v1.0/{project_id}/instances/{instance_id}/backups/{backup_id}/links
| 参数         | 是否必选 | 参数类型   | 描述                                                                                           |
|:---|:---|:---|:---|
| project_id  | 是      | String   | 项目ID。                                                                                          |
| instance_id | 是      | String | 实例ID。                                                                                         |
| backup_id   | 是      | String | 备份记录ID。具体请参考[查询实例备份信息](https://support.huaweicloud.com/api-dcs/dcs-api-0312022.html)接口，获取备份ID。 |
   
#### 请求消息
**请求参数**
| 参数         | 是否必选 | 参数类型       | 描述                            |
|:---|:---|:---|:---|
| expiration | 是   | String | 设置URL的有效期，必须在5分钟和24小时之内，单位为秒。 |
   
**请求示例**
```
{
"expiration":300
}
```
#### 响应消息
状态码为 200 时，响应参数和响应示例如下：
**响应参数**
| 参数        | 参数类型     | 描述                    |
|:---|:---|:---|
| bucket_name | String | OBS桶名。              |
| file_path | String  | OBS桶内文件路径。          |
| links      | Array  | 备份文件下载链接集合，链接数最大为64个。 |
   
| 参数        | 参数类型    | 描述           |
|:---|:---|:---|
| file_name | String | 备份文件名称。     |
| link     | String | 备份文件下载链接地址。 |
   
**响应示例**
```
{
    "bucket_name": "bucket6d1b61f3d7434f60b7e465f4037d73f3",
    "file_path": "3dc6ba15-ba97-4624-bcbd-3cc08d6336b0/20190924204307_redis.rdb",
    "links": [
        {
            "file_name": "20190924204307_redis.rdb",
            "link": "https://bucket6d1b61f3d7434f60b7e465f4037d73f3.obs.cn-north-4.myhuaweicloud.com:443/3dc6ba15-ba97-4624-bcbd-3cc08d6336b0/20190924204307_redis.rdb?AWSAccessKeyId=IMRORRY3GETV9CEH3GE0&Expires=1569329601&Signature=NGhdEGwHImXNyYyryx3AYqfAvoA%3D"
        }
    ]
}
```
#### 返回值
| 返回值 | 描述             |
|:---|:---|
| 200  | 获取备份文件下载链接成功。 |