Description
Returns the object IDs for the next available (unused) blocks or networks within a configuration or block.
Parameters
Name | Description |
---|---|
count |
Location: query Type: integer (int32) The number of networks to be found.Note: If the number of networks count
is greater than 1:
Note: Starting in Address Manager API v9.2.0, this parameter is now required.
|
parentId |
Location: query Type: integer (int64) The object ID of the parent object under which the next available range resides configuration or block.Note: Starting in Address Manager API v9.2.0, this parameter is now required.
|
properties |
Location: query Type: string The string containing the following properties and values:
Note: If a value is not provided for the following parameters:
reuseExisting and autoCreate, the default values will be as follows:
reuseExisting = false and autoCreate = true.
|
size |
Location: query Type: integer (int64) The size of the range, expressed as a power of 2.Note: Starting in Address Manager API v9.2.0, this parameter is now required.
|
type |
Location: query Type: string The type of the range object to be fetched. Currently only IPv4 network is supported. |
Responses
Code | Description |
---|---|
200 |
Type: Array of APIEntity Returns consecutive matching IPv4 range object IDs. If the next available ranges do not exist and you have set the autoCreate property to true, new IPv4 ranges will be created and their object IDs will be returned. |