Create an IP Address record at subnet level

  • Release version: Australia
  • Updated June 16, 2026
  • 2 minutes to read

    • Create a single IP Address record that represents an entire IP Subnetwork as one Configuration Item. The IP Address record uses the subnetwork’s CIDR as its value, rather than a single host address. This method is used when the subnetwork is bound to a service, port, customer, or interface as a single entity.

    Before you begin

    Before you begin:

    • Install all required Telecommunications Network Inventory plugins.
    • Role required: core.dc_ops_agent, sn_ni_core.inventory_agent
    • The IP Subnetwork must be in an active state (Life Cycle Stage = Operational and Life Cycle Stage Status = In Use).
    • The IP Subnetwork must not have any existing IP Address records created from allocated IPs. If it does, delete those records first, or use this method on a different subnetwork.

    About this task

    This task is the at-subnet-level allocation method. The system creates one IP Address record whose value is the subnetwork’s CIDR (for example, 10.10.1.0/26). The record represents the subnetwork as a single CMDB Configuration Item and is linked to the subnetwork through a Contains relationship.

    The two IP allocation methods (from allocated IPs and at subnet level) are mutually exclusive on a given subnetwork. Once the first IP Address record is created by either method, the other method is locked for that subnetwork until all IP Address records are deleted. To learn more, see CMDB relationships for IP address records.

    This method does not require the subnetwork’s allocated IP records to be created first. The IP Address record is bound directly to the subnetwork, not to any individual address slot.

    Procedure

    1. Navigate to Workspaces > Network Inventory Workspace or Service Operations Workspace.
    2. Open the IP Subnetwork record.

      (Inventory Number Allocation > IP Network Subnets > select the subnetwork.)

    3. Open the three-dot menu in the top-right corner of the record.
    4. Select Create IP Address Record.
      Note:
      This menu item is separate from the Create IP Address Records button on the Allocated IP Address tab.
    5. In the confirmation dialog, review the subnetwork details.
    6. Select OK to confirm.

      The system creates the IP Address record and displays a confirmation banner:

      IP Address record created: {Name} ( {CIDR} )
    7. Review the new IP Address record on the IP Address tab.

      The tab count updates to 1. The IP Address record’s fields:

      Field Value
      Name The subnetwork’s CIDR (for example, 10.10.1.0/26).
      IP Address The subnetwork’s CIDR.
      IP version IPv4 or IPv6, matching the subnetwork’s protocol.

    Result

    Effect on the data model for an IP Address record created by this task, the system writes one CMDB relationship: IP Subnetwork → Contains → IP Address — links the IP Address record to the parent subnetwork. The system does not write a Manages relationship, because the IP Address record is not bound to a specific allocated IP slot. To learn more, see.

    What to do next

    Bind the IP Address record to the service, port, customer, or interface it represents by populating the Owned By Configuration Item field on the record.