Apache CloudStack 4.18.0.0 Root Admin API Reference

updateServiceOffering

Updates a service offering.

Request parameters

Parameter NameDescriptionRequired
idthe ID of the service offering to be updatedtrue
displaytextthe display text of the service offering to be updatedfalse
domainidthe ID of the containing domain(s) as comma separated string, public for public offeringsfalse
hosttagsthe host tag for this service offering.false
namethe name of the service offering to be updatedfalse
sortkeysort key of the service offering, integerfalse
storagetagscomma-separated list of tags for the service offering, tags should match with existing storage pool tagsfalse
zoneidthe ID of the containing zone(s) as comma separated string, all for all zones offeringsfalse

Response Tags

Response NameDescription
idthe id of the service offering
cacheModethe cache mode to use for this disk offering. none, writeback or writethrough
cpunumberthe number of CPU
cpuspeedthe clock rate CPU speed in Mhz
createdthe date this service offering was created
defaultuseis this a default system vm offering
deploymentplannerdeployment strategy used to deploy VM.
diskBytesReadRatebytes read rate of the service offering
diskBytesReadRateMaxburst bytes read rate of the disk offering
diskBytesReadRateMaxLengthlength (in seconds) of the burst
diskBytesWriteRatebytes write rate of the service offering
diskBytesWriteRateMaxburst bytes write rate of the disk offering
diskBytesWriteRateMaxLengthlength (in seconds) of the burst
diskIopsReadRateio requests read rate of the service offering
diskIopsReadRateMaxburst io requests read rate of the disk offering
diskIopsReadRateMaxLengthlength (in second) of the burst
diskIopsWriteRateio requests write rate of the service offering
diskIopsWriteRateMaxburst io requests write rate of the disk offering
diskIopsWriteRateMaxLengthlength (in seconds) of the burst
diskofferingdisplaytextthe display text of the disk offering
diskofferingidthe ID of the disk offering to which service offering is linked
diskofferingnamename of the disk offering
diskofferingstrictnessTrue/False to indicate the strictness of the disk offering association with the compute offering. When set to true, override of disk offering is not allowed when VM is deployed and change disk offering is not allowed for the ROOT disk after the VM is deployed
displaytextan alternate display text of the service offering.
domainthe domain name(s) this disk offering belongs to. Ignore this information as it is not currently applicable.
domainidthe domain ID(s) this disk offering belongs to. Ignore this information as it is not currently applicable.
dynamicscalingenabledtrue if virtual machine needs to be dynamically scalable of cpu or memory
encryptroottrue if virtual machine root disk will be encrypted on storage
hosttagsthe host tag for the service offering
hypervisorsnapshotreserveHypervisor snapshot reserve space as a percent of a volume (for managed storage using Xen or VMware)
iscustomizedis true if the offering is customized
iscustomizediopstrue if disk offering uses custom iops, false otherwise
issystemis this a system vm offering
isvolatiletrue if the vm needs to be volatile, i.e., on every reboot of vm from API root disk is discarded and creates a new root disk
limitcpuuserestrict the CPU usage to committed service offering
maxiopsthe max iops of the disk offering
memorythe memory in MB
miniopsthe min iops of the disk offering
namethe name of the service offering
networkratedata transfer rate in megabits per second allowed.
offerhathe ha support in the service offering
provisioningtypeprovisioning type used to create volumes. Valid values are thin, sparse, fat.
rootdisksizeRoot disk size in GB
serviceofferingdetailsadditional key/value details tied with this service offering
storagetagsthe tags for the service offering
storagetypethe storage type for this service offering
systemvmtypeis this a the systemvm type for system vm offering
vspherestoragepolicythe vsphere storage policy tagged to the service offering in case of VMware
zonethe zone name(s) this disk offering belongs to. Ignore this information as it is not currently applicable.
zoneidthe zone ID(s) this disk offering belongs to. Ignore this information as it is not currently applicable.