API Introduction

Unbind a backup policy from an EVS disk.

This applies to the old version of API operations and may not be applicable in the future. We recommend you use the new version, which is more standard and covers more scenarios.

API Restrictions

If some of the EVS disks involved have no backup policies bound or are bound with other policies, the API will unbind disks bound with this policy and the error code <span>EbsBackup.PolicyInfo.PartVolumesUnbind</span> will be returned. This error code does not indicate that an error has occurred with the API. It is a reminder for the caller that some disks have not been unbound based on their intention to facilitate subsequent operations.

URI

POST /v4/ebs-backup/policy/unbind-volumes

Path Parameter

None

Query Parameter

None

Request Parameters

Request Header Parameter

None

Request Body Parameter

Parameter	Required or Not	Parameter Type	Description	Example
regionID	Yes	String	Resource Pool ID	81f7728662dd11ec810800155d307d5b
policyID	Yes	String	Backup policy ID.	d15e7d402f8f11ed81370242ac110006
volumeIDs	Yes	String	Disk ID. Separate multiple IDs with commas (,).	9915c3f4-8d78-445a-a1da-d8d9287d506b,9915c3f4-8d78-445a-a1da-d8d9287d506a

Response Parameter

Parameter	Required or Not	Type	Description	Example
statusCode	Yes	Integer	Return status code (800 indicates success, 900 indicates failure).	800
message	Yes	String	Error descripting in English.	SUCCESS
description	Yes	String	Error description in Chinese.	Successful
returnObj	No	Object	Data returned upon success. Value: {}.
errorCode	No	String	Business code, returned upon failures.	Refer to error codes

Sample Request

Request Body

    "regionID": "81f7728662dd11ec810800155d307d5b",

    "policyID": "d15e7d402f8f11ed81370242ac110006",

    "volumeIDs": "9915c3f4-8d78-445a-a1da-d8d9287d506b,9915c3f4-8d78-445a-a1da-d8d9287d506a"

Response Example

    "statusCode": 800,

    "message": "SUCCESS",

    "description": "Successful",

    "returnObj": {}

Error Codes

errorCode	Description
EbsBackup.RegionInfo.Empty	The resource pool information is empty or does not exist. Check whether the resource pool ID is valid.
EbsBackup.RegionInfo.AccessFailed	Failed to query the resource pool. Please try again. If the failure keeps happening, please submit a ticket.
EbsBackup.RegionInfo.DataDamaged	The resource pool information is incorrect. Please try again. If the failure keeps happening, please submit a ticket.
EbsBackup.DiskInfo.Empty	The disk info is empty.
EbsBackup.DisksInfo.NotFound	The EVS disk is not found.
EbsBackup.DisksInfo.PartNotFound	EVS disks {volume_id1,volume_id2,..} are not found.
EbsBackup.Parameter.InvalidUuidParams	Invalid request parameter: {Reason}.
EbsBackup.Parameter.InvalidPolicyID	Invalid request parameter: {Reason}.
EbsBackup.Parameter.InvalidRegionID	Invalid request parameter: {Reason}.
EbsBackup.PolicyInfo.NotFound	The backup policy is not found.
EbsBackup.PolicyInfo.PartVolumesUnbind	The EVS disk {} is not bound with the specified backup policy.

Volume Backup Service

Unbind a Backup Policy from an EVS Disk