# 查询转储任务列表 - ListBackupTransfers #### 功能介绍 查询转储任务列表。 - 调用接口前，您需要了解API[认证鉴权](https://support.huaweicloud.com/api-rds/rds_03_0001.html)。 - 调用接口前，您需要了解[请求Header参数说明](https://support.huaweicloud.com/api-rds/rds_03_0005.html#rds_03_0005__section479119143310)。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/RDS/doc?api=ListBackupTransfers)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-rds/rds_10_0005.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | rds:backup:list | - | - | - | - | - | #### URI - URI格式 GET /v3/{project_id}/transfer-info - 参数说明 表1参数说明 | 名称 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 租户在某一region下的project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-rds/rds_03_0002.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | offset | 是 | Integer | **参数解释**： 分页页码。 **约束限制**： 不涉及。 **取值范围**： 最小值为1，表示查询第1页。 **默认取值**： 1 | | limit | 是 | Integer | **参数解释**： 每页展示条数。 **约束限制**： 不涉及。 **取值范围**： 最小值为0。 **默认取值**： 10 | 表2参数说明 | 名称 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | order_field | 否 | String | **参数解释**： 排序字段。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | order_rule | 否 | String | **参数解释**： 排序规则。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | filter_field | 否 | String | **参数解释**： 筛选字段。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | filter_content | 否 | String | **参数解释**： 筛选关键字。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | begin_time | 否 | Long | **参数解释**： 开始时间戳。单位：毫秒。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | end_time | 否 | Long | **参数解释**： 结束时间戳。单位：毫秒。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | transfer_type | 否 | String | **参数解释**： 转储任务类型。 **约束限制**： 不涉及。 **取值范围**： - manual：手动转储任务。 - auto：自动转储任务。 **默认取值**： manual | #### 请求消息 无。 #### 请求示例 查询转储任务列表。 ``` GET https://{Endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/transfer-info ``` #### 响应消息 - 正常响应要素说明 表3要素说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Long | **参数解释**： 任务数量。 **取值范围**： 不涉及。 | | transfer_list | Array of objects | **参数解释**： 任务列表。详情请参见[表4]。 | 表4transfer_list字段说明 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | id | String | **参数解释**： 备份ID。 **取值范围**： 不涉及。 | | name | String | **参数解释**： 备份名称。 **取值范围**： 不涉及。 | | begin_time | Long | **参数解释**： 开始时间。单位：毫秒。 **取值范围**： 不涉及。 | | end_time | Long | **参数解释**： 结束时间。单位：毫秒。 **取值范围**： 不涉及。 | | status | String | **参数解释**： 任务状态。 **取值范围**： - Pending：挂起。 - Running：运行中。 - Completed：已完成。 - Failed：已失败。 | | size | Double | **参数解释**： 对象大小，单位为KByte。 **取值范围**： 不涉及。 | | instance_id | String | **参数解释**： 实例ID。 **取值范围**： 不涉及。 | | file_name | String | **参数解释**： 目标对象名称。 **取值范围**： 不涉及。 | | destination | String | **参数解释**： 目标桶名。 **取值范围**： 不涉及。 | | backup_begin_time | Long | **参数解释**： 转储备份起始时间。 **取值范围**： 不涉及。 | | backup_end_time | Long | **参数解释**： 转储备份结束时间。 **取值范围**： 不涉及。 | | transfer_type | String | **参数解释**： 转储任务类型。 **取值范围**： - manual：手动转储任务。 - auto：自动转储任务。 | | type | String | **参数解释**： 转储备份类型。 **取值范围**： - db：自动备份。 - log：增量备份。 - snapshot：手动备份。 | | prefix | String | **参数解释**： 转储目标前缀。 **取值范围**： 0\~96个字符，以分隔符"/"结尾。 | - 正常响应样例 ``` { "total":3, "transfer_list":[ { "id":"38e7f95bc332408e9b4d6409fc28f9a0br01", "name":"mysql-local-adf1-20250305072705950", "begin_time":1741171386518, "end_time":1741171389039, "status":"Completed", "size":3607.899415, "instance_id":"9addef3bcf264a8a82e710d62b3f1439in01", "file_name":"test/0cf6f193231e41feac6deabbf6620274_9addef3bcf264a8a82e710d62b3f1439in01_Db_38e7f95bc332408e9b4d6409fc28f9a0br01_20250305072659001_20250305072705879_2c6b7a6bd85b4a4596673e37acc732deno01_xbcloud_.qp/0cf6f193231e41feac6deabbf6620274_9addef3bcf264a8a82e710d62b3f1439in01_Db_38e7f95bc332408e9b4d6409fc28f9a0br01_20250305072659001_20250305072705879_2c6b7a6bd85b4a4596673e37acc732deno01_xbcloud_.qp", "destination":"obs-4144" }, { "id":"38e7f95bc332408e9b4d6409fc28f9a0br01", "name":"mysql-local-adf1-20250305072705950", "begin_time":1741171082762, "end_time":1741171087592, "status":"Completed", "size":3607.899415, "instance_id":"9addef3bcf264a8a82e710d62b3f1439in01", "file_name":"0cf6f193231e41feac6deabbf6620274_9addef3bcf264a8a82e710d62b3f1439in01_Db_38e7f95bc332408e9b4d6409fc28f9a0br01_20250305072659001_20250305072705879_2c6b7a6bd85b4a4596673e37acc732deno01_xbcloud_.qp/0cf6f193231e41feac6deabbf6620274_9addef3bcf264a8a82e710d62b3f1439in01_Db_38e7f95bc332408e9b4d6409fc28f9a0br01_20250305072659001_20250305072705879_2c6b7a6bd85b4a4596673e37acc732deno01_xbcloud_.qp", "destination":"obs-rdstest1" }, { "id":"38e7f95bc332408e9b4d6409fc28f9a0br01", "name":"mysql-local-adf1-20250305072705950", "begin_time":1741166966484, "end_time":1741166970807, "status":"Completed", "size":3607.899415, "instance_id":"9addef3bcf264a8a82e710d62b3f1439in01", "file_name":"0cf6f193231e41feac6deabbf6620274_9addef3bcf264a8a82e710d62b3f1439in01_Db_38e7f95bc332408e9b4d6409fc28f9a0br01_20250305072659001_20250305072705879_2c6b7a6bd85b4a4596673e37acc732deno01_xbcloud_.qp/0cf6f193231e41feac6deabbf6620274_9addef3bcf264a8a82e710d62b3f1439in01_Db_38e7f95bc332408e9b4d6409fc28f9a0br01_20250305072659001_20250305072705879_2c6b7a6bd85b4a4596673e37acc732deno01_xbcloud_.qp", "destination":"obs-rdstest1" } ] } ``` - 异常响应 请参见[异常响应结果](https://support.huaweicloud.com/api-rds/rds_01_0010.html)。 #### 状态码 - 正常 200 - 异常 请参见[状态码](https://support.huaweicloud.com/api-rds/rds_10_0200.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-rds/rds_10_0201.html)。