文档首页/分布式缓存服务 DCS/API参考（巴黎区域）/API V2（推荐）/备份与恢复/获取备份文件下载链接
更新时间：2023-12-13 GMT+08:00
查看PDF
分享

获取备份文件下载链接

功能介绍

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

instance_id

是

String

实例ID。

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

错误信息。

最大长度：1024

error_code

String

错误码。

最大长度：9

error_ext_msg

String

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

最大长度：1024

状态码： 500

表6 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息。

最大长度：1024

error_code

String

错误码。

最大长度：9

error_ext_msg

String

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

最大长度：1024

请求示例

获取指定实例的备份文件下载链接，下载备份文件，设置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

内部服务错误。

错误码

请参见错误码。

父主题：备份与恢复