Apache CloudStack 4.16.0.0 Root Admin API Reference
createServiceOffering
Creates a service offering.
Request parameters
| Parameter Name | Description | Required |
| displaytext | the display text of the service offering | true |
| name | the name of the service offering | true |
| bytesreadrate | bytes read rate of the disk offering | false |
| bytesreadratemax | burst bytes read rate of the disk offering | false |
| bytesreadratemaxlength | length (in seconds) of the burst | false |
| byteswriterate | bytes write rate of the disk offering | false |
| byteswriteratemax | burst bytes write rate of the disk offering | false |
| byteswriteratemaxlength | length (in seconds) of the burst | false |
| cachemode | the cache mode to use for this disk offering. none, writeback or writethrough | false |
| cpunumber | the CPU number of the service offering | false |
| cpuspeed | the CPU speed of the service offering in MHz. | false |
| customized | Whether service offering size is custom or not | false |
| customizediops | whether compute offering iops is custom or not | false |
| deploymentplanner | The deployment planner heuristics used to deploy a VM of this offering. If null, value of global config vm.deployment.planner is used | false |
| domainid | the ID of the containing domain(s), null for public offerings | false |
| dynamicscalingenabled | true if virtual machine needs to be dynamically scalable of cpu or memory | false |
| hosttags | the host tag for this service offering. | false |
| hypervisorsnapshotreserve | Hypervisor snapshot reserve space as a percent of a volume (for managed storage using Xen or VMware) | false |
| iopsreadrate | io requests read rate of the disk offering | false |
| iopsreadratemax | burst requests read rate of the disk offering | false |
| iopsreadratemaxlength | length (in seconds) of the burst | false |
| iopswriterate | io requests write rate of the disk offering | false |
| iopswriteratemax | burst io requests write rate of the disk offering | false |
| iopswriteratemaxlength | length (in seconds) of the burst | false |
| issystem | is this a system vm offering | false |
| isvolatile | true if the virtual machine needs to be volatile so that on every reboot of VM, original root disk is dettached then destroyed and a fresh root disk is created and attached to VM | false |
| limitcpuuse | restrict the CPU usage to committed service offering | false |
| maxcpunumber | The maximum number of CPUs to be set with Custom Computer Offering | false |
| maxiops | max iops of the compute offering | false |
| maxmemory | The maximum memroy size of the custom service offering in MB | false |
| memory | the total memory of the service offering in MB | false |
| mincpunumber | The minimum number of CPUs to be set with Custom Computer Offering | false |
| miniops | min iops of the compute offering | false |
| minmemory | The minimum memroy size of the custom service offering in MB | false |
| networkrate | data transfer rate in megabits per second allowed. Supported only for non-System offering and system offerings having "domainrouter" systemvmtype | false |
| offerha | the HA for the service offering | false |
| provisioningtype | provisioning type used to create volumes. Valid values are thin, sparse, fat. | false |
| rootdisksize | the Root disk size in GB. | false |
| serviceofferingdetails | details for planner, used to store specific parameters | false |
| storagepolicy | Name of the storage policy defined at vCenter, this is applicable only for VMware | false |
| storagetype | the storage type of the service offering. Values are local and shared. | false |
| systemvmtype | the system VM type. Possible types are "domainrouter", "consoleproxy" and "secondarystoragevm". | false |
| tags | the tags for this service offering. | false |
| zoneid | the ID of the containing zone(s), null for public 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 |
| 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 |
| 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. |