POST /v1/assignIP4Address - BlueCat Address Manager - 9.3.0

hostname,viewId,reverseFlag,sameAsZoneFlag[,
hostname,viewId,reverseFlag,sameAsZoneFlag,...]

• hostname - The FQDN of the host record to be added.
• viewId - The object ID of the view under which this host should be created.
• reverseFlag - The flag indicating if a reverse record should be created. The possible values are true or false.
• sameAsZoneFlag - The flag indicating if record should be created as same as zone record. The possible values are true or false.

The comma-separated parameters may be repeated in the order shown above. The string must not end with a comma.

• ptrs —a string containing the list of unmanaged external host records to be associated with the IPv4 address in the format:

  viewId,exHostFQDN[, viewId,exHostFQDN,...]

  You can assign External Host records to an IPv4 address using the following method:

  EntityProperties props = new EntityProperties;
  props.addProperty
  ObjectProperties.ptrs,  "123,exHostFQDN.com,456,exHostFQDN.net"
  
  long addressId = service.assignIP4Address
  configurationId, IPv4Address, macAddressStr, hostInfo, IPAssignmentActionValues.MAKE_STATIC, props.getPropertiesString;
  

• name —name of the IPv4 address.
• locationCode —the hierarchical location code consists of a set of 1 to 3 alpha-numeric strings separated by a space. The first two characters indicate a country, followed by next three characters which indicate a city in UN/LOCODE. New custom locations created under a UN/LOCODE city are appended to the end of the hierarchy. For example, CA TOR OF1 indicates: CA= Canada TOR=Toronto OF1=Office 1.
  Note: The code is case-sensitive. It must be all UPPER CASE letters. The country code and child location code should be alphanumeric strings.
• allowDuplicateHost (optional) —check for duplicate hostnames. There are three possible values for this property:
  • Enable—enable the duplicate host checking process. If a duplicate hostname is found, assignment will be refused.
  • Disable—disable the duplicate host checking process. Duplicate hostnames will be allowed.
    Note: Disable is the default value for allowDuplicateHost.
  • Inherit—set to make the hostname use the option specified in the higher-level parent object.
• pingBeforeAssign (optional) —specifies whether Address Manager performs a ping check before assigning the IP address. The property can be one of the following values:
  • enable —specifies that Address Manager performs a ping check before assigning the IP address.
    Note:

    • If Address Manager successfully pings the IP address but the address is in use, the following error is returned:

      The address <IP address> is in use.

    • If Address Manager cannot successfully ping the IP address, the following error is returned:

      The address <IP address> is invalid.

  • disable —specifies that Address Manager will not perform a ping check before assigning the IP address.
    Note: This is the default value.