voxel.ips.list

List all IPs available to assign to servers and VMs.

Parameters

facility (optional)
Datacenter facility code, available via voxel.voxcloud.facilities.list or voxel.voxservers.facilities.list.
ip_address_type (optional)
Retrieve only addresses of the specified type, either "frontend" or "backend".
verbosity (optional)
Verbosity of response. Should be one of "compact", "normal", or "extended".

Example Response

<ip_addresses>
  <ip_address address="1.2.3.4" type="frontend" vlan_group_id="4321" vlan_number="1234">
    <facilities>
      <facility>LGA6</facility>
      <facility>LGA7</facility>
      ...
    </facility>
    <network>
      <subnet>1.2.3.0/24</subnet>
      <gateway>1.2.3.1</subnet>
      <broadcast>1.2.3.255</broadcast>
    </network>
  </ip_address>
  ...
</ip_addresses>

Notes

This method will request a list of IPs that can be used as input for voxel.voxcloud.create, voxel.voxcloud.clone, voxel.voxservers.create, or voxel.voxservers.reimage.

Method Specific Error Codes

206: Failed acquiring resource
A resource required to perform the action could not be obtained. Please try again or contact Voxel for assistance.