Cosmic User API Reference

listDiskOfferings

Lists all available disk offerings.

Request parameters

Parameter NameDescriptionRequired
domainidlist only resources belonging to the domain specifiedfalse
idID of the disk offeringfalse
isrecursivedefaults to false, but if true, lists all resources from the parent specified by the domainId till leaves.false
keywordList by keywordfalse
listallIf set to false, list only resources belonging to the command's caller; if set to true - list resources that the caller is authorized to see. Default value is falsefalse
namename of the disk offeringfalse
pagefalse
pagesizefalse

Response Tags

Response NameDescription
idunique ID of the disk offering
cacheModethe cache mode to use for this disk offering. none, writeback or writethrough
createdthe date this disk offering was created
diskBytesReadRatebytes read rate of the disk offering
diskBytesWriteRatebytes write rate of the disk offering
diskIopsRatePerGbio requests per GB
diskIopsReadRateio requests read rate of the disk offering
diskIopsTotalRateio requests total rate of the disk offering
diskIopsWriteRateio requests write rate of the disk offering
disksizethe size of the disk offering in GB
displayofferingwhether to display the offering to the end user or not.
displaytextan alternate display text of the disk offering.
domainthe domain name this disk offering belongs to. Ignore this information as it is not currently applicable.
domainidthe domain ID this disk offering belongs to. Ignore this information as it is not currently applicable.
hypervisorsnapshotreserveHypervisor snapshot reserve space as a percent of a volume (for managed storage using Xen)
iscustomizedtrue if disk offering uses custom size, false otherwise
iscustomizediopstrue if disk offering uses custom iops, false otherwise
maxiopsthe max iops of the disk offering
miniopsthe min iops of the disk offering
namethe name of the disk offering
provisioningtypeprovisioning type used to create volumes. Valid values are thin, sparse, fat.
storagetypethe storage type for this disk offering
tagsthe tags for the disk offering