API Introduction

Create a VBS backup.

API Restrictions

Ensure that the remaining capacity of the VBS repository is enough to create the VBS backup.

URI

<span lang="EN-US">POST /v4/ebs-backup/create-backup</span>

Request Parameters

Request Header Parameter

None

Request Body Parameter

Parameter	Required or Not	Parameter Type	Description	Example
diskID	Yes	String	EVS ID	0c582801-6b20-4e3a-956a-f3afbb5e9725
regionID	Yes	String	Resource Pool ID	81f7728662dd11ec810800155d307d5b
description	No	String	VBS backup description.	test-bak's description
repositoryID	Yes	String	Repository ID.	9915c3f4-8d78-445a-a1da-d8d9287d506b
backupName	Yes	String	Backup name. Only digits, letters, hyphens (-), and underscores (_) are allowed. The name cannot start with a digit or a hyphen (-) or end with a hyphen (-). It must be within 2 to 32 characters in length.	test-bak

Response Parameter

Parameter	Required or Not	Type	Description	Example	Lower-level Object
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	Object returned upon a success.		returnObj
errorCode	No	String	Business code, returned upon failures.	Refer to error codes

Table returnObj

Parameter Name	Required or Not	Parameter Type	Description	Example
regionID	Yes	String	Resource Pool ID	81f7728662dd11ec810800155d307d5b
backupID	Yes	String	VBS backup ID.	59093d15-8a3c-53b9-b61b-484af10a3e97
backupName	Yes	String	VBS Backup name.	test-bak
backupStatus	Yes	String	Backup status. Valid values: available, error, and creating.	creating
diskSize	Yes	Integer	EVS disk capacity (GB).	100
backupSize	Yes	Integer	VBS backup size (byte).	1024000
description	Yes	String	VBS backup description.	test-bak's description
repositoryID	Yes	String	Repository ID.	9915c3f4-8d78-445a-a1da-d8d9287d506b
repositoryName	Yes	String	Repository name.	test-repo
createdTime	Yes	Integer	Created At	1663136607
updatedTime	Yes	Integer	Update At	1663136607
finishedTime	Yes	Integer	Backup completion time.	1663136607
restoredTime	Yes	Integer	Restoration starting time.	1663136607
restoreFinishedTime	Yes	Integer	Restoration completion time.	1663136607
freeze	Yes	Boolean	Indicate whether the repository is frozen.	false
diskID	Yes	String	EVS ID	0c582801-6b20-4e3a-956a-f3afbb5e9725
diskName	Yes	String	EVS Name	test-vol
encrypted	Yes	Boolean	Indicate whether the EVS disk is encrypted.	false
diskType	Yes	String	EVS disk type. Value range: SATA: ordinary I/O. SAS: high I/O. SSD: ultra-high I/O. SSD-genric: general-purpose SSD. FAST-SSD: express SSD.	SATA
pass	Yes	Boolean	Indicate whether PASS is supported.	false
instanceID	Yes	String	ID of the mounted cloud server.	f2338f53-81b1-4fef-72cc-9f72b5fe705c
instanceName	Yes	String	Name of the mounted cloud server.	test-vm
projectID	Yes	String	Enterprise project ID.	0

Sample Request

Request Header

None

Request Body

    "regionID": "81f7728662dd11ec810800155d307d5b",

    "diskID": "0c582801-6b20-4e3a-956a-f3afbb5e9725",

    "description": "test-bak's description",

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

    "backupName": "test-bak"

Response Example

    "returnObj": {

        "diskName": "test-vol-002",

        "diskSize": 0,

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

        "paas": false,

        "backupSize": 0,

        "regionID": "73f321ea-62ff-11ec-a8bc-005056898fe0",

        "encrypted": false,

        "repositoryName": "test-repository001",

        "restoredTime": null,

        "backupStatus": "creating",

        "description": "test-bak's description",

        "instanceID": "",

        "createdTime": 1668033616,

        "freeze": false,

        "backupName": "test-bak",

        "restoreFinishedTime": null,

        "diskType": "SATA",

        "diskID": "0c582801-6b20-4e3a-956a-f3afbb5e9725",

        "updatedTime": 1668062416,

        "finishedTime": null,

        "backupID": "f7454119-867e-4317-b253-3ad47e35fcda",

        "instanceName": "",

        "projectID": "0"

},

    "message": "SUCCESS",

    "description": "Successful",

    "statusCode": 800

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.Parameter.InvalidBackupName	Invalid request parameter: {Reason}.
EbsBackup.RepositoryInfo.DataDamaged	The VBS repository data is damaged.
EbsBackup.RepositoryInfo.NotFound	The VBS repository is not found.
EbsBackup.Parameter.InvalidRepositoryID	Invalid request parameter: {Reason}.
EbsBackup.RepositoryInfo.AccessFailed	Failed to query the VBS repository.
EbsBackup.RepositoryInfo.Expired	The VBS repository has expired.
EbsBackup.DiskInfo.NotFound	The EVS disk is not found.
EbsBackup.Parameter.InvalidDiskID	Invalid request parameter: {Reason}.
EbsBackup.Parameter.InvalidRegionID	Invalid request parameter: {Reason}.
EbsBackup.DiskInfo.InvalidState	The current EVS disk state.VBS does support this operation.
Openapi.PatternCheck.NotValid	Invalid request parameter: {Reason}.

Volume Backup Service

Create a Backup