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