Domain name for API request: cbs.tencentcloudapi.com.
This API is used to roll back a backup point to the original cloud disk.
CreateSnapshot
API to convert the backup point into a snapshot, use the CreateDisks
API to create an elastic cloud disk, and then copy the snapshot data to it.NORMAL
status can be rolled back. To query the status of a backup point, call the DescribeDiskBackups
API and see the BackupState
field in the response.DescribeDisks
API and see the Attached
field in the response. For a non-elastic cloud disk purchased together with an instance, the instance must be in shutdown status, which can be queried through the DescribeInstancesStatus
API.A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
Parameter Name | Required | Type | Description |
---|---|---|---|
Action | Yes | String | Common Params. The value used for this API: ApplyDiskBackup. |
Version | Yes | String | Common Params. The value used for this API: 2017-03-12. |
Region | No | String | Common Params. This parameter is not required for this API. |
DiskBackupId | Yes | String | ID of the cloud disk backup point, which can be queried through the DescribeDiskBackups API. |
DiskId | Yes | String | ID of the original cloud disk of the backup point, which can be queried through the DescribeDisks API. |
Parameter Name | Type | Description |
---|---|---|
RequestId | String | The unique request ID, which is returned for each request. RequestId is required for locating a problem. |
This example shows you how to roll back a backup point to the original cloud disk.
POST / HTTP/1.1
Host: cbs.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ApplyDiskBackup
<Common request parameters>
{
"DiskId": "disk-xxxxxxxx",
"DiskBackupId": "dbp-xxxxxxxx"
}
{
"Response": {
"RequestId": "5d41fd68-372a-4c90-81c6-a6f982328058"
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
Error Code | Description |
---|---|
InvalidDisk.Busy | The cloud disk is busy. Try again later. |
InvalidDisk.NotSupported | Indicates that the operation is not supported for the cloud disk. |
InvalidDiskId.NotFound | The ‘DiskId’ entered does not exist. |
InvalidInstance.NotSupported | Cloud Virtual Machine does not support mounting cloud disk. |
ResourceBusy | The resource is busy. Try again later. |
ResourceInUse.DiskRollbacking | The cloud disk is being rolled back. Please try again later. |
ResourceNotFound | The resource does not exist. |
ResourceNotFound.NotFound | The resource is not found. |
ResourceUnavailable | The resource is unavailable. |
ResourceUnavailable.NotSupported | The resource does not support this operation. |
Was this page helpful?