Apache CloudStack 4.14.1.0-SNAPSHOT Root Admin API Reference

uploadVolume

Uploads a data disk.

Request parameters

Parameter NameDescriptionRequired
formatthe format for the volume. Possible values include QCOW2, OVA, and VHD.true
namethe name of the volumetrue
urlthe URL of where the volume is hosted. Possible URL include http:// and https://true
zoneidthe ID of the zone the volume is to be hosted ontrue
accountan optional accountName. Must be used with domainId.false
checksumthe checksum value of this volume. The parameter containing the checksum will be considered a MD5sum if it is not prefixed and just a plain ascii/utf8 representation of a hexadecimal string. If it is required to use another algorithm the hexadecimal string is to be prefixed with a string of the form, "{<algorithm>}", not including the double quotes. In this <algorithm> is the exact string representing the java supported algorithm, i.e. MD5 or SHA-256. Note that java does not contain an algorithm called SHA256 or one called sha-256, only SHA-256.false
diskofferingidthe ID of the disk offering. This must be a custom sized offering since during uploadVolume volume size is unknown.false
domainidan optional domainId. If the account parameter is used, domainId must also be used.false
imagestoreuuidImage store uuidfalse
projectidUpload volume for the projectfalse

Response Tags

Response NameDescription
idID of the disk volume
accountthe account associated with the disk volume
attachedthe date the volume was attached to a VM instance
chaininfothe chain info of the volume
clusteridcluster id of the volume
clusternamecluster name where the volume is allocated
createdthe date the disk volume was created
destroyedthe boolean state of whether the volume is destroyed or not
deviceidthe ID of the device on user vm the volume is attahed to. This tag is not returned when the volume is detached.
diskBytesReadRatebytes read rate of the disk volume
diskBytesWriteRatebytes write rate of the disk volume
diskIopsReadRateio requests read rate of the disk volume per the disk offering
diskIopsWriteRateio requests write rate of the disk volume per the disk offering
diskioreadthe read (io) of disk on the vm
diskiowritethe write (io) of disk on the vm
diskkbsreadthe read (bytes) of disk on the vm
diskkbswritethe write (bytes) of disk on the vm
diskofferingdisplaytextthe display text of the disk offering
diskofferingidID of the disk offering
diskofferingnamename of the disk offering
displayvolumean optional field whether to the display the volume to the end user or not.
domainthe domain associated with the disk volume
domainidthe ID of the domain associated with the disk volume
hypervisorHypervisor the volume belongs to
isextractabletrue if the volume is extractable, false otherwise
isodisplaytextan alternate display text of the ISO attached to the virtual machine
isoidthe ID of the ISO attached to the virtual machine
isonamethe name of the ISO attached to the virtual machine
maxiopsmax iops of the disk volume
miniopsmin iops of the disk volume
namename of the disk volume
paththe path of the volume
physicalsizethe bytes alloaated
podidpod id of the volume
podnamepod name of the volume
projectthe project name of the vpn
projectidthe project id of the vpn
provisioningtypeprovisioning type used to create volumes.
quiescevmneed quiesce vm or not when taking snapshot
serviceofferingdisplaytextthe display text of the service offering for root disk
serviceofferingidID of the service offering for root disk
serviceofferingnamename of the service offering for root disk
sizesize of the disk volume
snapshotidID of the snapshot from which this volume was created
statethe state of the disk volume
statusthe status of the volume
storagename of the primary storage hosting the disk volume
storageidid of the primary storage hosting the disk volume; returned to admin user only
storagetypeshared or local storage
templatedisplaytext an alternate display text of the template for the virtual machine
templateidthe ID of the template for the virtual machine. A -1 is returned if the virtual machine was created from an ISO file.
templatenamethe name of the template for the virtual machine
typetype of the disk volume (ROOT or DATADISK)
utilizationthe disk utilization
virtualmachineidid of the virtual machine
virtualsizethe bytes actually consumed on disk
vmdisplaynamedisplay name of the virtual machine
vmnamename of the virtual machine
vmstatestate of the virtual machine
zoneidID of the availability zone
zonenamename of the availability zone
jobidthe ID of the latest async job acting on this object
jobstatusthe current status of the latest async job acting on this object