Child pages
  • Get List of Compute Zones Attached to Location Group
Skip to end of metadata
Go to start of metadata
GET /settings/location_groups/:location_group_id/hypervisor_groups.xml
GET /settings/location_groups/:location_group_id/hypervisor_groups.json


On success, an array of compute zones is returned.

XML Output example

 <hypervisor_groups type="array">
<closed type="boolean">false</closed>
<created_at type="datetime">2013-09-04T12:49:45+03:00</created_at>
<federation_enabled type="boolean">false</federation_enabled>
<federation_id nil="true"/>
<hypervisor_id nil="true"/>
<id type="integer">1</id>
<identifier nil="true"/>
<label>KVM C5 Compute Zone</label>
<location_group_id type="integer">1</location_group_id>
<traded type="boolean>false</traded>
    <updated_at type="datetime">2015-04-02T16:47:37+03:00</updated_at>
    <max_host_free_memory type="integer">3819</max_host_free_memory>
    <max_host_cpu type="integer">4</max_host_cpu>
    <prefer_local_reads type="boolean">false</prefer_local_reads>
    <vlan nil="true"/>
    <network_failure type="boolean">false</network_failure>
    <storage_channel type="integer">2</storage_channel>
    <run_sysprep type="boolean">true</run_sysprep>
    <default_gateway nil="true"/>
    <failover_timeout type="integer">15</failover_timeout>
    <cpu_units type="integer">1000</cpu_units>
    <supplier_version nil="true"/>
    <supplier_provider nil="true"/>

Explanation of the data returned:

created_at - the date in the [YYYY][MM][DD]T[hh][mm][ss]Z format

federation_enabled - not relevant to compute zones

federation_id - not relevant to compute zones

closed - not relevant to compute zones

traded - true, if the zone came from the Federation and was subscribed to by the user

updated_at - the date when the compute zone was updated in the [YYYY][MM][DD]T[hh][mm][ss]Z format

default_gateway - external gateway IP address used for the VMware utilization with the external firewall. All virtual machines within a compute zone will be rerouted to this gateway

vlan - address of a VLAN the default gateway is located on. 

id - the compute zone ID

label* - title of a compute zone

location_group_id - ID of a location group the compute zone is assigned to

max_vms_start_at_once - the maximum number of virtual servers that can be started simultaneously within this compute zone

network_failure - true, if all compute resources in the compute zone failed

prefer_local_reads - set 1 to minimize the network throughput dependency for read heavy workloads. When this option is enabled, reads go over the local software bridge to a local replica of the data rather than traverse a physical NIC + switch.

recovery_type - specify the compute resource selection algorithm, which will be used on virtual server provisioning and recovery, per compute zone:

  • roundrobin - set the roundrobin type to select the compute resource with maximum free RAM during the VS recovery

    Note: this option behaves in different ways, depending on the event:

    • On provisioning, the round-robin algorithm will be used on compute resource selection.
    • On recovery, the compute resource with maximum free RAM will be selected.
  • fillnext - select the fillnext type to select the compute resource with minimum required free RAM. This option allows to fill compute resource as tightly as possible before starting to use next appliance in the zone 


release_resource_type - specify the release resource type. Release resource option allows to free up compute resource resources by over-committing RAM, CPU and CPU shares of virtual servers that are shut down. 

  • memory_guarantee - the actual free compute resource memory is calculated. All virtual servers residing on the compute resource will be able to start. 

  • ballooning - free compute resource memory is calculated with the ability to use memory over-committing. The ballooning option is only available for KVM compute resources. NOTE: Virtual server may be migrated to another compute resource if there is not enough memory for it to start up on the compute resource with the ballooning option enabled.  

     Do not use the ballooning option if there is at least one edge or storage server within the compute zone. 

  • only_started_vms - only the free memory of running virtual servers is calculated.

    By default, the compute zone is created with the Memory Guarantee option enabled. In this case the release resources option is not used. Then, to enable resource over-committing you should choose either the Ballooning or Only Started VS option.

failover_timeout - time period for which the iterations will run during the failover

run_sysprep - set 1 to enable Windows virtual server deployment without running sysprep

server_type - specify the type of servers that will reside within this compute zone:

  • virtual  - choose the virtual type to create a Xen, KVM, VMware or CloudBoot zone
  • smart - choose the smart server type to create a smart server zone
  • baremetal - choose the baremetal server type to create a baremetal server zone

storage_channel - storage channel for the communication with the

max_host_free_memory  - compute resource with maximum RAM value in this zone

max_host_cpu - compute resource with maximum RAM value in this zone


#trackbackRdf ($trackbackUtils.getContentIdentifier($page) $page.title $trackbackUtils.getPingUrl($page))
  • No labels