Apache CloudStack 4.23.0.0 Root Admin API Reference

createServiceInstance

Creates a system virtual-machine that implements network services

Request parameters

Parameter NameDescriptionRequired
leftnetworkidThe left (inside) network for service instancetrue
nameThe name of the service instancetrue
rightnetworkidThe right (outside) network ID for the service instancetrue
serviceofferingidThe service offering ID that defines the resources consumed by the service appliancetrue
templateidThe template ID that specifies the image for the service appliancetrue
zoneidAvailability zone for the service instancetrue
accountAn optional account for the virtual machine. Must be used with domainId.false
domainidAn optional domainId for the virtual machine. If the account parameter is used, domainId must also be used.false
projectidProject ID for the service instancefalse

Response Tags

Response NameDescription
idThe ID of the Instance
accountThe account associated with the Instance
displaynameUser generated name. The name of the Instance is returned if no displayname exists.
domainThe name of the domain in which the Instance exists
domainidThe ID of the domain in which the Instance exists
domainpathPath of the Domain in which the Instance exists
nameThe name of the Instance
projectThe project name of the vm
projectidThe project ID of the Instance