Mount the CDS Disk
Last Updated:2020-07-20
- This API is used to mount the specified disk on the specified virtual machine instance.
Notes:
The CDS disk needs to be mounted on the specified virtual machine instance of the same zone. Otherwise, it prompts an error 403.
- The mount is allowed only when the disk is in the Available status and the instance is in the Running or Stopped status. Otherwise, it returns an error 409 when you call this interface.
Request Structure
PUT /v{version}/volume/{volumeId}?{action} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
{
"instanceId":instanceId
}
Request Header Field
There are no other special header fields except the public header field.
Request Parameters
Parameter Name | Type | Required | Parameter Position | Description |
---|---|---|---|---|
version | String | Yes | URL parameter | API version number |
volumeId | String | Yes | URL parameter | Disk ID |
action | String | Yes | Query Parameter | Action on disk, whose current value is attach. |
instanceId | String | Yes | Request Body Parameter | Virtual machine instance ID to be mounted |
Return Header Field
There are no other special header fields except the common header field.
Return Parameter
Parameter Name | Type | Description |
---|---|---|
volumeAttachment | VolumeAttachmentModel | information for disk mounted virtual machine |
Error Code
Error Code | Error Description | HTTP Status Code | Explanations |
---|---|---|---|
Volume.InstanceStatusCannotAttach | Instance only when it is running or stopped state can mount to it. | 409 | Mount the disk, which is not allowed in the virtual machine status. |
Volume.DistNotAvailable | Volume status is not available, can not be attached to instance. | 409 | The disk status is not available. |
Volume.DiskAttachedQuotaExceededLimit | The attached disk number to an instance exceeds limit. | 413 | The number of mounted CDS disks exceeds the limit. |
Request Instance
PUT /v2/volume/v-3zmCcxbR?attach HTTP/1.1
Host: bcc.bj.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"instanceId":"i-j7lMWiyX"
}
Return Instance
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
{
"volumeAttachment": {
"volumeId": "v-3zmCcxbR",
"instanceId": "i-j7lMWiyX",
"device": "/dev/vdb"
"serial":"062b3f5d-b8a5-4c29-9"
}
}