Add device instance - BlueCat Integrity - 9.5.0

Address Manager Legacy v1 API Guide

Locale
English
Product name
BlueCat Integrity
Version
9.5.0
Attention: The addDeviceInstance method is deprecated and will be removed after two subsequent major releases. This is due to the introduction of more efficient and stable API methods.

BlueCat recommends creating a new zone using the addZone API method with the dynamicUpdate property, or updating an existing zone using the update API method with the dynamicUpdate property to automatically deploy the newly added host records to the associated primary DNS/DHCP Server. Once configured, you can use the addHostRecord method to add a new host record that will then be automatically deployed to that zone.

Use addDeviceInstance to provision new devices for the network and to combine several API methods into one. This method assigns the next available, or manually defined, IP address and optionally adds a DNS host record and MAC address that are linked to the IP address. It returns the property string containing the IP address, netmask, and gateway. When configured with a DNS host record, addDeviceInstance updates the DNS server to immediately deploy the host record.

Important: To use this API call, you must configure the Allow Dynamic Updates DNS deployment option.
Note: Address Manager adds the DNS host record directly to the DNS/DHCP Server so that the individual host record is made live instantly. This is done through the Address Manager to DNS/DHCP Server communication service (Command Server) and does NOT require a standard Address Manager deployment.