更新时间：2023-12-13 GMT+08:00
获取备份文件下载链接
功能介绍
获取指定实例的备份文件下载链接，下载备份文件。
URI
POST /v2/{project_id}/instances/{instance_id}/backups/{backup_id}/links
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
项目ID。获取方法请参见获取项目ID。 |
instance_id |
是 |
String |
实例ID。 |
backup_id |
是 |
String |
备份记录ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
expiration |
是 |
Integer |
设置URL的有效期，必须在5分钟和24小时之内，单位为秒。 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
file_path |
String |
OBS桶内文件路径。 |
bucket_name |
String |
OBS桶名。 |
links |
Array of LinksItem objects |
备份文件下链接集合，链接数最大为64个。 |
状态码： 400
参数 |
参数类型 |
描述 |
|---|---|---|
error_msg |
String |
错误信息。 最大长度：1024 |
error_code |
String |
错误码。 最大长度：9 |
error_ext_msg |
String |
扩展错误信息（暂未使用，赋值为null）。 最大长度：1024 |
状态码： 500
参数 |
参数类型 |
描述 |
|---|---|---|
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 |
内部服务错误。 |
错误码
请参见错误码。
父主题： 备份与恢复
