文档首页/ 云数据库 GaussDB/ API参考/ API（推荐）/ 备份恢复管理/ 获取备份下载链接
更新时间：2025-09-12 GMT+08:00
查看PDF
分享

获取备份下载链接

功能介绍

获取备份下载链接。

调试

您可以在API Explorer中调试该接口。

接口约束

该接口支持获取GaussDB的手动全量备份及自动全量备份的下载链接。

URI

GET /v3/{project_id}/backup-files

表1 参数说明

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

租户在某一Region下的项目ID。

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

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

backup_id

是

String

备份ID，严格匹配UUID规则。

请求参数

无。

响应参数

表2 响应Body参数列表

名称

类型

是否必选

描述

files

Array of 表3

是

备份文件信息。

bucket

String

是

文件所在桶名。
表3 files

名称

类型

是否必选

描述

name

String

是

文件名。

size

Long

是

文件大小，单位：KB。

download_link

String

是

文件下载链接。

link_expired_time

String

是

下载链接过期时间，格式为“yyyy-mm-ddThh:mm:ssZ”。其中，T指某个时间的开始，Z指时区偏移量。
表4 响应Body参数列表

名称

类型

是否必选

描述

error_code

String

是

错误码。

error_msg

String

是

错误消息。

请求示例

获取备份下载链接。

https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/backup-files/e28d08754b1a490fb2b3540ed013a7fbbr14?backup_id=2f4ddb93b9014b0893d81d2e472f30febr14

响应示例

状态码为 200 时:

{
   "files": [
    {
        "name": "43e4feaab48f11e89039fa163ebaa7e4br01.xxx",
        "size": 2803,
        "download_link":"https://obs.domainname.com/rdsbucket.username.1/xxxxxx",
        "link_expired_time":"2018-08-016T10:15:14+0000"
     }
     ],
    "bucket": "rdsbucket.bucketname"
}

状态码为 default 时：

{ 
    "error_code":"DBS.200022", 
    "error_msg":"获取备份下载链接失败。" 
}

状态码

错误码

请参见错误码。

父主题： 备份恢复管理

相关文档