Bind automatic snapshot policy
Updated at：2025-10-20
This API allows you to bind an automatic snapshot policy to a specified CDS disk.
Request structure
Plain Text
1PUT /v{version}/asp/{aspId}?{action} HTTP/1.1
2 Host: bcc.bj.baidubce.com
3 Authorization: authorization string
4 {
5 "volumeIds":[volumeId],
6 "deleteAutoSnapshot":deleteAutoSnapshot
7 }Request headers
There are no special headers required beyond the common headers.
Request parameters
| Parameter name | Types | Whether required | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number |
| aspId | String | Yes | URL parameter | Automatic snapshot policy ID |
| action | String | Yes | Query | Action executed on the automatic snapshot policy, current value: attach |
| volumeIds | List |
Yes | RequestBody | Disk ID to be bound |
| volumeIds | List |
Yes | RequestBody | Disk ID to be bound |
| deleteAutoSnapshot | boolean | No | RequestBody | Automatic snapshots are deleted along with the disk. The initial value is false, and after explicit assignment, the corresponding attributes of all related disks will be replaced with the new value |
Response headers
No special headers are required beyond the standard ones.
Response parameters
There are no special response parameters
Error codes
| Error code | Error description | HTTP status code | Chinese explanation |
|---|---|---|---|
| Asp.VolumeTypeInvalid | Volume type should be Cds or System | 400 | Invalid volume type |
| Asp.VolumeStatusInvalid | Volume must be in-use | 400 | Volume status must be "in-use" |
| BadRequest | missing parameter. | 400 | Missing parameter |
| ServiceInternalError | Internal service occurs error. | 500 | Internal error |
| NoSuchObject | The specified object is not found or resource do not exist. | 404 | The specified resource does not exist |
Request example
Plain Text
1PUT /v2/asp/asp-oG6prjrl?attach HTTP/1.1
2 Host: bcc.bj.baidubce.com
3 Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5 {
6 "volumeIds":["v-111","v-222"]
7 }Response example
Plain Text
1HTTP/1.1 200 OK
2 x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3 Date: Wed, 03 Dec 2014 06:42:19 GMT
4 Content-Type: application/json;charset=UTF-8
5 Server: BWS