CloudStack v2.2.13 - 2.2.14 Domain Admin API Reference
attachVolume
Attaches a disk volume to a virtual machine.
Request parameters
Parameter Name | Description | Required |
id | the ID of the disk volume | true |
virtualmachineid | the ID of the virtual machine | true |
deviceid | the ID of the device to map the volume to within the guest OS. If no deviceId is passed in, the next available deviceId will be chosen. Possible values for a Linux OS are:* 1 - /dev/xvdb* 2 - /dev/xvdc* 4 - /dev/xvde* 5 - /dev/xvdf* 6 - /dev/xvdg* 7 - /dev/xvdh* 8 - /dev/xvdi* 9 - /dev/xvdj | false |
Response Tags
Response Name | Description |
id | ID of the disk volume |
account | the account associated with the disk volume |
attached | the date the volume was attached to a VM instance |
created | the date the disk volume was created |
destroyed | the boolean state of whether the volume is destroyed or not |
deviceid | the ID of the device on user vm the volume is attahed to. This tag is not returned when the volume is detached. |
diskofferingdisplaytext | the display text of the disk offering |
diskofferingid | ID of the disk offering |
diskofferingname | name of the disk offering |
domain | the domain associated with the disk volume |
domainid | the ID of the domain associated with the disk volume |
hypervisor | Hypervisor the volume belongs to |
isextractable | true if the volume is extractable, false otherwise |
name | name of the disk volume |
project | the project name of the vpn |
projectid | the project id of the vpn |
serviceofferingdisplaytext | the display text of the service offering for root disk |
serviceofferingid | ID of the service offering for root disk |
serviceofferingname | name of the service offering for root disk |
size | size of the disk volume |
snapshotid | ID of the snapshot from which this volume was created |
state | the state of the disk volume |
storage | name of the primary storage hosting the disk volume |
storagetype | shared or local storage |
type | type of the disk volume (ROOT or DATADISK) |
virtualmachineid | id of the virtual machine |
vmdisplayname | display name of the virtual machine |
vmname | name of the virtual machine |
vmstate | state of the virtual machine |
zoneid | ID of the availability zone |
zonename | name of the availability zone |