文档首页/ 分布式缓存服务 DCS/ API参考（吉隆坡区域）/ API V2（推荐）/ 备份与恢复/ 获取备份文件下载链接
更新时间：2025-11-14 GMT+08:00
在线调试
CLI示例
查看PDF
分享

获取备份文件下载链接

功能介绍

获取指定实例的备份文件下载链接，下载备份文件。

URI

POST /v2/{project_id}/instances/{instance_id}/backups/{backup_id}/links

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目ID。获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

instance_id

是

String

参数解释：

实例ID。可通过DCS控制台进入实例详情界面查看。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

backup_id

是

String

参数解释：

备份记录ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

expiration

是

Integer

参数解释：

设置URL的有效期。

约束限制：

必须在5分钟到24小时之内，单位为秒。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

file_path

String

参数解释：

OBS桶内文件路径。

取值范围：

不涉及。

bucket_name

String

参数解释：

OBS桶名。

取值范围：

不涉及。

links

Array of LinksItem objects

参数解释：

备份文件下链接集合，链接数最大为64个。
表4 LinksItem

参数

参数类型

描述

file_name

String

参数解释：

备份文件名称。

取值范围：

不涉及。

link

String

参数解释：

备份文件下载链接地址。

取值范围：

不涉及。

状态码：400

表5 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

error_code

String

参数解释：

错误码。

取值范围：

请参见错误码。

error_ext_msg

String

参数解释：

扩展错误信息（暂未使用，赋值为null）。

取值范围：

不涉及。

状态码：500

表6 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

error_code

String

参数解释：

错误码。

取值范围：

请参见错误码。

error_ext_msg

String

参数解释：

扩展错误信息（暂未使用，赋值为null）。

取值范围：

不涉及。

请求示例

获取指定实例的备份文件下载链接，下载备份文件，设置URL有效期为1800秒。

POST https://{dcs_endpoint}/v2/{project_id}/instances/{instance_id}/backups/{backup_id}/links

{
  "expiration" : 1800
}

响应示例

状态码：200

获取备份文件下载链接成功。

{
  "file_path" : "42489641-23c4-4855-bc89-befc85e2b7f7/ddfe5f66-a965-43ff-aec7-f3b489dc071b/",
  "bucket_name" : "bucket5da9cf3bfabc4cae9023695b934e5e2b",
  "links" : [ {
    "file_name" : "redis_192.168.63.250_6379_10923-16383_20190820211816.rdb",
    "link" : "https://bucket5da9cf3bfabc4cae9023695b934e5e2b.{obs_endpoint}:443/42489641-23c4-4855-bc89-befc85e2b7f7/ddfe5f66-a965-43ff-aec7-f3b489dc071b/redis_192.168.63.250_6379_10923-16383_20190820211816.rdb?AWSAccessKeyId=VD8CEQNG8VMQODUAAM0D&Expires=1566308915&Signature=s3I%2BrLbo%2BFZw%2BUsjVere%2FOQdKEg%3D"
  } ]
}

状态码

状态码

描述

200

获取备份文件下载链接成功。

400

非法请求。

500

内部服务错误。

错误码

请参见错误码。

父主题： 备份与恢复