Get linked IPv4 template conflicts - BlueCat Integrity - 9.4.0

Address Manager API Guide

Locale
English
Product name
BlueCat Integrity
Version
9.4.0

Get a list of deployment options that conflict with the associated IPv4 objects that are linked to the IPv4 template.

Note: A conflict between an object and a template occurs when the object and template have the same deployment option server settings and you perform one of the following actions:
  • Add a deployment option to the template and the following conditions are true:
    • The option already exists in the object.
    • The values of the option added to the template are different from the values of the option in the object.
  • Add a deployment option to the object and the following conditions are true:
    • The option already exists in the template.
    • The values of the option added to the object are different from the values of the option in the template.
  • After applying a template to an object, you change deployment option settings in the object.

If the deployment option server settings of the object and template are different, a conflict does not occur.

API method: GET /v1/getLinkedIP4ObjectConflicts
Output / Response: Returns a list of conflicting IPv4 objects and deployment options in JSON format. The list includes the following information:
  • templateId—the object ID of the template
  • templateName—the name of the template
  • networkConflicts—the networks that contain conflicts
  • networkId—the object ID of the conflicting network
  • networkName—the name of the conflicting network
  • networkRange—the network range in CIDR notation
  • deploymentOption—the deployment options that contain conflicts
  • optionName—the name of the deployment option that is conflicting
  • templateOptionId—the object ID of the template deployment option that is conflicting
  • templateOptionValue—the value of the deployment option that is configured in the template
  • networkOptionId—the object ID of the deployment option that conflicts with the template deployment option
  • networkOptionValue—the value of the deployment option that is configured in the network
Example output from this method:
{
    "templateId":1000,
    "templateName":"test template",
    "networkConflicts":[
    {
        "networkId":1010,
        "networkName":"test network 1",
        "networkRange":"192.168.56.0/24",
        "deploymentOption":[
        {
            "optionName":"Maximum Lease Time",
            "templateOptionId":2005,
            "templateOptionValue":"72000",
            "networkOptionId":3005,
            "networkOptionValue":"80000"
        },
        {
            "optionName":"SMTP Server",
            "templateOptionId":2015,
            "templateOptionValue":"10.10.10.11",
            "networkOptionId":3015,
            "networkOptionValue":"10.10.10.12"
        },
        {
            "optionName":"RPZ Min NS Dots",
            "templateOptionId":2025,
            "templateOptionValue":"9955",
            "networkOptionId":3025,
            "networkOptionValue":"4455"
        }]
    },
    {
        "networkId":1020,
        "networkName":"test network 2",
        "networkRange":"192.168.55.0/24",
        "deploymentOption":[
        {
            "optionName":"option F",
            "templateOptionId":2045,
            "templateOptionValue":"value F",
            "networkOptionId":3045,
            "networkOptionValue":"value F prime"
        },
        {
            "optionName":"Start of Authority",
            "templateOptionId":2055,
            "templateOptionValue":"refresh=100|retry=200|expire=300|minimum=400|null|serialNumberFormat=-1|ttl=700|mname=-1|",
            "networkOptionId":3055,
            "networkOptionValue":"refresh=100|retry=200|expire=300|minimum=400|null|serialNumberFormat=-1|ttl=800|mname=-1|"
        }]
    }]
}