获取备份下载链接(2.4.3) -ShowBackupDownloadLink
功能介绍
通过该API，您可以获取备份文件下载链接，在有效期（3600秒）之内，您可以通过URL直接下载备份文件。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
GET /v2/{project_id}/graphs/{graph_id}/backup-files
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释： 项目编号。获取方法，请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母和数字组成，且长度为[1-64]个字符。 默认取值： 不涉及。 |
|
graph_id |
是 |
String |
图ID。 |
|
backup_id |
是 |
String |
备份ID。获取方法参考查看某个图的备份列表。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
bucket |
String |
文件所在的桶名。 参数解释： 执行异步任务的JobID。 取值范围： 不涉及 |
|
files |
Array of objects |
备份包含的文件列表。详情请参见files字段数据结构说明。 参数解释： 执行异步任务的JobID。 取值范围： 不涉及 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
name |
String |
参数解释： 文件名。 取值范围： 不涉及 |
|
size |
Long |
参数解释： 文件大小，单位：KB。 取值范围： 不涉及 |
|
download_link |
String |
参数解释： 文件下载链接。 取值范围： 不涉及
说明：
备份文件类型不同，浏览器打开该链接的方式不同。 例如：文本文件可直接通过浏览器打开浏览，而二进制文件会在浏览器打开时，自动下载到本地。如果需要完整的下载所有备份文件，建议通过某种编程语言的的HTTP库下载，比如Java的HttpClient、Python的requests等。 |
|
link_expired_time |
String |
参数解释： 下载链接过期时间，格式为“yyyy-mm-ddThh:mm:ss”。 取值范围： 不涉及 |
状态码： 400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
系统提示信息。
|
|
error_msg |
String |
系统提示信息。
|
请求示例
获取备份下载链接。
GET https:/{Endpoint}/v2/{project_id}/graphs/{graph_id}/backup-files?backup_id=22aa0177-b20b-4f3a-8556-8147d6658ed8
响应示例
状态码： 200
成功响应示例
{
"bucket": "string",
"files": [
{
"name": "43e4feaab48f11e89039fa163ebaa7e4br01.xxx",
"size": 2803,
"download_link": "https://obs.domainname.com/rdsbucket.username.1/xxxxxx",
"link_expired_time": "2018-08-016T10:15:14+0800"
}
]
}
状态码： 400
失败响应示例
{
"error_msg": "The graph backup does not exist or has been deleted.",
"error_code": "GES.7024"
}
状态码
|
返回值 |
说明 |
|---|---|
|
400 Bad Request |
请求错误 |
|
401 Unauthorized |
鉴权失败 |
|
403 Forbidden |
没有操作权限 |
|
404 Not Found |
找不到资源 |
|
500 Internal Server Error |
服务内部错误 |
|
503 Service Unavailable |
服务不可用 |
错误码
请参见错误码。
