GET /v1/getNextAvailableIPRange - BlueCat Address Manager - 9.3.0

Address Manager API Guide

prodname
BlueCat Address Manager
version_custom
9.3.0

Description

Returns the object ID for the next available (unused) block or network within a configuration or block.

Parameters

Name Description
parentId

Location: query

Type: integer (int64)

The object ID of the parent object under which the next available range resides configuration or block.
properties

Location: query

Type: string

The string containing the following properties and values:
  • reuseExistingTrue or False. This Boolean value indicates whether to search existing empty networks to find the available IP range of specified size.
  • isLargerAllowedTrue or False. This Boolean value indicates whether to return larger networks than those specified with the sizeparameter.
  • autoCreateTrue or False. This Boolean value indicates whether the next available IP range should be created in the parent object if it does not exist.
  • traversalMethod —This parameter identifies the appropriate search algorithm to find the suitable object. The possible values are:
    • TraversalMethodology.NO_TRAVERSAL NO_TRAVERSAL —will attempt to find the next range directly under the specified parent object. It will not search through to the lower level objects.
    • TraversalMethodology.DEPTH_FIRST DEPTH_FIRST —will attempt to find the next range under the specified object by iteratively through its children one by one. After exploring the object recursively for its child ranges, it will move to the next child object.
    • TraversalMethodology.BREADTH_FIRST BREADTH_FIRST —will attempt to find the next range under the specified object by iterative levels. It will first find the range immediately below the specified parent object. If not found, then it will attempt to find the range under all the first child objects.
size

Location: query

Type: integer (int64)

The size of the range, expressed as a power of 2.
type

Location: query

Type: string

The type of the range object to be fetched. Currently IPv4 block and network are supported.

Responses

Code Description
200

Type: APIEntity

Returns the object ID for the existing next available IPv4 range or, if the next available IP range does not exist and autoCreate was set to true, the newly created IPv4 range.