Apache CloudStack Root Admin API Reference


Upload a data disk to the cloudstack cloud.

Request parameters

Parameter NameDescriptionRequired
formatthe format for the volume/template. Possible values include QCOW2, OVA, and VHD.true
namethe name of the volume/templatetrue
zoneidthe ID of the zone the volume/template is to be hosted ontrue
accountan optional accountName. Must be used with domainId.false
checksumthe checksum value of this volume/template 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 upload of volume/template size is unknown.false
domainidan optional domainId. If the account parameter is used, domainId must also be used.false
imagestoreuuidImage store uuidfalse
projectidUpload volume/template for the projectfalse

Response Tags

Response NameDescription
idthe template/volume ID
expiresthe timestamp after which the signature expires
metadataencrypted data to be sent in the POST request.
postURLPOST url to upload the file to
signaturesignature to be sent in the POST request.