Abiquo Documentation Cookies Policy

Our Documentation website uses cookies to improve your experience. Please visit our Cookie Policy page for more information about cookies and how we use them.


Abiquo 4.4

Skip to end of metadata
Go to start of metadata

Contents:

Public IPs Resource

The Public IPs resource manages Public, External and Unmanaged IPs, which are all part of datacenter networks. Each kind of network has its own method for managing IPs.

Main URI of the Resource

This class operates mainly over the Resource URI: /admin/datacenters/{datacenter}/network/{publicnetwork}/ips

Exposed Methods

List IPs in an external network

Retrieves the list of IPs from an external VLAN.

Paging Method

This method works with paging. Check out Basic Behaviors for information about how it works

Synopsis: GET http://example.com/api/admin/datacenters/{datacenter}/network/{publicnetwork}/ips
Roles Required: PHYS_DC_RETRIEVE_DETAILS
Request Headers: Accept: application/vnd.abiquo.externalips+json; version=4.4; application/vnd.abiquo.externalips+xml; version=4.4;  Content-type: ;
Request Parameters:

Parameter

Required

Default Value

Description

startwith

false

0

First element to retrieve.

by

false

ip

How to order the search. Available values are: {IP, QUARANTINE, MAC, LEASE, VLAN,
VIRTUALDATACENTER, VIRTUALMACHINE, VIRTUALAPPLIANCE, ENTERPRISENAME}

has

false

 

a way to filter the search. It can be filtered by: IP address, MAC address,
network name, Virtual Machine name, Virtual Appliance name or Enterprise Name

limit

false

25

number of elements to retrieve.

asc

false

true

the way to order the search (ascendant-> true, descendant -> false). Ascendant by
default.

available

false

false

If false, or not present return all IPs. If true, retrieve only the available IPs.
By default there is no value and the request returns all IPs

 

 

 

 

Request Message Body Entity:
Response Message Body Entity: ExternalIps Media Type
Request Example:


List external IPs

 Click here to expand...

GET_adm_dcs_X_nw_X_ips_AC_extips_j.0001.txt

cURL:

curl -X GET http://localhost:9000/api/admin/datacenters/3942/network/1540/ips \ 
	 -H 'Accept:application/vnd.abiquo.externalips+json; version=4.2' \ 
	 -u user:password --verbose 

Success status code: 200

Request payload:

--none--

Response payload:

{
  "totalSize": 6, 
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/3942/network/1540/ips?limit=25&by=ip&asc=true", 
      "rel": "first"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/3942/network/1540/ips?startwith=0&limit=25&by=ip&asc=true", 
      "rel": "last"
    }
  ], 
  "collection": [
    {
      "available": true, 
      "name": "2035", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3942/network/1540", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "2032"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4563", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "1991"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3942/network/1540/ips/16125", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "10.20.30.1"
        }
      ], 
      "ip": "10.20.30.1", 
      "quarantine": false, 
      "mac": "b1:90:0b:42:94:42", 
      "ipv6": false, 
      "networkName": "2036", 
      "id": 16125
    }, 
    {
      "available": true, 
      "name": "2040", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3942/network/1540", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "2032"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4563", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "1991"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3942/network/1540/ips/16126", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "10.20.30.2"
        }
      ], 
      "ip": "10.20.30.2", 
      "quarantine": false, 
      "mac": "c2:d0:a2:82:92:b2", 
      "ipv6": false, 
      "networkName": "2041", 
      "id": 16126
    }, 
    {
      "available": true, 
      "name": "2045", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3942/network/1540", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "2032"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4563", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "1991"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3942/network/1540/ips/16127", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "10.20.30.3"
        }
      ], 
      "ip": "10.20.30.3", 
      "quarantine": false, 
      "mac": "a0:73:ef:28:be:39", 
      "ipv6": false, 
      "networkName": "2046", 
      "id": 16127
    }, 
    {
      "available": true, 
      "name": "2050", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3942/network/1540", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "2032"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4563", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "1991"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3942/network/1540/ips/16128", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "10.20.30.4"
        }
      ], 
      "ip": "10.20.30.4", 
      "quarantine": false, 
      "mac": "4a:8d:58:38:f8:2e", 
      "ipv6": false, 
      "networkName": "2051", 
      "id": 16128
    }, 
    {
      "available": true, 
      "name": "2055", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3942/network/1540", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "2032"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4563", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "1991"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3942/network/1540/ips/16129", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "10.20.30.5"
        }
      ], 
      "ip": "10.20.30.5", 
      "quarantine": false, 
      "mac": "47:c6:56:d2:11:67", 
      "ipv6": false, 
      "networkName": "2056", 
      "id": 16129
    }, 
    {
      "available": true, 
      "name": "2060", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3942/network/1540", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "2032"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4563", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "1991"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3942/network/1540/ips/16130", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "10.20.30.6"
        }
      ], 
      "ip": "10.20.30.6", 
      "quarantine": false, 
      "mac": "75:e9:3d:00:13:12", 
      "ipv6": false, 
      "networkName": "2061", 
      "id": 16130
    }
  ]
}

 

List IPs in public network

Retrieves the list of IPs from a Public VLAN.

Paging Method

This method works with paging. Check out Basic Behaviors for information about how it works

Synopsis: GET http://example.com/api/admin/datacenters/{datacenter}/network/{publicnetwork}/ips
Roles Required: PHYS_DC_RETRIEVE_DETAILS
Request Headers: Accept: application/vnd.abiquo.publicips+json; version=4.4; application/vnd.abiquo.publicips+xml; version=4.4; ; Content-type: ;
Request Parameters:

Parameter

Required

Default Value

Description

startwith

false

0

First element to retrieve.

by

false

ip

How to order the search. Available values are: {IP, QUARANTINE, MAC, LEASE, VLAN,
VIRTUALDATACENTER, VIRTUALMACHINE, VIRTUALAPPLIANCE, ENTERPRISENAME}

has

false

 

a way to filter the search. It can be filtered by: IP address, MAC address,
network name, Virtual Machine name, Virtual Appliance name or Enterprise Name

limit

false

25

number of elements to retrieve.

asc

false

true

the way to order the search (ascendant-> true, descendant -> false). Ascendant by
default.

all

false

false

set if we should return all the IPs or only the available ones (by default).

 

 

 

 

Request Message Body Entity:
Response Message Body Entity: PublicIps Media Type
Request Example:

 Click here to show or hide the request example

GET_adm_dcs_X_nw_X_ips_AC_pubips_j.0001.txt

cURL:

curl -X GET http://localhost:9000/api/admin/datacenters/3943/network/1541/ips \ 
	 -H 'Accept:application/vnd.abiquo.publicips+json; version=4.2' \ 
	 -u user:password --verbose 

Success status code: 200

Request payload:

--none--

Response payload:

{
  "totalSize": 6, 
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/3943/network/1541/ips?limit=25&by=ip&asc=true", 
      "rel": "first"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/3943/network/1541/ips?startwith=0&limit=25&by=ip&asc=true", 
      "rel": "last"
    }
  ], 
  "collection": [
    {
      "available": true, 
      "name": "2109", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3943/network/1541", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "2106"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4564", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "2065"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3943/network/1541/ips/16131", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "10.20.30.1"
        }
      ], 
      "ip": "10.20.30.1", 
      "quarantine": false, 
      "mac": "85:cd:8c:2f:9c:1d", 
      "ipv6": false, 
      "networkName": "2110", 
      "id": 16131
    }, 
    {
      "available": true, 
      "name": "2114", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3943/network/1541", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "2106"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4564", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "2065"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3943/network/1541/ips/16132", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "10.20.30.2"
        }
      ], 
      "ip": "10.20.30.2", 
      "quarantine": false, 
      "mac": "4e:24:be:f0:e3:b2", 
      "ipv6": false, 
      "networkName": "2115", 
      "id": 16132
    }, 
    {
      "available": true, 
      "name": "2119", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3943/network/1541", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "2106"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4564", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "2065"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3943/network/1541/ips/16133", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "10.20.30.3"
        }
      ], 
      "ip": "10.20.30.3", 
      "quarantine": false, 
      "mac": "f7:fe:69:72:37:d3", 
      "ipv6": false, 
      "networkName": "2120", 
      "id": 16133
    }, 
    {
      "available": true, 
      "name": "2124", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3943/network/1541", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "2106"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4564", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "2065"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3943/network/1541/ips/16134", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "10.20.30.4"
        }
      ], 
      "ip": "10.20.30.4", 
      "quarantine": false, 
      "mac": "d0:c9:5c:80:e3:51", 
      "ipv6": false, 
      "networkName": "2125", 
      "id": 16134
    }, 
    {
      "available": true, 
      "name": "2129", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3943/network/1541", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "2106"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4564", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "2065"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3943/network/1541/ips/16135", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "10.20.30.5"
        }
      ], 
      "ip": "10.20.30.5", 
      "quarantine": false, 
      "mac": "7a:57:da:c7:8b:02", 
      "ipv6": false, 
      "networkName": "2130", 
      "id": 16135
    }, 
    {
      "available": true, 
      "name": "2134", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3943/network/1541", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "2106"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4564", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "2065"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3943/network/1541/ips/16136", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "10.20.30.6"
        }
      ], 
      "ip": "10.20.30.6", 
      "quarantine": false, 
      "mac": "13:ee:1b:cf:b1:92", 
      "ipv6": false, 
      "networkName": "2135", 
      "id": 16136
    }
  ]
}

Additional example showing paging

 Click here to show or hide the request example

GET_adm_dcs_X_nw_X_ips_AC_pubips_j_lmt.0001.txt

cURL:

curl -X GET http://localhost:9000/api/admin/datacenters/4017/network/1608/ips?limit=25 \ 
	 -H 'Accept:application/vnd.abiquo.publicips+json; version=4.2' \ 
	 -u user:password --verbose 

Success status code: 200

Request payload:

--none--

Response payload:

{
  "totalSize": 254, 
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips?limit=25&by=ip&asc=true", 
      "rel": "first"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips?startwith=25&limit=25&by=ip&asc=true", 
      "rel": "next"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips?startwith=229&limit=25&by=ip&asc=true", 
      "rel": "last"
    }
  ], 
  "collection": [
    {
      "available": true, 
      "name": "12155", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16217", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.1"
        }
      ], 
      "ip": "192.168.1.1", 
      "quarantine": false, 
      "mac": "c0:9f:f0:34:00:a5", 
      "ipv6": false, 
      "networkName": "12156", 
      "id": 16217
    }, 
    {
      "available": true, 
      "name": "12160", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16218", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.2"
        }
      ], 
      "ip": "192.168.1.2", 
      "quarantine": false, 
      "mac": "52:40:67:eb:5d:e5", 
      "ipv6": false, 
      "networkName": "12161", 
      "id": 16218
    }, 
    {
      "available": true, 
      "name": "12165", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16219", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.3"
        }
      ], 
      "ip": "192.168.1.3", 
      "quarantine": false, 
      "mac": "8c:60:e6:47:56:26", 
      "ipv6": false, 
      "networkName": "12166", 
      "id": 16219
    }, 
    {
      "available": true, 
      "name": "12170", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16220", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.4"
        }
      ], 
      "ip": "192.168.1.4", 
      "quarantine": false, 
      "mac": "32:67:ec:67:6c:04", 
      "ipv6": false, 
      "networkName": "12171", 
      "id": 16220
    }, 
    {
      "available": true, 
      "name": "12175", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16221", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.5"
        }
      ], 
      "ip": "192.168.1.5", 
      "quarantine": false, 
      "mac": "14:6c:f7:d8:72:ef", 
      "ipv6": false, 
      "networkName": "12176", 
      "id": 16221
    }, 
    {
      "available": true, 
      "name": "12180", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16222", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.6"
        }
      ], 
      "ip": "192.168.1.6", 
      "quarantine": false, 
      "mac": "2f:05:29:e4:9a:ef", 
      "ipv6": false, 
      "networkName": "12181", 
      "id": 16222
    }, 
    {
      "available": true, 
      "name": "12185", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16223", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.7"
        }
      ], 
      "ip": "192.168.1.7", 
      "quarantine": false, 
      "mac": "43:a9:cf:97:db:65", 
      "ipv6": false, 
      "networkName": "12186", 
      "id": 16223
    }, 
    {
      "available": true, 
      "name": "12190", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16224", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.8"
        }
      ], 
      "ip": "192.168.1.8", 
      "quarantine": false, 
      "mac": "b5:44:36:01:be:ef", 
      "ipv6": false, 
      "networkName": "12191", 
      "id": 16224
    }, 
    {
      "available": true, 
      "name": "12195", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16225", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.9"
        }
      ], 
      "ip": "192.168.1.9", 
      "quarantine": false, 
      "mac": "0d:fc:dc:a0:17:63", 
      "ipv6": false, 
      "networkName": "12196", 
      "id": 16225
    }, 
    {
      "available": true, 
      "name": "12200", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16226", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.10"
        }
      ], 
      "ip": "192.168.1.10", 
      "quarantine": false, 
      "mac": "2e:e3:13:88:f6:c2", 
      "ipv6": false, 
      "networkName": "12201", 
      "id": 16226
    }, 
    {
      "available": true, 
      "name": "12205", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16227", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.11"
        }
      ], 
      "ip": "192.168.1.11", 
      "quarantine": false, 
      "mac": "d8:82:35:6b:1b:73", 
      "ipv6": false, 
      "networkName": "12206", 
      "id": 16227
    }, 
    {
      "available": true, 
      "name": "12210", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16228", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.12"
        }
      ], 
      "ip": "192.168.1.12", 
      "quarantine": false, 
      "mac": "1f:5b:ae:04:d8:99", 
      "ipv6": false, 
      "networkName": "12211", 
      "id": 16228
    }, 
    {
      "available": true, 
      "name": "12215", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16229", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.13"
        }
      ], 
      "ip": "192.168.1.13", 
      "quarantine": false, 
      "mac": "7e:ce:bb:cd:34:df", 
      "ipv6": false, 
      "networkName": "12216", 
      "id": 16229
    }, 
    {
      "available": true, 
      "name": "12220", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16230", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.14"
        }
      ], 
      "ip": "192.168.1.14", 
      "quarantine": false, 
      "mac": "75:11:36:be:ee:3a", 
      "ipv6": false, 
      "networkName": "12221", 
      "id": 16230
    }, 
    {
      "available": true, 
      "name": "12225", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16231", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.15"
        }
      ], 
      "ip": "192.168.1.15", 
      "quarantine": false, 
      "mac": "2e:ea:6e:d5:10:96", 
      "ipv6": false, 
      "networkName": "12226", 
      "id": 16231
    }, 
    {
      "available": true, 
      "name": "12230", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16232", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.16"
        }
      ], 
      "ip": "192.168.1.16", 
      "quarantine": false, 
      "mac": "d5:68:3b:3b:36:10", 
      "ipv6": false, 
      "networkName": "12231", 
      "id": 16232
    }, 
    {
      "available": true, 
      "name": "12235", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16233", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.17"
        }
      ], 
      "ip": "192.168.1.17", 
      "quarantine": false, 
      "mac": "79:de:9b:2f:7f:83", 
      "ipv6": false, 
      "networkName": "12236", 
      "id": 16233
    }, 
    {
      "available": true, 
      "name": "12240", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16234", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.18"
        }
      ], 
      "ip": "192.168.1.18", 
      "quarantine": false, 
      "mac": "7f:5c:82:00:bf:5e", 
      "ipv6": false, 
      "networkName": "12241", 
      "id": 16234
    }, 
    {
      "available": true, 
      "name": "12245", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16235", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.19"
        }
      ], 
      "ip": "192.168.1.19", 
      "quarantine": false, 
      "mac": "a8:26:e5:db:ea:b2", 
      "ipv6": false, 
      "networkName": "12246", 
      "id": 16235
    }, 
    {
      "available": true, 
      "name": "12250", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16236", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.20"
        }
      ], 
      "ip": "192.168.1.20", 
      "quarantine": false, 
      "mac": "d4:68:72:b8:6f:bb", 
      "ipv6": false, 
      "networkName": "12251", 
      "id": 16236
    }, 
    {
      "available": true, 
      "name": "12255", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16237", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.21"
        }
      ], 
      "ip": "192.168.1.21", 
      "quarantine": false, 
      "mac": "c4:8c:bf:fe:d7:cd", 
      "ipv6": false, 
      "networkName": "12256", 
      "id": 16237
    }, 
    {
      "available": true, 
      "name": "12260", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16238", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.22"
        }
      ], 
      "ip": "192.168.1.22", 
      "quarantine": false, 
      "mac": "8a:ea:d1:03:13:05", 
      "ipv6": false, 
      "networkName": "12261", 
      "id": 16238
    }, 
    {
      "available": true, 
      "name": "12265", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16239", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.23"
        }
      ], 
      "ip": "192.168.1.23", 
      "quarantine": false, 
      "mac": "3a:27:a0:b9:68:3d", 
      "ipv6": false, 
      "networkName": "12266", 
      "id": 16239
    }, 
    {
      "available": true, 
      "name": "12270", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16240", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.24"
        }
      ], 
      "ip": "192.168.1.24", 
      "quarantine": false, 
      "mac": "e5:ca:4b:25:ef:a4", 
      "ipv6": false, 
      "networkName": "12271", 
      "id": 16240
    }, 
    {
      "available": true, 
      "name": "12275", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/4017/network/1608/ips/16241", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.25"
        }
      ], 
      "ip": "192.168.1.25", 
      "quarantine": false, 
      "mac": "89:45:bd:25:b6:fa", 
      "ipv6": false, 
      "networkName": "12276", 
      "id": 16241
    }
  ]
}

 

List IPs in an unmanaged network

Retrieves the list of IPs from an unmanaged VLAN.

Paging Method

This method works with paging. Check out Basic Behaviors for information about how it works

Synopsis: GET http://example.com/api/admin/datacenters/{datacenter}/network/{publicnetwork}/ips
Roles Required: PHYS_DC_RETRIEVE_DETAILS
Request Headers: Accept: application/vnd.abiquo.unmanagedips+json; version=4.4; application/vnd.abiquo.unmanagedips+xml; version=4.4;  Content-type: ;
Request Parameters:

Parameter

Required

Default Value

Description

startwith

false

0

First element to retrieve.

by

false

ip

How to order the search. Available values are: {IP, QUARANTINE, MAC, LEASE, VLAN,
VIRTUALDATACENTER, VIRTUALMACHINE, VIRTUALAPPLIANCE, ENTERPRISENAME}

has

false

 

a way to filter the search. It can be filtered by: IP address, MAC address,
network name, Virtual Machine name, Virtual Appliance name or Enterprise Name

limit

false

25

number of elements to retrieve.

asc

false

true

the way to order the search (ascendant-> true, descendant -> false). Ascendant by
default.

all

false

false

set if we should return all the IPs or only the available ones (by default).

 

 

 

 

Request Message Body Entity:
Response Message Body Entity: UnmanagedIps Media Type
Request Example:

 Click here to show or hide the request example

GET_adm_dcs_X_nw_X_ips_AC_unmgdips_j.0001.txt

cURL:

curl -X GET http://localhost:9000/api/admin/datacenters/3956/network/1553/ips \ 
	 -H 'Accept:application/vnd.abiquo.unmanagedips+json; version=4.2' \ 
	 -u user:password --verbose 

Success status code: 200

Request payload:

--none--

Response payload:

{
  "totalSize": 254, 
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips?limit=25&by=ip&asc=true", 
      "rel": "first"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips?startwith=25&limit=25&by=ip&asc=true", 
      "rel": "next"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips?startwith=229&limit=25&by=ip&asc=true", 
      "rel": "last"
    }
  ], 
  "collection": [
    {
      "available": true, 
      "name": "5436", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16689", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.1"
        }
      ], 
      "ip": "192.168.1.1", 
      "quarantine": false, 
      "mac": "72:17:fa:99:74:78", 
      "ipv6": false, 
      "networkName": "5437", 
      "id": 16689
    }, 
    {
      "available": true, 
      "name": "5441", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16690", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.2"
        }
      ], 
      "ip": "192.168.1.2", 
      "quarantine": false, 
      "mac": "9d:c1:9a:d9:23:49", 
      "ipv6": false, 
      "networkName": "5442", 
      "id": 16690
    }, 
    {
      "available": true, 
      "name": "5446", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16691", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.3"
        }
      ], 
      "ip": "192.168.1.3", 
      "quarantine": false, 
      "mac": "d1:11:57:02:cf:8a", 
      "ipv6": false, 
      "networkName": "5447", 
      "id": 16691
    }, 
    {
      "available": true, 
      "name": "5451", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16692", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.4"
        }
      ], 
      "ip": "192.168.1.4", 
      "quarantine": false, 
      "mac": "e1:68:15:85:8b:3b", 
      "ipv6": false, 
      "networkName": "5452", 
      "id": 16692
    }, 
    {
      "available": true, 
      "name": "5456", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16693", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.5"
        }
      ], 
      "ip": "192.168.1.5", 
      "quarantine": false, 
      "mac": "d0:47:72:97:19:90", 
      "ipv6": false, 
      "networkName": "5457", 
      "id": 16693
    }, 
    {
      "available": true, 
      "name": "5461", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16694", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.6"
        }
      ], 
      "ip": "192.168.1.6", 
      "quarantine": false, 
      "mac": "7b:61:16:de:ae:eb", 
      "ipv6": false, 
      "networkName": "5462", 
      "id": 16694
    }, 
    {
      "available": true, 
      "name": "5466", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16695", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.7"
        }
      ], 
      "ip": "192.168.1.7", 
      "quarantine": false, 
      "mac": "00:2d:79:5a:7b:90", 
      "ipv6": false, 
      "networkName": "5467", 
      "id": 16695
    }, 
    {
      "available": true, 
      "name": "5471", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16696", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.8"
        }
      ], 
      "ip": "192.168.1.8", 
      "quarantine": false, 
      "mac": "ef:7f:5b:85:e3:d8", 
      "ipv6": false, 
      "networkName": "5472", 
      "id": 16696
    }, 
    {
      "available": true, 
      "name": "5476", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16697", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.9"
        }
      ], 
      "ip": "192.168.1.9", 
      "quarantine": false, 
      "mac": "25:38:a3:8f:d3:79", 
      "ipv6": false, 
      "networkName": "5477", 
      "id": 16697
    }, 
    {
      "available": true, 
      "name": "5481", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16698", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.10"
        }
      ], 
      "ip": "192.168.1.10", 
      "quarantine": false, 
      "mac": "08:26:2f:54:c9:80", 
      "ipv6": false, 
      "networkName": "5482", 
      "id": 16698
    }, 
    {
      "available": true, 
      "name": "5486", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16699", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.11"
        }
      ], 
      "ip": "192.168.1.11", 
      "quarantine": false, 
      "mac": "ce:4a:d3:3e:af:27", 
      "ipv6": false, 
      "networkName": "5487", 
      "id": 16699
    }, 
    {
      "available": true, 
      "name": "5491", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16700", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.12"
        }
      ], 
      "ip": "192.168.1.12", 
      "quarantine": false, 
      "mac": "ab:16:c7:63:f3:af", 
      "ipv6": false, 
      "networkName": "5492", 
      "id": 16700
    }, 
    {
      "available": true, 
      "name": "5496", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16701", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.13"
        }
      ], 
      "ip": "192.168.1.13", 
      "quarantine": false, 
      "mac": "71:52:9f:7a:fc:c2", 
      "ipv6": false, 
      "networkName": "5497", 
      "id": 16701
    }, 
    {
      "available": true, 
      "name": "5501", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16702", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.14"
        }
      ], 
      "ip": "192.168.1.14", 
      "quarantine": false, 
      "mac": "a4:4b:b3:37:18:86", 
      "ipv6": false, 
      "networkName": "5502", 
      "id": 16702
    }, 
    {
      "available": true, 
      "name": "5506", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16703", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.15"
        }
      ], 
      "ip": "192.168.1.15", 
      "quarantine": false, 
      "mac": "34:da:6d:b3:33:7a", 
      "ipv6": false, 
      "networkName": "5507", 
      "id": 16703
    }, 
    {
      "available": true, 
      "name": "5511", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16704", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.16"
        }
      ], 
      "ip": "192.168.1.16", 
      "quarantine": false, 
      "mac": "31:f8:46:1c:f6:c9", 
      "ipv6": false, 
      "networkName": "5512", 
      "id": 16704
    }, 
    {
      "available": true, 
      "name": "5516", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16705", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.17"
        }
      ], 
      "ip": "192.168.1.17", 
      "quarantine": false, 
      "mac": "21:17:2b:83:a6:a2", 
      "ipv6": false, 
      "networkName": "5517", 
      "id": 16705
    }, 
    {
      "available": true, 
      "name": "5521", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16706", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.18"
        }
      ], 
      "ip": "192.168.1.18", 
      "quarantine": false, 
      "mac": "94:1d:17:d6:39:56", 
      "ipv6": false, 
      "networkName": "5522", 
      "id": 16706
    }, 
    {
      "available": true, 
      "name": "5526", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16707", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.19"
        }
      ], 
      "ip": "192.168.1.19", 
      "quarantine": false, 
      "mac": "f0:9a:ea:2c:e9:82", 
      "ipv6": false, 
      "networkName": "5527", 
      "id": 16707
    }, 
    {
      "available": true, 
      "name": "5531", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16708", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.20"
        }
      ], 
      "ip": "192.168.1.20", 
      "quarantine": false, 
      "mac": "4f:06:f5:ce:8d:a8", 
      "ipv6": false, 
      "networkName": "5532", 
      "id": 16708
    }, 
    {
      "available": true, 
      "name": "5536", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16709", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.21"
        }
      ], 
      "ip": "192.168.1.21", 
      "quarantine": false, 
      "mac": "59:eb:8e:c1:ab:7a", 
      "ipv6": false, 
      "networkName": "5537", 
      "id": 16709
    }, 
    {
      "available": true, 
      "name": "5541", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16710", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.22"
        }
      ], 
      "ip": "192.168.1.22", 
      "quarantine": false, 
      "mac": "77:e9:5e:d2:f4:54", 
      "ipv6": false, 
      "networkName": "5542", 
      "id": 16710
    }, 
    {
      "available": true, 
      "name": "5546", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16711", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.23"
        }
      ], 
      "ip": "192.168.1.23", 
      "quarantine": false, 
      "mac": "25:6c:14:5f:bf:9f", 
      "ipv6": false, 
      "networkName": "5547", 
      "id": 16711
    }, 
    {
      "available": true, 
      "name": "5551", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16712", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.24"
        }
      ], 
      "ip": "192.168.1.24", 
      "quarantine": false, 
      "mac": "f6:61:ff:bd:5e:d6", 
      "ipv6": false, 
      "networkName": "5552", 
      "id": 16712
    }, 
    {
      "available": true, 
      "name": "5556", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "unmanagednetwork", 
          "title": "unm_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3956/network/1553/ips/16713", 
          "type": "application/vnd.abiquo.unmanagedip+json", 
          "rel": "self", 
          "title": "192.168.1.25"
        }
      ], 
      "ip": "192.168.1.25", 
      "quarantine": false, 
      "mac": "6f:72:90:45:e7:cc", 
      "ipv6": false, 
      "networkName": "5557", 
      "id": 16713
    }
  ]
}

Update multiple IPs in an external network

Update a list of IPs from an external VLAN. Only 'available' and 'quarantine' attributes will be taken into account.

Synopsis: PUT http://example.com/api/admin/datacenters/{datacenter}/network/{publicnetwork}/ips
Roles Required: PHYS_DC_ALLOW_MODIFY_NETWORK
Request Headers: Accept: ; Content-type: application/vnd.abiquo.externalips+json; version=4.4; application/vnd.abiquo.externalips+xml; version=4.4; ;
Request Parameters:

Parameter

Required

Default Value

Description

 

 

 

 

Request Message Body Entity: ExternalIps Media Type
Response Message Body Entity:
Request Example:

 Click here to show or hide the request example

PUT_adm_dcs_X_nw_X_ips_CT_extips_j_lmt.0001.txt

cURL:

curl -X PUT http://localhost:9000/api/admin/datacenters/3962/network/1559/ips?limit=25 \ 
	 -H 'Accept:application/vnd.abiquo.externalips+json; version=4.2' \ 
	 -H 'Content-Type:application/vnd.abiquo.externalips+json; version=4.2' \ 
	 -d @requestpayload.json \ 
	 -u user:password --verbose 

Success status code: 204

Request payload:

{
  "totalSize": 254, 
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips?limit=25&by=ip&asc=true", 
      "rel": "first"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips?startwith=25&limit=25&by=ip&asc=true", 
      "rel": "next"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips?startwith=229&limit=25&by=ip&asc=true", 
      "rel": "last"
    }
  ], 
  "collection": [
    {
      "available": true, 
      "name": "10767", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17706", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.1"
        }
      ], 
      "ip": "192.168.1.1", 
      "quarantine": true, 
      "mac": "68:20:ad:10:c7:40", 
      "ipv6": false, 
      "networkName": "10768", 
      "id": 17706
    }, 
    {
      "available": true, 
      "name": "10772", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17707", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.2"
        }
      ], 
      "ip": "192.168.1.2", 
      "quarantine": true, 
      "mac": "be:3e:4f:17:fd:5f", 
      "ipv6": false, 
      "networkName": "10773", 
      "id": 17707
    }, 
    {
      "available": true, 
      "name": "10777", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17708", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.3"
        }
      ], 
      "ip": "192.168.1.3", 
      "quarantine": true, 
      "mac": "a9:74:29:9e:8f:7a", 
      "ipv6": false, 
      "networkName": "10778", 
      "id": 17708
    }, 
    {
      "available": true, 
      "name": "10782", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17709", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.4"
        }
      ], 
      "ip": "192.168.1.4", 
      "quarantine": true, 
      "mac": "22:c6:b0:6a:3b:ce", 
      "ipv6": false, 
      "networkName": "10783", 
      "id": 17709
    }, 
    {
      "available": true, 
      "name": "10787", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17710", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.5"
        }
      ], 
      "ip": "192.168.1.5", 
      "quarantine": true, 
      "mac": "3f:ac:8a:86:86:1b", 
      "ipv6": false, 
      "networkName": "10788", 
      "id": 17710
    }, 
    {
      "available": true, 
      "name": "10792", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17711", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.6"
        }
      ], 
      "ip": "192.168.1.6", 
      "quarantine": true, 
      "mac": "68:d1:88:ac:ba:4c", 
      "ipv6": false, 
      "networkName": "10793", 
      "id": 17711
    }, 
    {
      "available": true, 
      "name": "10797", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17712", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.7"
        }
      ], 
      "ip": "192.168.1.7", 
      "quarantine": true, 
      "mac": "42:6f:e6:fc:53:a3", 
      "ipv6": false, 
      "networkName": "10798", 
      "id": 17712
    }, 
    {
      "available": true, 
      "name": "10802", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17713", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.8"
        }
      ], 
      "ip": "192.168.1.8", 
      "quarantine": true, 
      "mac": "6d:1f:cd:2e:0a:a8", 
      "ipv6": false, 
      "networkName": "10803", 
      "id": 17713
    }, 
    {
      "available": true, 
      "name": "10807", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17714", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.9"
        }
      ], 
      "ip": "192.168.1.9", 
      "quarantine": true, 
      "mac": "3d:b6:28:42:6f:f0", 
      "ipv6": false, 
      "networkName": "10808", 
      "id": 17714
    }, 
    {
      "available": true, 
      "name": "10812", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17715", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.10"
        }
      ], 
      "ip": "192.168.1.10", 
      "quarantine": true, 
      "mac": "e1:d7:68:8a:ac:07", 
      "ipv6": false, 
      "networkName": "10813", 
      "id": 17715
    }, 
    {
      "available": true, 
      "name": "10817", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17716", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.11"
        }
      ], 
      "ip": "192.168.1.11", 
      "quarantine": true, 
      "mac": "73:8f:e3:a3:cb:80", 
      "ipv6": false, 
      "networkName": "10818", 
      "id": 17716
    }, 
    {
      "available": true, 
      "name": "10822", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17717", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.12"
        }
      ], 
      "ip": "192.168.1.12", 
      "quarantine": true, 
      "mac": "d9:a1:1c:2e:b8:ee", 
      "ipv6": false, 
      "networkName": "10823", 
      "id": 17717
    }, 
    {
      "available": true, 
      "name": "10827", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17718", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.13"
        }
      ], 
      "ip": "192.168.1.13", 
      "quarantine": true, 
      "mac": "85:8e:f7:e6:0a:5f", 
      "ipv6": false, 
      "networkName": "10828", 
      "id": 17718
    }, 
    {
      "available": true, 
      "name": "10832", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17719", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.14"
        }
      ], 
      "ip": "192.168.1.14", 
      "quarantine": true, 
      "mac": "4d:f5:78:de:77:2c", 
      "ipv6": false, 
      "networkName": "10833", 
      "id": 17719
    }, 
    {
      "available": true, 
      "name": "10837", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17720", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.15"
        }
      ], 
      "ip": "192.168.1.15", 
      "quarantine": true, 
      "mac": "69:16:6d:69:0d:d7", 
      "ipv6": false, 
      "networkName": "10838", 
      "id": 17720
    }, 
    {
      "available": true, 
      "name": "10842", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17721", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.16"
        }
      ], 
      "ip": "192.168.1.16", 
      "quarantine": true, 
      "mac": "6c:e4:b6:38:07:fd", 
      "ipv6": false, 
      "networkName": "10843", 
      "id": 17721
    }, 
    {
      "available": true, 
      "name": "10847", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17722", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.17"
        }
      ], 
      "ip": "192.168.1.17", 
      "quarantine": true, 
      "mac": "f2:dd:64:8f:da:b8", 
      "ipv6": false, 
      "networkName": "10848", 
      "id": 17722
    }, 
    {
      "available": true, 
      "name": "10852", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17723", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.18"
        }
      ], 
      "ip": "192.168.1.18", 
      "quarantine": true, 
      "mac": "4e:91:7d:aa:75:c9", 
      "ipv6": false, 
      "networkName": "10853", 
      "id": 17723
    }, 
    {
      "available": true, 
      "name": "10857", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17724", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.19"
        }
      ], 
      "ip": "192.168.1.19", 
      "quarantine": true, 
      "mac": "79:fb:03:3a:63:ec", 
      "ipv6": false, 
      "networkName": "10858", 
      "id": 17724
    }, 
    {
      "available": true, 
      "name": "10862", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17725", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.20"
        }
      ], 
      "ip": "192.168.1.20", 
      "quarantine": true, 
      "mac": "f1:53:ab:a4:ea:dc", 
      "ipv6": false, 
      "networkName": "10863", 
      "id": 17725
    }, 
    {
      "available": true, 
      "name": "10867", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17726", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.21"
        }
      ], 
      "ip": "192.168.1.21", 
      "quarantine": true, 
      "mac": "2d:7a:22:1b:01:c5", 
      "ipv6": false, 
      "networkName": "10868", 
      "id": 17726
    }, 
    {
      "available": true, 
      "name": "10872", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17727", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.22"
        }
      ], 
      "ip": "192.168.1.22", 
      "quarantine": true, 
      "mac": "19:99:46:50:e6:7e", 
      "ipv6": false, 
      "networkName": "10873", 
      "id": 17727
    }, 
    {
      "available": true, 
      "name": "10877", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17728", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.23"
        }
      ], 
      "ip": "192.168.1.23", 
      "quarantine": true, 
      "mac": "02:56:fa:61:ec:08", 
      "ipv6": false, 
      "networkName": "10878", 
      "id": 17728
    }, 
    {
      "available": true, 
      "name": "10882", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17729", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.24"
        }
      ], 
      "ip": "192.168.1.24", 
      "quarantine": true, 
      "mac": "0d:4a:83:29:03:8d", 
      "ipv6": false, 
      "networkName": "10883", 
      "id": 17729
    }, 
    {
      "available": true, 
      "name": "10887", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "ext_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/enterprises/4582", 
          "type": "application/vnd.abiquo.enterprise+json", 
          "rel": "enterprise", 
          "title": "10726"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3962/network/1559/ips/17730", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "192.168.1.25"
        }
      ], 
      "ip": "192.168.1.25", 
      "quarantine": true, 
      "mac": "65:52:70:75:3c:80", 
      "ipv6": false, 
      "networkName": "10888", 
      "id": 17730
    }
  ]
}

Response payload:

--none--

 

Update multiple IPs in a public network

Update a list of IPs from a public VLAN. Only 'available' and 'quarantine' attributes will be taken into account.

Synopsis: PUT http://example.com/api/admin/datacenters/{datacenter}/network/{publicnetwork}/ips
Roles Required: PHYS_DC_ALLOW_MODIFY_NETWORK
Request Headers: Accept: ; Content-type:  application/vnd.abiquo.publicips+json; version=4.4; application/vnd.abiquo.publicips+xml; version=4.4;
Request Parameters:

Parameter

Required

Default Value

Description

 

 

 

 

Request Message Body Entity: PublicIps Media Type
Response Message Body Entity:
Request Example:

 Click here to show or hide the request example

PUT_adm_dcs_X_nw_X_ips_CT_pubips_j_lmt.0001.txt

cURL:

curl -X PUT http://localhost:9000/api/admin/datacenters/3963/network/1560/ips?limit=25 \ 
	 -H 'Accept:application/vnd.abiquo.publicips+json; version=4.2' \ 
	 -H 'Content-Type:application/vnd.abiquo.publicips+json; version=4.2' \ 
	 -d @requestpayload.json \ 
	 -u user:password --verbose 

Success status code: 204

Request payload:

{
  "totalSize": 254, 
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips?limit=25&by=ip&asc=true", 
      "rel": "first"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips?startwith=25&limit=25&by=ip&asc=true", 
      "rel": "next"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips?startwith=229&limit=25&by=ip&asc=true", 
      "rel": "last"
    }
  ], 
  "collection": [
    {
      "available": true, 
      "name": "12078", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17960", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.1"
        }
      ], 
      "ip": "192.168.1.1", 
      "quarantine": true, 
      "mac": "74:0a:c5:39:fa:bc", 
      "ipv6": false, 
      "networkName": "12079", 
      "id": 17960
    }, 
    {
      "available": true, 
      "name": "12083", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17961", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.2"
        }
      ], 
      "ip": "192.168.1.2", 
      "quarantine": true, 
      "mac": "d9:d0:41:1a:7d:6e", 
      "ipv6": false, 
      "networkName": "12084", 
      "id": 17961
    }, 
    {
      "available": true, 
      "name": "12088", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17962", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.3"
        }
      ], 
      "ip": "192.168.1.3", 
      "quarantine": true, 
      "mac": "aa:54:14:9e:d3:e5", 
      "ipv6": false, 
      "networkName": "12089", 
      "id": 17962
    }, 
    {
      "available": true, 
      "name": "12093", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17963", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.4"
        }
      ], 
      "ip": "192.168.1.4", 
      "quarantine": true, 
      "mac": "20:c3:6f:19:80:eb", 
      "ipv6": false, 
      "networkName": "12094", 
      "id": 17963
    }, 
    {
      "available": true, 
      "name": "12098", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17964", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.5"
        }
      ], 
      "ip": "192.168.1.5", 
      "quarantine": true, 
      "mac": "0b:9f:4b:b1:dd:a6", 
      "ipv6": false, 
      "networkName": "12099", 
      "id": 17964
    }, 
    {
      "available": true, 
      "name": "12103", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17965", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.6"
        }
      ], 
      "ip": "192.168.1.6", 
      "quarantine": true, 
      "mac": "3c:7a:b7:bc:e5:cc", 
      "ipv6": false, 
      "networkName": "12104", 
      "id": 17965
    }, 
    {
      "available": true, 
      "name": "12108", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17966", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.7"
        }
      ], 
      "ip": "192.168.1.7", 
      "quarantine": true, 
      "mac": "94:6e:5d:48:4f:52", 
      "ipv6": false, 
      "networkName": "12109", 
      "id": 17966
    }, 
    {
      "available": true, 
      "name": "12113", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17967", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.8"
        }
      ], 
      "ip": "192.168.1.8", 
      "quarantine": true, 
      "mac": "3f:23:90:ac:6b:57", 
      "ipv6": false, 
      "networkName": "12114", 
      "id": 17967
    }, 
    {
      "available": true, 
      "name": "12118", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17968", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.9"
        }
      ], 
      "ip": "192.168.1.9", 
      "quarantine": true, 
      "mac": "eb:0a:33:ac:e6:91", 
      "ipv6": false, 
      "networkName": "12119", 
      "id": 17968
    }, 
    {
      "available": true, 
      "name": "12123", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17969", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.10"
        }
      ], 
      "ip": "192.168.1.10", 
      "quarantine": true, 
      "mac": "ec:4b:2c:45:54:a7", 
      "ipv6": false, 
      "networkName": "12124", 
      "id": 17969
    }, 
    {
      "available": true, 
      "name": "12128", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17970", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.11"
        }
      ], 
      "ip": "192.168.1.11", 
      "quarantine": true, 
      "mac": "63:05:41:7a:ca:ce", 
      "ipv6": false, 
      "networkName": "12129", 
      "id": 17970
    }, 
    {
      "available": true, 
      "name": "12133", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17971", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.12"
        }
      ], 
      "ip": "192.168.1.12", 
      "quarantine": true, 
      "mac": "3d:4f:97:09:4f:30", 
      "ipv6": false, 
      "networkName": "12134", 
      "id": 17971
    }, 
    {
      "available": true, 
      "name": "12138", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17972", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.13"
        }
      ], 
      "ip": "192.168.1.13", 
      "quarantine": true, 
      "mac": "f4:5d:2c:a6:b5:11", 
      "ipv6": false, 
      "networkName": "12139", 
      "id": 17972
    }, 
    {
      "available": true, 
      "name": "12143", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17973", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.14"
        }
      ], 
      "ip": "192.168.1.14", 
      "quarantine": true, 
      "mac": "15:be:17:17:5c:c0", 
      "ipv6": false, 
      "networkName": "12144", 
      "id": 17973
    }, 
    {
      "available": true, 
      "name": "12148", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17974", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.15"
        }
      ], 
      "ip": "192.168.1.15", 
      "quarantine": true, 
      "mac": "23:be:20:7c:4c:6f", 
      "ipv6": false, 
      "networkName": "12149", 
      "id": 17974
    }, 
    {
      "available": true, 
      "name": "12153", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17975", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.16"
        }
      ], 
      "ip": "192.168.1.16", 
      "quarantine": true, 
      "mac": "bf:25:af:2e:8a:60", 
      "ipv6": false, 
      "networkName": "12154", 
      "id": 17975
    }, 
    {
      "available": true, 
      "name": "12158", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17976", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.17"
        }
      ], 
      "ip": "192.168.1.17", 
      "quarantine": true, 
      "mac": "ee:26:23:7d:82:70", 
      "ipv6": false, 
      "networkName": "12159", 
      "id": 17976
    }, 
    {
      "available": true, 
      "name": "12163", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17977", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.18"
        }
      ], 
      "ip": "192.168.1.18", 
      "quarantine": true, 
      "mac": "66:c9:67:51:35:6f", 
      "ipv6": false, 
      "networkName": "12164", 
      "id": 17977
    }, 
    {
      "available": true, 
      "name": "12168", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17978", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.19"
        }
      ], 
      "ip": "192.168.1.19", 
      "quarantine": true, 
      "mac": "4e:7f:53:d8:cc:86", 
      "ipv6": false, 
      "networkName": "12169", 
      "id": 17978
    }, 
    {
      "available": true, 
      "name": "12173", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17979", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.20"
        }
      ], 
      "ip": "192.168.1.20", 
      "quarantine": true, 
      "mac": "2a:b0:10:b7:97:27", 
      "ipv6": false, 
      "networkName": "12174", 
      "id": 17979
    }, 
    {
      "available": true, 
      "name": "12178", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17980", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.21"
        }
      ], 
      "ip": "192.168.1.21", 
      "quarantine": true, 
      "mac": "bb:8e:fb:4f:34:a0", 
      "ipv6": false, 
      "networkName": "12179", 
      "id": 17980
    }, 
    {
      "available": true, 
      "name": "12183", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17981", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.22"
        }
      ], 
      "ip": "192.168.1.22", 
      "quarantine": true, 
      "mac": "9d:eb:21:11:86:8f", 
      "ipv6": false, 
      "networkName": "12184", 
      "id": 17981
    }, 
    {
      "available": true, 
      "name": "12188", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17982", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.23"
        }
      ], 
      "ip": "192.168.1.23", 
      "quarantine": true, 
      "mac": "ea:d3:99:d6:68:a8", 
      "ipv6": false, 
      "networkName": "12189", 
      "id": 17982
    }, 
    {
      "available": true, 
      "name": "12193", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17983", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.24"
        }
      ], 
      "ip": "192.168.1.24", 
      "quarantine": true, 
      "mac": "05:0e:68:9f:2c:fa", 
      "ipv6": false, 
      "networkName": "12194", 
      "id": 17983
    }, 
    {
      "available": true, 
      "name": "12198", 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "publicnetwork", 
          "title": "pub_vlan"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/3963/network/1560/ips/17984", 
          "type": "application/vnd.abiquo.publicip+json", 
          "rel": "self", 
          "title": "192.168.1.25"
        }
      ], 
      "ip": "192.168.1.25", 
      "quarantine": true, 
      "mac": "32:9a:fa:cf:ba:bb", 
      "ipv6": false, 
      "networkName": "12199", 
      "id": 17984
    }
  ]
}

Response payload:

--none--

 

Get an IP from a public network

Return a single public IP.

Synopsis: GET http://example.com/api/admin/datacenters/{datacenter}/network/{publicnetwork}/ips/{ip}
Roles Required: PHYS_DC_RETRIEVE_DETAILS
Request Headers: Accept: application/vnd.abiquo.publicip+json; version=4.4; application/vnd.abiquo.publicip+xml; version=4.4;  Content-type: ;
Request Parameters:

Parameter

Required

Default Value

Description

 

 

 

 

Request Message Body Entity:
Response Message Body Entity: PublicIp Media Type
Request Example:

 Click here to show or hide the request example

GET_adm_dcs_X_nw_X_ips_X_AC_pubip_j.0001.txt

cURL:

curl -X GET http://localhost:9000/api/admin/datacenters/3899/network/1508/ips/16100 \ 
	 -H 'Accept:application/vnd.abiquo.publicip+json; version=4.2' \ 
	 -u user:password --verbose 

Success status code: 200

Request payload:

--none--

Response payload:

{
  "available": true, 
  "name": "528", 
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/3899/network/1508", 
      "type": "application/vnd.abiquo.vlan+json", 
      "rel": "publicnetwork", 
      "title": "527"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/3899/network/1508/ips/16100", 
      "type": "application/vnd.abiquo.publicip+json", 
      "rel": "self", 
      "title": "0.0.0.0"
    }
  ], 
  "ip": "0.0.0.0", 
  "quarantine": false, 
  "mac": "67:9f:e5:e2:ab:7e", 
  "ipv6": false, 
  "networkName": "527", 
  "id": 16100
}

Get an IP from an external network

Return a single external IP.

Synopsis: GET http://example.com/api/admin/datacenters/{datacenter}/network/{publicnetwork}/ips/{ip}
Roles Required: PHYS_DC_RETRIEVE_DETAILS
Request Headers: Accept: application/vnd.abiquo.externalip+json; version=4.4; application/vnd.abiquo.externalip+xml; version=4.4;  Content-type: ;
Request Parameters:

Parameter

Required

Default Value

Description

 

 

 

 

Request Message Body Entity:
Response Message Body Entity: ExternalIp Media Type
Request Example:

 Click here to show or hide the request example

GET_adm_dcs_X_nw_X_ips_X_AC_extip_j.0001.txt

cURL:

curl -X GET http://localhost:9000/api/admin/datacenters/3887/network/1500/ips/16094 \ 
	 -H 'Accept:application/vnd.abiquo.externalip+json; version=4.2' \ 
	 -u user:password --verbose 

Success status code: 200

Request payload:

--none--

Response payload:

{
  "available": true, 
  "name": "136", 
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/3887/network/1500", 
      "type": "application/vnd.abiquo.vlan+json", 
      "rel": "externalnetwork", 
      "title": "135"
    }, 
    {
      "href": "http://localhost:9009/api/admin/enterprises/4510", 
      "type": "application/vnd.abiquo.enterprise+json", 
      "rel": "enterprise", 
      "title": "127"
    }, 
    {
      "href": "http://localhost:9009/api/admin/enterprises/4510", 
      "type": "application/vnd.abiquo.enterprise+json", 
      "rel": "enterprise", 
      "title": "127"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/3887/network/1500/ips/16094", 
      "type": "application/vnd.abiquo.externalip+json", 
      "rel": "self", 
      "title": "0.0.0.0"
    }, 
    {
      "href": "http://localhost:9009/api/cloud/virtualdatacenters/2582", 
      "type": "application/vnd.abiquo.virtualdatacenter+json", 
      "rel": "virtualdatacenter", 
      "title": "131"
    }
  ], 
  "ip": "0.0.0.0", 
  "quarantine": false, 
  "mac": "f5:84:5b:d3:d3:37", 
  "ipv6": false, 
  "networkName": "135", 
  "id": 16094
}

Get an IP from an unmanaged network

Return a single unmanaged IP.

Synopsis: GET http://example.com/api/admin/datacenters/{datacenter}/network/{publicnetwork}/ips/{ip}
Roles Required: PHYS_DC_RETRIEVE_DETAILS
Request Headers: Accept: application/vnd.abiquo.unmanagedip+json; version=4.4; application/vnd.abiquo.unmanagedip+xml; version=4.4;  Content-type: ;
Request Parameters:

Parameter

Required

Default Value

Description

 

 

 

 

Request Message Body Entity:
Response Message Body Entity: UnmanagedIp Media Type
Request Example:

 Click here to show or hide the request example

GET_adm_dcs_X_nw_X_ips_X_AC_unmgdip_j.0001.txt

cURL:

curl -X GET http://localhost:9000/api/admin/datacenters/3957/network/1554/ips/16943 \ 
	 -H 'Accept:application/vnd.abiquo.unmanagedip+json; version=4.2' \ 
	 -u user:password --verbose 

Success status code: 200

Request payload:

--none--

Response payload:

{
  "available": true, 
  "name": "6747", 
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/3957/network/1554", 
      "type": "application/vnd.abiquo.vlan+json", 
      "rel": "unmanagednetwork", 
      "title": "unm_vlan"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/3957/network/1554/ips/16943", 
      "type": "application/vnd.abiquo.unmanagedip+json", 
      "rel": "self", 
      "title": "192.168.1.1"
    }
  ], 
  "ip": "192.168.1.1", 
  "quarantine": false, 
  "mac": "17:4a:83:4a:d4:74", 
  "ipv6": false, 
  "networkName": "6748", 
  "id": 16943
}

Update an IP in an external network

Update an external IP, which means to set or unset its 'quarantine' and 'available' parameters.

Synopsis: PUT http://example.com/api/admin/datacenters/{datacenter}/network/{publicnetwork}/ips/{ip}
Roles Required: PHYS_DC_ALLOW_MODIFY_NETWORK
Request Headers: Accept: application/vnd.abiquo.externalip+json; version=4.4; application/vnd.abiquo.externalip+xml; version=4.4;  Content-type:  application/vnd.abiquo.externalip+json; version=4.4; application/vnd.abiquo.externalip+xml; version=4.4;
Request Parameters:

Parameter

Required

Default Value

Description

 

 

 

 

Request Message Body Entity: ExternalIp Media Type
Response Message Body Entity: ExternalIp Media Type
Request Example:

 Click here to show or hide the request example

PUT_adm_dcs_X_nw_X_ips_X_CT_extip_j_AC_extip_j.0001.txt

cURL:

curl -X PUT http://localhost:9000/api/admin/datacenters/3769/network/1389/ips/16074 \ 
	 -H 'Accept:application/vnd.abiquo.externalip+json; version=4.2' \ 
	 -H 'Content-Type:application/vnd.abiquo.externalip+json; version=4.2' \ 
	 -d @requestpayload.json \ 
	 -u user:password --verbose 

Success status code: 200

Request payload:

{
  "available": true, 
  "name": "1397", 
  "links": [
    {
      "href": "http://localhost:9009/api/admin/enterprises/4413/limits/3037/externalnetworks/1389", 
      "type": "application/vnd.abiquo.vlan+json", 
      "rel": "externalnetwork", 
      "title": "1390"
    }, 
    {
      "href": "http://localhost:9009/api/admin/enterprises/4413/limits/3037/externalnetworks/1389/ips", 
      "type": "application/vnd.abiquo.externalips+json", 
      "rel": "ips", 
      "title": "ips"
    }, 
    {
      "href": "http://localhost:9009/api/admin/enterprises/4413/limits/3037/externalnetworks/1389/ips/16074", 
      "type": "application/vnd.abiquo.externalip+json", 
      "rel": "self", 
      "title": "192.168.1.1"
    }
  ], 
  "ip": "192.168.1.1", 
  "quarantine": true, 
  "mac": "03:2c:43:f3:95:0c", 
  "ipv6": false, 
  "networkName": "1390", 
  "id": 16074
}

Response payload:

{
  "available": true, 
  "name": "1397", 
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/3769/network/1389", 
      "type": "application/vnd.abiquo.vlan+json", 
      "rel": "externalnetwork", 
      "title": "1390"
    }, 
    {
      "href": "http://localhost:9009/api/admin/enterprises/4413", 
      "type": "application/vnd.abiquo.enterprise+json", 
      "rel": "enterprise", 
      "title": "1382"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/3769/network/1389/ips/16074", 
      "type": "application/vnd.abiquo.externalip+json", 
      "rel": "self", 
      "title": "192.168.1.1"
    }
  ], 
  "ip": "192.168.1.1", 
  "quarantine": true, 
  "mac": "03:2c:43:f3:95:0c", 
  "ipv6": false, 
  "networkName": "1390", 
  "id": 16074
}

 

Update an IP in a public network

Update a public IP, which means to set or unset its 'quarantine' and 'available' parameters.

Synopsis: PUT http://example.com/api/admin/datacenters/{datacenter}/network/{publicnetwork}/ips/{ip}
Roles Required: PHYS_DC_ALLOW_MODIFY_NETWORK
Request Headers: Accept: application/vnd.abiquo.publicip+json; version=4.4; application/vnd.abiquo.publicip+xml; version=4.4;  Content-type:  application/vnd.abiquo.publicip+json; version=4.4; application/vnd.abiquo.publicip+xml; version=4.4;
Request Parameters:

Parameter

Required

Default Value

Description

 

 

 

 

Request Message Body Entity: PublicIp Media Type
Response Message Body Entity: PublicIp Media Type
Request Example:

 Click here to show or hide the request example

PUT_adm_dcs_X_nw_X_ips_X_CT_pubip_j_AC_pubip_j.0001.txt

cURL:

curl -X PUT http://localhost:9000/api/admin/datacenters/3899/network/1508/ips/16100 \ 
	 -H 'Accept:application/vnd.abiquo.publicip+json; version=4.2' \ 
	 -H 'Content-Type:application/vnd.abiquo.publicip+json; version=4.2' \ 
	 -d @requestpayload.json \ 
	 -u user:password --verbose 

Success status code: 200

Request payload:

{
  "available": true, 
  "name": "528", 
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/3899/network/1508", 
      "type": "application/vnd.abiquo.vlan+json", 
      "rel": "publicnetwork", 
      "title": "527"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/3899/network/1508/ips/16100", 
      "type": "application/vnd.abiquo.publicip+json", 
      "rel": "self", 
      "title": "0.0.0.0"
    }
  ], 
  "ip": "0.0.0.0", 
  "quarantine": false, 
  "mac": "67:9f:e5:e2:ab:7e", 
  "ipv6": false, 
  "networkName": "527", 
  "id": 16100
}

Response payload:

{
  "available": true, 
  "name": "528", 
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/3899/network/1508", 
      "type": "application/vnd.abiquo.vlan+json", 
      "rel": "publicnetwork", 
      "title": "527"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/3899/network/1508/ips/16100", 
      "type": "application/vnd.abiquo.publicip+json", 
      "rel": "self", 
      "title": "0.0.0.0"
    }
  ], 
  "ip": "0.0.0.0", 
  "quarantine": false, 
  "mac": "67:9f:e5:e2:ab:7e", 
  "ipv6": false, 
  "networkName": "527", 
  "id": 16100
}

 

Create an IP in a public or external network

Creates an IP address for a public or external network

Synopsis: POST http://example.com/api/admin/datacenters/{datacenter}/network/{publicnetwork}/ips
Roles Required: PHYS_DC_ALLOW_MODIFY_NETWORK
Request Headers: Accept:  application/vnd.abiquo.publicip+json; version=4.4; application/vnd.abiquo.publicip+xml; version=4.4;  Content-type:  application/vnd.abiquo.publicip+json; version=4.4; application/vnd.abiquo.publicip+xml; version=4.4;
Request Parameters:

Parameter

Required

Default Value

Description

 

 

 

 

Request Message Body Entity: PublicIp Media Type
Response Message Body Entity: PublicIp Media Type
Request Example:

 Click here to show or hide the request example

POST_adm_dcs_X_nw_X_ips_CT_pubip_j_AC_pubip_j.0001.txt

cURL:

curl -X POST http://localhost:9000/api/admin/datacenters/3885/network/1499/ips \ 
	 -H 'Accept:application/vnd.abiquo.publicip+json; version=4.2' \ 
	 -H 'Content-Type:application/vnd.abiquo.publicip+json; version=4.2' \ 
	 -d @requestpayload.json \ 
	 -u user:password --verbose 

Success status code: 201

Request payload:

{
  "available": false, 
  "ip": "192.168.1.159", 
  "quarantine": false, 
  "links": [], 
  "ipv6": false
}

Response payload:

{
  "available": false, 
  "links": [
    {
      "href": "http://localhost:9009/api/admin/datacenters/3885/network/1499", 
      "type": "application/vnd.abiquo.vlan+json", 
      "rel": "externalnetwork", 
      "title": "86"
    }, 
    {
      "href": "http://localhost:9009/api/admin/datacenters/3885/network/1499/ips/16093", 
      "type": "application/vnd.abiquo.externalip+json", 
      "rel": "self", 
      "title": "192.168.1.159"
    }
  ], 
  "ipv6": false, 
  "ip": "192.168.1.159", 
  "quarantine": false, 
  "networkName": "86", 
  "id": 16093
}


Create multiple IPs in a public or external network

Creates multiple IP addresses for a public or external network given a first IP and the number of IPs to create.

Synopsis: POST http://example.com/api/admin/datacenters/{datacenter}/network/{publicnetwork}/ips
Roles Required: PHYS_DC_ALLOW_MODIFY_NETWORK
Request Headers: Accept:  application/vnd.abiquo.publicips+json; version=4.4; application/vnd.abiquo.publicips+xml; version=4.4;  Content-type:  application/vnd.abiquo.ipsbulkcreation+json; version=4.4; application/vnd.abiquo.ipsbulkcreation+xml; version=4.4;
Request Parameters:

Parameter

Required

Default Value

Description

 

 

 

 

Request Message Body Entity: IpsBulkCreation Media Type
Response Message Body Entity: PublicIps Media Type
Request Example:

 Click here to show or hide the request example

POST_adm_dcs_X_nw_X_ips_CT_ipblkcre_j_AC_pubips_j.0001.txt

cURL:

curl -X POST http://localhost:9000/api/admin/datacenters/5126/network/2044/ips \ 
	 -H 'Accept:application/vnd.abiquo.publicips+json; version=4.2' \ 
	 -H 'Content-Type:application/vnd.abiquo.ipsbulkcreation+json; version=4.2' \ 
	 -d @requestpayload.json \ 
	 -u user:password --verbose 

Success status code: 201

Request payload:

{
  "available": true, 
  "numips": 4, 
  "links": [], 
  "ipv6": true, 
  "ip": "::ffff:0000:0002", 
  "quarantine": false
}

Response payload:

{
  "links": [], 
  "collection": [
    {
      "available": true, 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/5126/network/2044", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "191"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/5126/network/2044/ips/19755", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "::ffff:0.0.0.2"
        }
      ], 
      "ipv6": true, 
      "ip": "::ffff:0.0.0.2", 
      "quarantine": false, 
      "networkName": "191", 
      "id": 19755
    }, 
    {
      "available": true, 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/5126/network/2044", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "191"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/5126/network/2044/ips/19756", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "::ffff:0.0.0.3"
        }
      ], 
      "ipv6": true, 
      "ip": "::ffff:0.0.0.3", 
      "quarantine": false, 
      "networkName": "191", 
      "id": 19756
    }, 
    {
      "available": true, 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/5126/network/2044", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "191"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/5126/network/2044/ips/19757", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "::ffff:0.0.0.4"
        }
      ], 
      "ipv6": true, 
      "ip": "::ffff:0.0.0.4", 
      "quarantine": false, 
      "networkName": "191", 
      "id": 19757
    }, 
    {
      "available": true, 
      "links": [
        {
          "href": "http://localhost:9009/api/admin/datacenters/5126/network/2044", 
          "type": "application/vnd.abiquo.vlan+json", 
          "rel": "externalnetwork", 
          "title": "191"
        }, 
        {
          "href": "http://localhost:9009/api/admin/datacenters/5126/network/2044/ips/19758", 
          "type": "application/vnd.abiquo.externalip+json", 
          "rel": "self", 
          "title": "::ffff:0.0.0.5"
        }
      ], 
      "ipv6": true, 
      "ip": "::ffff:0.0.0.5", 
      "quarantine": false, 
      "networkName": "191", 
      "id": 19758
    }
  ]
}

 

Delete an IP from a public or external network

Delete a single IP from a datacenter network that is public or external (using the appropriate media type) such as publicip or externalip. You cannot delete an IP if it is in use.

Synopsis: DELETE http://example.com/api/admin/datacenters/{datacenter}/network/{publicnetwork}/ips/{ip} 
Roles Required: PHYS_DC_ALLOW_MODIFY_NETWORK
Request Headers: Accept:  application/vnd.abiquo.publicip+json; version=4.4; application/vnd.abiquo.publicip+xml; version=4.4;  Content-type: ;
Request Parameters:

Parameter

Required

Default Value

Description

 

 

 

 

Request Message Body Entity: 
Response Message Body Entity: PublicIp Media Type 
Request Example:

 Click here to show or hide the request example

DELETE_adm_dcs_X_nw_X_ips_X.0001.txt

cURL:

curl -X DELETE http://localhost:9000/api/admin/datacenters/3934/network/1535/ips/16120 \ 
	 -H 'Accept:text/json,application/json' \ 
	 -u user:password --verbose 

Success status code: 204

Request payload:

--none--

Response payload:

--none--