GET /api/subnets/:id/freeip
Provides an unused IP address in this subnet

Examples

GET /api/subnets/1018350796-subnet161/freeip
200
{
  "freeip": null,
  "errors": {}
}

Params

Param name Description
location_id
optional

Set the current location context for the request

Validations:

  • Must be a Integer
organization_id
optional

Set the current organization context for the request

Validations:

  • Must be a Integer
id
required

Validations:

  • Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space.
mac
optional

MAC address to reuse the IP for this host

Validations:

  • Must be a String
excluded_ips
optional

IP addresses that should be excluded from suggestion

Validations:

  • Must be an array of any type