Resync vCenter VS
To resync a vCenter virtual server into OnApp, use the following request:
POST /virtual_machines/:id/resync.xml
POST /virtual_machines/:id/resync.json
XML Request Example
curl -i -X POST -u 'user:userpass' --url https://onapp.test/virtual_machines/4/resync.xml -H 'Accept: application/xml' -H 'Content-type: application/xml'
JSON Request Example
curl -i -X POST -u 'user:userpass' --url https://onapp.test/virtual_machines/4/resync.json -H 'Accept: application/json' -H 'Content-type: application/json'
XML Output Example
<virtual_machine> <id type="integer">2022</id> <hypervisor_id type="integer">156</hypervisor_id> <template_id nil="true"/> <identifier>bohpzakuuvzrwu</identifier> <hostname>mscentossnap</hostname> <memory type="integer">384</memory> <cpus type="integer">1</cpus> <cpu_shares type="integer">20</cpu_shares> <created_at type="dateTime">2019-09-03T11:41:52+03:00</created_at> <updated_at type="dateTime">2019-09-03T11:44:38+03:00</updated_at> <built type="boolean">true</built> <locked type="boolean">false</locked> <booted type="boolean">false</booted> <xen_id nil="true"/> <remote_access_password nil="true"/> <local_remote_access_port nil="true"/> <label>ms.centossnapfu</label> <recovery_mode nil="true"/> <user_id type="integer">376</user_id> <operating_system>linux</operating_system> <operating_system_distro>centos64Guest</operating_system_distro> <allowed_swap type="boolean">true</allowed_swap> <template_label nil="true"/> <min_disk_size nil="true"/> <allowed_hot_migrate nil="true"/> <note nil="true"/> <admin_note nil="true"/> <suspended type="boolean">false</suspended> <strict_virtual_machine_id nil="true"/> <enable_autoscale type="boolean">false</enable_autoscale> <add_to_marketplace nil="true"/> <state>delivered</state> <initial_root_password_encrypted type="boolean">false</initial_root_password_encrypted> <edge_server_type nil="true"/> <storage_server_type nil="true"/> <firewall_notrack type="boolean">false</firewall_notrack> <service_password nil="true"/> <preferred_hvs type="array"/> <local_remote_access_ip_address nil="true"/> <cpu_units type="integer">200</cpu_units> <cpu_sockets nil="true"/> <draas_keys type="array"/> <iso_id nil="true"/> <cores_per_socket type="integer">0</cores_per_socket> <instance_package_id nil="true"/> <hot_add_cpu type="boolean">false</hot_add_cpu> <hot_add_memory type="boolean">false</hot_add_memory> <time_zone nil="true"/> <autoscale_service nil="true"/> <cdboot type="boolean">false</cdboot> <draas_mode type="integer">0</draas_mode> <vapp_id nil="true"/> <vmware_tools nil="true"/> <vcenter_moref>vm-4532</vcenter_moref> <template_version nil="true"/> <openstack_id nil="true"/> <domain>localdomain</domain> <vcenter_reserved_memory type="integer">0</vcenter_reserved_memory> <deleted_at nil="true"/> <properties> </properties> <acceleration_allowed type="boolean">true</acceleration_allowed> <vcenter_cluster_id type="integer">6</vcenter_cluster_id> <virsh_console type="boolean">false</virsh_console> <ip_addresses type="array"/> <monthly_bandwidth_used type="decimal">0.0</monthly_bandwidth_used> <total_disk_size type="integer">3</total_disk_size> <support_incremental_backups type="boolean">false</support_incremental_backups> <cpu_priority type="integer">20</cpu_priority> <built_from_iso type="boolean">false</built_from_iso> <built_from_ova type="boolean">false</built_from_ova> <acceleration type="boolean">false</acceleration> <hypervisor_type>vcenter</hypervisor_type> </virtual_machine>
Where:
id - id of the virtual server
hypervisor_id - id of the compute resource
template_id - id of the template
identifier - the VS identifier in the DB
hostname - the VS's host name
memory - the amount of RAM allocated to this VS
cpus - the number of CPU cores assigned to the VS
cpu_shares - the CPU priority value
created_at - the date, when the VS was created in the [YYYY][MM][DD]T[hh][mm][ss]Z format
updated_at - the date, when the VS was updated in the [YYYY][MM][DD]T[hh][mm][ss]Z format
built - true if the virtual server is built, otherwise false
locked - true if the virtual server is locked, otherwise false
booted - true if the virtual server is booted, otherwise false
xen_id - this parameter is not applicable to vCenter VS
remote_access_password - the password for remote access
local_remote_access_port - the port ID used for used for console access
label - label of the VS
recovery_mode - true if recovery mode is allowed, otherwise false
user_id - the ID of a new owner in OnApp
operating_system - the OS on which the virtual server is based
operating_system_distro - the distribution of the OS
allowed_swap - true, if swap is allowed; otherwise, false
template_label - label of the template
allowed_hot_migrate - true, if hot migration for the VS is allowed; otherwise, false
note - optional text, added as a note
admin_note - optional text note
suspended - true, if the VS is suspended; otherwise, false
enable_autoscale - true, if autoscale is enabled for the VS; otherwise, false
add_to_marketplace - this parameter is not applicable to vCenter VS
initial_root_password_encrypted - true, if root password for the VS is encrypted on the vCenter side; otherwise, false
edge_server_type - this parameter is not applicable to vCenter VS
storage_server_type - this parameter is not applicable to vCenter VS
firewall_notrack - true if the NOTRACK rule is set in iptables
service_password - service account password
preferred_hvs - the array of preferable compute resources based on compute zone that meet some virtual server configuration settings
local_remote_access_ip_address - IP address used for remote access
cpu_units - the amount of CPU units per core if the CPU priority is replaced with CPU units in the user bucket
cpu_sockets - the amount of CPU sockets per core
cores_per_socket - the number of CPU cores per socket
instance_package_id - id of the instance package
hot_add_cpu - true, if the CPU parameter can be changed without rebooting the VS; otherwise, false
hot_add_memory - true, if the memory parameter can be changed without rebooting the VS; otherwise, false
time_zone - the time zone of the user
autoscale_service - this parameter is not applicable to vCenter VS
vapp_id - this parameter is not applicable to vCenter VS
vcenter_moref - moref of the virtual server on vCenter
template_version - the version of the template
deleted_at - time when the VS was deleted in the [YYYY][MM][DD]T[hh][mm][ss]Z format
acceleration_allowed - true, if acceleration is allowed for the VS; otherwise, false
vcenter_cluster_id - ID of the vCenter cluster
virsh_console - true, if Virsh console is enabled for the VS, otherwise, false
ip_addresses - an array of IP addresses assigned to this virtual server
monthly_bandwidth_used - VS's monthly bandwidth
total_disk_size - the total disk size in GB of all disks assigned to the VS
support_incremental_backups - true, if incremental backups are supported; otherwise, false
cpu_priority - it has the same value as cpu_shares parameter
built_from_iso - true, if the VS was built from an ISO template; otherwise, false
built_from_ova - true, if the VS was built from an OVA template; otherwise, false
acceleration - true, if acceleration is allowed for the VS; otherwise, false
hypervisor_type - the type of the compute resource (vCenter)