stopVirtualMachine

Stops a virtual machine.

Request Parameters

Parameter Name Description Required
id The ID of the virtual machine true
forced Force stop the VM. The caller knows the VM is stopped. false

Response Tags

Response Name Description
id the ID of the virtual machine
account the account associated with the virtual machine
cpunumber the number of cpu this virtual machine is running with
cpuspeed the speed of each cpu
cpuused the amount of the vm's CPU currently used
created the date when this virtual machine was created
displayname user generated name. The name of the virtual machine is returned if no displayname exists.
domain the name of the domain in which the virtual machine exists
domainid the ID of the domain in which the virtual machine exists
forvirtualnetwork the virtual network for the service offering
group the group name of the virtual machine
groupid the group ID of the virtual machine
guestosid Os type ID of the virtual machine
haenable true if high-availability is enabled, false otherwise
hostid the ID of the host for the virtual machine
hostname the name of the host for the virtual machine
hypervisor the hypervisor on which the template runs
ipaddress the ip address of the virtual machine
isodisplaytext an alternate display text of the ISO attached to the virtual machine
isoid the ID of the ISO attached to the virtual machine
isoname the name of the ISO attached to the virtual machine
jobid shows the current pending asynchronous job ID. This tag is not returned if no current pending jobs are acting on the virtual machine
jobstatus shows the current pending asynchronous job status
memory the memory allocated for the virtual machine
name the name of the virtual machine
networkkbsread the incoming network traffic on the vm
networkkbswrite the outgoing network traffic on the host
password the password (if exists) of the virtual machine
passwordenabled true if the password rest feature is enabled, false otherwise
rootdeviceid device ID of the root volume
rootdevicetype device type of the root volume
serviceofferingid the ID of the service offering of the virtual machine
serviceofferingname the name of the service offering of the virtual machine
state the state of the virtual machine
templatedisplaytext an alternate display text of the template for the virtual machine
templateid the ID of the template for the virtual machine. A -1 is returned if the virtual machine was created from an ISO file.
templatename the name of the template for the virtual machine
zoneid the ID of the availablility zone for the virtual machine
zonename the name of the availability zone for the virtual machine
nic(*) the list of nics associated with vm
id the ID of the nic
broadcasturi the broadcast uri of the nic
gateway the gateway of the nic
ipaddress the ip address of the nic
isdefault true if nic is default, false otherwise
isolationuri the isolation uri of the nic
macaddress true if nic is default, false otherwise
netmask the netmask of the nic
networkid the ID of the corresponding network
traffictype the traffic type of the nic
type the type of the nic
securitygroup(*) list of security groups associated with the virtual machine
id the ID of the security group
account the account owning the security group
description the description of the security group
domain the domain name of the security group
domainid the domain ID of the security group
jobid shows the current pending asynchronous job ID. This tag is not returned if no current pending jobs are acting on the volume
jobstatus shows the current pending asynchronous job status
name the name of the security group
ingressrule(*) the list of ingress rules associated with the security group
account account owning the ingress rule
cidr the CIDR notation for the base IP address of the ingress rule
endport the ending IP of the ingress rule
icmpcode the code for the ICMP message response
icmptype the type of the ICMP message response
protocol the protocol of the ingress rule
ruleid the id of the ingress rule
securitygroupname security group name
startport the starting IP of the ingress rule
Related Pages: listNetworks, restartNetwork, updateNetwork, associateIpAddress, disassociateIpAddress, listPublicIpAddresses, createLoadBalancerRule, deleteLoadBalancerRule, removeFromLoadBalancerRule, assignToLoadBalancerRule, listLoadBalancerRules, listLoadBalancerRuleInstances, updateLoadBalancerRule, listPortForwardingRules, createPortForwardingRule, deletePortForwardingRule, createFirewallRule, deleteFirewallRule, listFirewallRules, createRemoteAccessVpn, deleteRemoteAccessVpn, listRemoteAccessVpns, enableStaticNat, createIpForwardingRule, deleteIpForwardingRule, listIpForwardingRules, disableStaticNat, extractVolume, listZones, login, logout, listAccounts, queryAsyncJobResult, listAsyncJobs, listServiceOfferings, listDiskOfferings, registerSSHKeyPair, createSSHKeyPair, deleteSSHKeyPair, listSSHKeyPairs, listVirtualMachines, destroyVirtualMachine, rebootVirtualMachine, resetPasswordForVirtualMachine, changeServiceForVirtualMachine, updateVirtualMachine, getVMPassword, deployVirtualMachine, startVirtualMachine, listSnapshots, listSnapshotPolicies, deleteSnapshot, createSnapshot, createSnapshotPolicy, deleteSnapshotPolicies, listTemplates, createTemplate, registerTemplate, updateTemplate, copyTemplate, deleteTemplate, updateTemplatePermissions, listTemplatePermissions, extractTemplate, listSecurityGroups, createSecurityGroup, deleteSecurityGroup, authorizeSecurityGroupIngress, revokeSecurityGroupIngress, listVolumes, createVolume, attachVolume, detachVolume, deleteVolume, listNetworkOfferings, createNetwork, deleteNetwork, listTags, createTags, deleteTags