接口功能介绍
备份策略解绑云硬盘。
当前页面接口为旧版 API，未来根据实际使用情况可能退役，推荐使用新版本接口，新版本接口更加规范，覆盖场景更全。
接口约束
如果云硬盘中，包含了未绑定备份策略或绑定了其他备份策略的盘，则该接口会解绑属于该备份策略下的云硬盘，并给出 EbsBackup.PolicyInfo.PartVolumesUnbind错误码，该错误码并不表示接口出错，仅用于提示调用者，部分云硬盘未按照调用者的意图进行解绑，便于调用者后续操作。
URI
POST /v4/ebs-backup/policy/unbind-volumes
路径参数
无
Query参数
无
请求参数
请求头header参数
无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 资源池ID | 81f7728662dd11ec810800155d307d5b | |
| policyID | 是 | String | 备份策略ID | d15e7d402f8f11ed81370242ac110006 | |
| volumeIDs | 是 | String | 云硬盘ID,如果绑定多个,请使用逗号隔开 | 9915c3f4-8d78-445a-a1da-d8d9287d506b,9915c3f4-8d78-445a-a1da-d8d9287d506a |
响应参数
| 参数 | 是否必填 | 类型 | 描述 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| statusCode | 是 | Integer | 返回状态码（800为成功，900为失败） | 800 | |
| message | 是 | String | 错误信息的英文描述 | SUCCESS | |
| description | 是 | String | 错误信息的本地化描述（中文） | 成功 | |
| returnObj | 否 | Object | 成功时返回，值为{} | ||
| errorCode | 否 | String | 业务错误细分码，发生错误时返回 | 参考错误码 |
请求示例
请求体body
{
"regionID": "81f7728662dd11ec810800155d307d5b",
"policyID": "d15e7d402f8f11ed81370242ac110006",
"volumeIDs": "9915c3f4-8d78-445a-a1da-d8d9287d506b,9915c3f4-8d78-445a-a1da-d8d9287d506a"
}
响应示例
{
"statusCode": 800,
"message": "SUCCESS",
"description": "成功",
"returnObj": {}
}
错误码
| errorCode | 描述 |
|---|---|
| EbsBackup.RegionInfo.Empty | 查询资源池信息为空或资源池不存在，请确认资源池ID是否有效 |
| EbsBackup.RegionInfo.AccessFailed | 查询资源池失败，请重试。如果多次尝试失败，请提交工单 |
| EbsBackup.RegionInfo.DataDamaged | 查询资源池信息不符预期，请重试。如果多次尝试失败，请提交工单 |
| EbsBackup.DiskInfo.Empty | 云硬盘信息为空 |
| EbsBackup.DisksInfo.NotFound | 云硬盘未找到 |
| EbsBackup.DisksInfo.PartNotFound | 云硬盘{volume_id1,volume_id2,..}未找到 |
| EbsBackup.Parameter.InvalidUuidParams | 请求参数错误：{错误原因} |
| EbsBackup.Parameter.InvalidPolicyID | 请求参数错误：{错误原因} |
| EbsBackup.Parameter.InvalidRegionID | 请求参数错误：{错误原因} |
| EbsBackup.PolicyInfo.NotFound | 备份策略未找到 |
| EbsBackup.PolicyInfo.PartVolumesUnbind | 云硬盘{}不属于该备份策略 |
