Skip to content

# Controller Managed Device Groups

A Controller Managed Device Group in Nautobot models the relationship between controllers and the devices they manage.

Each device can be assigned to only one Controller Managed Device Group through the `Device.controller_managed_device_group` field.

Similarly, each group is linked directly to a Controller via the `ControllerManagedDeviceGroup.controller` field. This link represents the control connection between the controller and the devices in the group.

Groups can be arranged in a hierarchical structure. The `ControllerManagedDeviceGroup.parent` field is used to depict this tree structure of the controlled devices. To organize child groups within a parent group, use the `ControllerManagedDeviceGroup.weight` field. All child groups must be assigned to the same controller as the parent group.

For more detailed information about model relations, please refer to the developer documentation.

## Examples

    controller_managed_device_group:
      - name: campus
        controller: Panorama1
        tags:
          - high_security
        devices:
          - dal-fw01
          - chi-fw01
      - name: dc
        controller: Panorama1
        tags:
          - medium_security
        devices:
          - nyc-fw99
          - jcy-fw99

## Capabilities

Added in version 2.4.0

The capabilities field will be used to track the features that will be displayed on the ControllerManagedDeviceGroup. As an example, the `wireless` choice will add the ControllerManagedDeviceGroup to the Access Point Groups link on the Navbar, and enable the Wireless Networks and Radio Profiles tab on the ControllerManagedDeviceGroup object.