接口功能介绍

查询备份策略创建的备份任务列表

接口约束

无

URI

GET /v4/ebs-backup/policy/list-tasks

路径参数

无

Query参数

参数	是否必填	参数类型	说明	示例
regionID	是	String	资源池ID	81f7728662dd11ec810800155d307d5b
policyID	是	String	备份策略ID	d15e7d402f8f11ed81370242ac110006
pageNo	否	Integer	页码，默认值1	1
pageSize	否	Integer	每页记录数目 ,默认10	10
asc	否	Boolean	和sort配合使用，是否升序排列，默认降序	true
sort	否	String	和asc配合使用，指定用于排序的字段。可选字段：createdTime/completedTime，默认createdTime	createdTime
taskStatus	否	Integer	备份任务状态，-1-失败，0-执行中，1-成功	1

请求参数

请求头header参数

无

请求体body参数

无

响应参数

参数	是否必填	类型	描述	示例	下级对象
statusCode	是	Integer	返回状态码（800为成功，900为失败）	800
message	是	String	错误信息的英文描述	SUCCESS
description	是	String	错误信息的本地化描述（中文）	成功
returnObj	否	Object	成功时返回对象		returnObj
errorCode	否	String	业务错误细分码，发生错误时返回	参考错误码

表 returnObj

参数名	是否必填	参数类型	说明	示例	下级对象
taskList	是	Array	备份任务列表		taskList
totalCount	是	Integer	备份任务总数	20
currentCount	是	Integer	当前页备份任务数	10

表 taskList

参数名	是否必填	参数类型	说明	示例
taskID	是	String	备份任务ID	798aa810a1d511ed97520242ac110007
taskStatus	是	Integer	备份任务状态，-1-失败，0-执行中，1-成功	1
diskID	是	String	云硬盘ID	4c26cefe-1aac-4b5a-9ac0-2a8eee8169d4
diskName	是	String	云硬盘名称	ebs-2f62
backupName	是	String	云硬盘备份名称	autobk-6an5
createdTime	是	Integer	创建时间	663136607
completedTime	是	Integer	完成时间	663136607

请求示例

请求头header

无

请求体body

无

响应示例

{
    "returnObj": {
        "totalCount": 2,
        "currentCount": 2,
        "taskList": [{
            "diskName": "ebs-2f62",
            "backupName": "autobk-6an5",
            "completedTime": 1675188576,
            "taskStatus": 1,
            "taskID": "798aa810a1d511ed97520242ac110007",
            "createdTime": 1675188575,
            "diskID": "4c26cefe-1aac-4b5a-9ac0-2a8eee8169d4"
        }, {
            "diskName": "ebs-2f62",
            "backupName": "autobk-p56f",
            "completedTime": 1675360807,
            "taskStatus": 1,
            "taskID": "77d42bc6a36611ed8f550242ac110007",
            "createdTime": 1675360800,
            "diskID": "4c26cefe-1aac-4b5a-9ac0-2a8eee8169d4"
        }]
    },
    "message": "SUCCESS",
    "description": "成功",
    "statusCode": 800
}

错误码

errorCode	描述
EbsBackup.RegionInfo.Empty	查询资源池信息为空或资源池不存在，请确认资源池ID是否有效
EbsBackup.RegionInfo.AccessFailed	查询资源池失败，请重试。如果多次尝试失败，请提交工单
EbsBackup.RegionInfo.DataDamaged	查询资源池信息不符预期，请重试。如果多次尝试失败，请提交工单
EbsBackup.Parameter.InvalidPageParams	请求参数错误:{错误原因}
EbsBackup.Parameter.InvalidTaskStatus	请求参数错误:{错误原因}
EbsBackup.Parameter.InvalidPolicyID	请求参数错误:{错误原因}
EbsBackup.Parameter.InvalidRegionID	请求参数错误：{错误原因}

云硬盘备份

查询备份策略创建的备份任务列表