获取备份文件下载链接
功能介绍
获取指定实例的备份文件下载链接,下载备份文件。
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 |
内部服务错误。 |
错误码
请参见错误码。