Apache CloudStack 4.19.0.0 Root Admin API Reference
updateServiceOffering
Updates a service offering.
Request parameters
Parameter Name | Description | Required |
id | the ID of the service offering to be updated | true |
displaytext | the display text of the service offering to be updated | false |
domainid | the ID of the containing domain(s) as comma separated string, public for public offerings | false |
hosttags | the host tag for this service offering. | false |
name | the name of the service offering to be updated | false |
sortkey | sort key of the service offering, integer | false |
storagetags | comma-separated list of tags for the service offering, tags should match with existing storage pool tags | false |
zoneid | the ID of the containing zone(s) as comma separated string, all for all zones offerings | false |
Response Tags
Response Name | Description |
id | the id of the service offering |
cacheMode | the cache mode to use for this disk offering. none, writeback or writethrough |
cpunumber | the number of CPU |
cpuspeed | the clock rate CPU speed in Mhz |
created | the date this service offering was created |
defaultuse | is this a default system vm offering |
deploymentplanner | deployment strategy used to deploy VM. |
diskBytesReadRate | bytes read rate of the service offering |
diskBytesReadRateMax | burst bytes read rate of the disk offering |
diskBytesReadRateMaxLength | length (in seconds) of the burst |
diskBytesWriteRate | bytes write rate of the service offering |
diskBytesWriteRateMax | burst bytes write rate of the disk offering |
diskBytesWriteRateMaxLength | length (in seconds) of the burst |
diskIopsReadRate | io requests read rate of the service offering |
diskIopsReadRateMax | burst io requests read rate of the disk offering |
diskIopsReadRateMaxLength | length (in second) of the burst |
diskIopsWriteRate | io requests write rate of the service offering |
diskIopsWriteRateMax | burst io requests write rate of the disk offering |
diskIopsWriteRateMaxLength | length (in seconds) of the burst |
diskofferingdisplaytext | the display text of the disk offering |
diskofferingid | the ID of the disk offering to which service offering is linked |
diskofferingname | name of the disk offering |
diskofferingstrictness | True/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 |
displaytext | an alternate display text of the service offering. |
domain | the domain name(s) this disk offering belongs to. Ignore this information as it is not currently applicable. |
domainid | the domain ID(s) this disk offering belongs to. Ignore this information as it is not currently applicable. |
dynamicscalingenabled | true if virtual machine needs to be dynamically scalable of cpu or memory |
encryptroot | true if virtual machine root disk will be encrypted on storage |
hosttags | the host tag for the service offering |
hypervisorsnapshotreserve | Hypervisor snapshot reserve space as a percent of a volume (for managed storage using Xen or VMware) |
iscustomized | is true if the offering is customized |
iscustomizediops | true if disk offering uses custom iops, false otherwise |
issystem | is this a system vm offering |
isvolatile | true 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 |
limitcpuuse | restrict the CPU usage to committed service offering |
maxiops | the max iops of the disk offering |
memory | the memory in MB |
miniops | the min iops of the disk offering |
name | the name of the service offering |
networkrate | data transfer rate in megabits per second allowed. |
offerha | the ha support in the service offering |
provisioningtype | provisioning type used to create volumes. Valid values are thin, sparse, fat. |
rootdisksize | Root disk size in GB |
serviceofferingdetails | additional key/value details tied with this service offering |
storagetags | the tags for the service offering |
storagetype | the storage type for this service offering |
systemvmtype | is this a the systemvm type for system vm offering |
vspherestoragepolicy | the vsphere storage policy tagged to the service offering in case of VMware |
zone | the zone name(s) this disk offering belongs to. Ignore this information as it is not currently applicable. |
zoneid | the zone ID(s) this disk offering belongs to. Ignore this information as it is not currently applicable. |