Enable Auto Renewal
Last Updated：2020-09-21
Open the automatic renewal for the specified disk.
- Note that the automatic renewal operation can be conducted only for the data disk.
- Note that the automatic renewal operation can't be made for the disk in the expired status.
- Asynchronous interface, you may query the expiration time of disk by [Query Disk Details](#Query Disk Details) interface.
Request structure
POST /v{version}/volume/autoRenew&clientToken={clientToken} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
{
"volumeId" : volumeId,
"renewTimeUnit" : renewTimeUnit,
"renewTime" : renewTime
} Request header
There are no special headers except the common header.
Request parameter
| Parameter name | Type | Required or not | Parameter position | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number |
| clientToken | String | Yes | Query parameter | The idempotence Token is a ASCII string with a length not exceeding 64 bits. Refer to [link](#ClientToken idempotence support). |
| volumeId | String | Yes | RequestBody parameter | Disk ID |
| renewTimeUnit | String | Yes | RequestBody parameter | Monthly payment or annual payment, the former is "month" and the latter is "year". |
| renewTime | int | Yes | RequestBody parameter | The automatic renewal time is 1-9 by the month and 1-3 by the year. |
Return header
There are no special headers except the common header.
Return parameter
No special return parameters
Request example
PUT /v2/volume/autoRenew&clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"volumeId" : "v-sfhjsfh",
"renewTimeUnit" : "year",
"renewTime" : 3
} Return example
HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS