nautobot 2.2.0__py3-none-any.whl → 2.2.0b1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of nautobot might be problematic. Click here for more details.

Files changed (362) hide show
  1. nautobot/apps/api.py +2 -1
  2. nautobot/apps/utils.py +0 -4
  3. nautobot/apps/views.py +0 -2
  4. nautobot/circuits/api/urls.py +2 -1
  5. nautobot/circuits/api/views.py +12 -0
  6. nautobot/circuits/tests/test_filters.py +1 -1
  7. nautobot/core/api/routers.py +3 -25
  8. nautobot/core/api/utils.py +0 -4
  9. nautobot/core/api/views.py +15 -21
  10. nautobot/core/filters.py +1 -7
  11. nautobot/core/management/commands/generate_test_data.py +4 -4
  12. nautobot/core/settings.py +0 -1
  13. nautobot/core/tables.py +1 -2
  14. nautobot/core/templates/admin/base.html +94 -23
  15. nautobot/core/templates/graphene/graphiql.html +47 -18
  16. nautobot/core/templates/inc/footer.html +5 -5
  17. nautobot/core/templates/inc/nav_menu.html +7 -0
  18. nautobot/core/templates/rest_framework/api.html +5 -12
  19. nautobot/core/templatetags/helpers.py +2 -2
  20. nautobot/core/testing/views.py +0 -30
  21. nautobot/core/tests/test_api.py +6 -13
  22. nautobot/core/tests/test_csv.py +4 -5
  23. nautobot/core/tests/test_filters.py +1 -2
  24. nautobot/core/tests/test_graphql.py +14 -4
  25. nautobot/core/tests/test_navigations.py +0 -3
  26. nautobot/core/tests/test_views.py +16 -22
  27. nautobot/core/utils/lookup.py +0 -124
  28. nautobot/core/views/__init__.py +7 -3
  29. nautobot/core/views/generic.py +3 -19
  30. nautobot/core/views/mixins.py +0 -7
  31. nautobot/core/views/renderers.py +1 -4
  32. nautobot/dcim/api/serializers.py +4 -4
  33. nautobot/dcim/api/urls.py +3 -2
  34. nautobot/dcim/api/views.py +18 -7
  35. nautobot/dcim/factory.py +7 -7
  36. nautobot/dcim/filters/__init__.py +17 -16
  37. nautobot/dcim/forms.py +45 -61
  38. nautobot/dcim/homepage.py +3 -11
  39. nautobot/dcim/migrations/0057_controller_models.py +70 -11
  40. nautobot/dcim/models/__init__.py +2 -2
  41. nautobot/dcim/models/devices.py +16 -14
  42. nautobot/dcim/models/racks.py +3 -1
  43. nautobot/dcim/navigation.py +31 -23
  44. nautobot/dcim/signals.py +6 -6
  45. nautobot/dcim/tables/__init__.py +2 -2
  46. nautobot/dcim/tables/devices.py +15 -12
  47. nautobot/dcim/tables/template_code.py +1 -1
  48. nautobot/dcim/templates/dcim/controller_retrieve.html +18 -35
  49. nautobot/dcim/templates/dcim/controllerdevicegroup_create.html +43 -0
  50. nautobot/dcim/templates/dcim/device/lldp_neighbors.html +43 -67
  51. nautobot/dcim/templates/dcim/device.html +2 -10
  52. nautobot/dcim/templates/dcim/device_edit.html +1 -1
  53. nautobot/dcim/tests/test_api.py +6 -11
  54. nautobot/dcim/tests/test_filters.py +81 -92
  55. nautobot/dcim/tests/test_graphql.py +1 -11
  56. nautobot/dcim/tests/test_models.py +15 -15
  57. nautobot/dcim/tests/test_signals.py +0 -2
  58. nautobot/dcim/tests/test_views.py +12 -24
  59. nautobot/dcim/urls.py +1 -1
  60. nautobot/dcim/views.py +15 -19
  61. nautobot/extras/api/urls.py +2 -1
  62. nautobot/extras/api/views.py +10 -0
  63. nautobot/extras/filters/__init__.py +2 -53
  64. nautobot/extras/forms/contacts.py +0 -7
  65. nautobot/extras/managers.py +0 -14
  66. nautobot/extras/navigation.py +65 -71
  67. nautobot/extras/plugins/views.py +11 -7
  68. nautobot/extras/tests/test_api.py +0 -2
  69. nautobot/extras/tests/test_dynamicgroups.py +0 -2
  70. nautobot/extras/tests/test_filters.py +4 -89
  71. nautobot/extras/tests/test_models.py +0 -9
  72. nautobot/extras/tests/test_relationships.py +1 -10
  73. nautobot/extras/tests/test_views.py +1 -112
  74. nautobot/extras/views.py +10 -10
  75. nautobot/ipam/api/urls.py +2 -1
  76. nautobot/ipam/api/views.py +11 -0
  77. nautobot/ipam/tables.py +22 -2
  78. nautobot/ipam/tests/test_graphql.py +3 -2
  79. nautobot/ipam/tests/test_views.py +0 -1
  80. nautobot/ipam/views.py +9 -9
  81. nautobot/project-static/css/base.css +0 -1
  82. nautobot/project-static/docs/404.html +3 -24
  83. nautobot/project-static/docs/apps/index.html +3 -24
  84. nautobot/project-static/docs/apps/nautobot-apps.html +3 -24
  85. nautobot/project-static/docs/code-reference/nautobot/apps/__init__.html +3 -24
  86. nautobot/project-static/docs/code-reference/nautobot/apps/admin.html +3 -24
  87. nautobot/project-static/docs/code-reference/nautobot/apps/api.html +5 -26
  88. nautobot/project-static/docs/code-reference/nautobot/apps/change_logging.html +3 -24
  89. nautobot/project-static/docs/code-reference/nautobot/apps/choices.html +3 -24
  90. nautobot/project-static/docs/code-reference/nautobot/apps/config.html +3 -24
  91. nautobot/project-static/docs/code-reference/nautobot/apps/constants.html +3 -24
  92. nautobot/project-static/docs/code-reference/nautobot/apps/datasources.html +3 -24
  93. nautobot/project-static/docs/code-reference/nautobot/apps/exceptions.html +3 -24
  94. nautobot/project-static/docs/code-reference/nautobot/apps/factory.html +3 -24
  95. nautobot/project-static/docs/code-reference/nautobot/apps/filters.html +3 -24
  96. nautobot/project-static/docs/code-reference/nautobot/apps/forms.html +3 -24
  97. nautobot/project-static/docs/code-reference/nautobot/apps/graphql.html +3 -24
  98. nautobot/project-static/docs/code-reference/nautobot/apps/jobs.html +3 -24
  99. nautobot/project-static/docs/code-reference/nautobot/apps/models.html +3 -24
  100. nautobot/project-static/docs/code-reference/nautobot/apps/querysets.html +3 -24
  101. nautobot/project-static/docs/code-reference/nautobot/apps/secrets.html +3 -24
  102. nautobot/project-static/docs/code-reference/nautobot/apps/tables.html +3 -24
  103. nautobot/project-static/docs/code-reference/nautobot/apps/testing.html +3 -24
  104. nautobot/project-static/docs/code-reference/nautobot/apps/ui.html +3 -24
  105. nautobot/project-static/docs/code-reference/nautobot/apps/urls.html +3 -24
  106. nautobot/project-static/docs/code-reference/nautobot/apps/utils.html +3 -242
  107. nautobot/project-static/docs/code-reference/nautobot/apps/views.html +5 -69
  108. nautobot/project-static/docs/development/apps/api/configuration-view.html +3 -24
  109. nautobot/project-static/docs/development/apps/api/database-backend-config.html +3 -24
  110. nautobot/project-static/docs/development/apps/api/models/django-admin.html +3 -24
  111. nautobot/project-static/docs/development/apps/api/models/global-search.html +3 -24
  112. nautobot/project-static/docs/development/apps/api/models/graphql.html +3 -24
  113. nautobot/project-static/docs/development/apps/api/models/index.html +3 -24
  114. nautobot/project-static/docs/development/apps/api/nautobot-app-config.html +3 -24
  115. nautobot/project-static/docs/development/apps/api/platform-features/custom-validators.html +3 -24
  116. nautobot/project-static/docs/development/apps/api/platform-features/filter-extensions.html +3 -24
  117. nautobot/project-static/docs/development/apps/api/platform-features/git-repository-content.html +3 -24
  118. nautobot/project-static/docs/development/apps/api/platform-features/index.html +3 -24
  119. nautobot/project-static/docs/development/apps/api/platform-features/jinja2-filters.html +3 -24
  120. nautobot/project-static/docs/development/apps/api/platform-features/jobs.html +3 -24
  121. nautobot/project-static/docs/development/apps/api/platform-features/populating-extensibility-features.html +3 -24
  122. nautobot/project-static/docs/development/apps/api/platform-features/secrets-providers.html +3 -24
  123. nautobot/project-static/docs/development/apps/api/platform-features/uniquely-identify-objects.html +3 -24
  124. nautobot/project-static/docs/development/apps/api/prometheus.html +3 -24
  125. nautobot/project-static/docs/development/apps/api/setup.html +3 -24
  126. nautobot/project-static/docs/development/apps/api/testing.html +3 -24
  127. nautobot/project-static/docs/development/apps/api/ui-extensions/banners.html +3 -24
  128. nautobot/project-static/docs/development/apps/api/ui-extensions/home-page.html +3 -24
  129. nautobot/project-static/docs/development/apps/api/ui-extensions/index.html +3 -24
  130. nautobot/project-static/docs/development/apps/api/ui-extensions/navigation.html +3 -24
  131. nautobot/project-static/docs/development/apps/api/ui-extensions/object-views.html +3 -24
  132. nautobot/project-static/docs/development/apps/api/views/base-template.html +3 -24
  133. nautobot/project-static/docs/development/apps/api/views/core-view-overrides.html +12 -38
  134. nautobot/project-static/docs/development/apps/api/views/django-generic-views.html +15 -41
  135. nautobot/project-static/docs/development/apps/api/views/help-documentation.html +3 -24
  136. nautobot/project-static/docs/development/apps/api/views/index.html +3 -24
  137. nautobot/project-static/docs/development/apps/api/views/nautobot-generic-views.html +3 -24
  138. nautobot/project-static/docs/development/apps/api/views/nautobotuiviewset.html +3 -24
  139. nautobot/project-static/docs/development/apps/api/views/nautobotuiviewsetrouter.html +3 -24
  140. nautobot/project-static/docs/development/apps/api/views/notes.html +3 -24
  141. nautobot/project-static/docs/development/apps/api/views/rest-api.html +3 -24
  142. nautobot/project-static/docs/development/apps/api/views/urls.html +3 -24
  143. nautobot/project-static/docs/development/apps/index.html +3 -24
  144. nautobot/project-static/docs/development/apps/migration/code-updates.html +3 -24
  145. nautobot/project-static/docs/development/apps/migration/dependency-updates.html +3 -24
  146. nautobot/project-static/docs/development/apps/migration/from-v1.html +3 -24
  147. nautobot/project-static/docs/development/apps/migration/model-updates/dcim.html +3 -24
  148. nautobot/project-static/docs/development/apps/migration/model-updates/extras.html +3 -24
  149. nautobot/project-static/docs/development/apps/migration/model-updates/global.html +3 -24
  150. nautobot/project-static/docs/development/apps/migration/model-updates/ipam.html +3 -24
  151. nautobot/project-static/docs/development/apps/porting-from-netbox.html +3 -24
  152. nautobot/project-static/docs/development/core/application-registry.html +3 -24
  153. nautobot/project-static/docs/development/core/best-practices.html +3 -24
  154. nautobot/project-static/docs/development/core/bootstrap-ui.html +3 -24
  155. nautobot/project-static/docs/development/core/caching.html +3 -24
  156. nautobot/project-static/docs/development/core/controllers.html +204 -35
  157. nautobot/project-static/docs/development/core/docker-compose-advanced-use-cases.html +3 -24
  158. nautobot/project-static/docs/development/core/extending-models.html +3 -24
  159. nautobot/project-static/docs/development/core/generic-views.html +3 -24
  160. nautobot/project-static/docs/development/core/getting-started.html +13 -43
  161. nautobot/project-static/docs/development/core/homepage.html +3 -24
  162. nautobot/project-static/docs/development/core/index.html +3 -24
  163. nautobot/project-static/docs/development/core/model-features.html +3 -24
  164. nautobot/project-static/docs/development/core/natural-keys.html +3 -24
  165. nautobot/project-static/docs/development/core/navigation-menu.html +3 -24
  166. nautobot/project-static/docs/development/core/release-checklist.html +3 -24
  167. nautobot/project-static/docs/development/core/role-internals.html +3 -24
  168. nautobot/project-static/docs/development/core/settings.html +3 -24
  169. nautobot/project-static/docs/development/core/style-guide.html +3 -24
  170. nautobot/project-static/docs/development/core/templates.html +3 -24
  171. nautobot/project-static/docs/development/core/testing.html +3 -24
  172. nautobot/project-static/docs/development/core/user-preferences.html +3 -24
  173. nautobot/project-static/docs/development/index.html +3 -24
  174. nautobot/project-static/docs/development/jobs/index.html +3 -24
  175. nautobot/project-static/docs/development/jobs/migration/from-v1.html +3 -24
  176. nautobot/project-static/docs/index.html +3 -24
  177. nautobot/project-static/docs/models/dcim/{controllermanageddevicegroup.html → controllerdevicegroup.html} +3 -3
  178. nautobot/project-static/docs/objects.inv +0 -0
  179. nautobot/project-static/docs/release-notes/index.html +3 -24
  180. nautobot/project-static/docs/release-notes/version-1.0.html +3 -24
  181. nautobot/project-static/docs/release-notes/version-1.1.html +3 -24
  182. nautobot/project-static/docs/release-notes/version-1.2.html +3 -24
  183. nautobot/project-static/docs/release-notes/version-1.3.html +3 -24
  184. nautobot/project-static/docs/release-notes/version-1.4.html +3 -24
  185. nautobot/project-static/docs/release-notes/version-1.5.html +3 -24
  186. nautobot/project-static/docs/release-notes/version-1.6.html +3 -24
  187. nautobot/project-static/docs/release-notes/version-2.0.html +3 -24
  188. nautobot/project-static/docs/release-notes/version-2.1.html +162 -411
  189. nautobot/project-static/docs/release-notes/version-2.2.html +30 -212
  190. nautobot/project-static/docs/search/search_index.json +1 -1
  191. nautobot/project-static/docs/sitemap.xml +255 -260
  192. nautobot/project-static/docs/sitemap.xml.gz +0 -0
  193. nautobot/project-static/docs/user-guide/administration/configuration/authentication/ldap.html +3 -24
  194. nautobot/project-static/docs/user-guide/administration/configuration/authentication/remote.html +3 -24
  195. nautobot/project-static/docs/user-guide/administration/configuration/authentication/sso.html +3 -24
  196. nautobot/project-static/docs/user-guide/administration/configuration/index.html +3 -24
  197. nautobot/project-static/docs/user-guide/administration/configuration/optional-settings.html +3 -24
  198. nautobot/project-static/docs/user-guide/administration/configuration/required-settings.html +3 -24
  199. nautobot/project-static/docs/user-guide/administration/configuration/time-zones.html +3 -24
  200. nautobot/project-static/docs/user-guide/administration/guides/caching.html +3 -24
  201. nautobot/project-static/docs/user-guide/administration/guides/celery-queues.html +3 -24
  202. nautobot/project-static/docs/user-guide/administration/guides/healthcheck.html +3 -24
  203. nautobot/project-static/docs/user-guide/administration/guides/permissions.html +3 -24
  204. nautobot/project-static/docs/user-guide/administration/guides/prometheus-metrics.html +3 -24
  205. nautobot/project-static/docs/user-guide/administration/guides/replicating-nautobot.html +3 -24
  206. nautobot/project-static/docs/user-guide/administration/guides/request-profiling.html +3 -24
  207. nautobot/project-static/docs/user-guide/administration/guides/s3-django-storage.html +3 -24
  208. nautobot/project-static/docs/user-guide/administration/installation/app-install.html +3 -24
  209. nautobot/project-static/docs/user-guide/administration/installation/docker.html +6 -31
  210. nautobot/project-static/docs/user-guide/administration/installation/external-authentication.html +3 -24
  211. nautobot/project-static/docs/user-guide/administration/installation/http-server.html +3 -24
  212. nautobot/project-static/docs/user-guide/administration/installation/index.html +3 -24
  213. nautobot/project-static/docs/user-guide/administration/installation/install_system.html +3 -24
  214. nautobot/project-static/docs/user-guide/administration/installation/nautobot.html +3 -24
  215. nautobot/project-static/docs/user-guide/administration/installation/selinux-troubleshooting.html +6 -27
  216. nautobot/project-static/docs/user-guide/administration/installation/services.html +3 -24
  217. nautobot/project-static/docs/user-guide/administration/migration/migrating-from-netbox.html +3 -24
  218. nautobot/project-static/docs/user-guide/administration/migration/migrating-from-postgresql.html +3 -24
  219. nautobot/project-static/docs/user-guide/administration/tools/nautobot-server.html +3 -24
  220. nautobot/project-static/docs/user-guide/administration/tools/nautobot-shell.html +3 -24
  221. nautobot/project-static/docs/user-guide/administration/upgrading/database-backup.html +3 -24
  222. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/after-you-upgrade.html +3 -24
  223. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/before-you-upgrade.html +3 -24
  224. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/for-developers.html +3 -24
  225. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/index.html +3 -24
  226. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/whats-changed.html +3 -24
  227. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/region-and-site-data-migration-guide.html +3 -24
  228. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/upgrading-from-nautobot-v1.html +3 -24
  229. nautobot/project-static/docs/user-guide/administration/upgrading/upgrading.html +3 -24
  230. nautobot/project-static/docs/user-guide/core-data-model/circuits/circuit.html +3 -24
  231. nautobot/project-static/docs/user-guide/core-data-model/circuits/circuittermination.html +3 -24
  232. nautobot/project-static/docs/user-guide/core-data-model/circuits/circuittype.html +3 -24
  233. nautobot/project-static/docs/user-guide/core-data-model/circuits/provider.html +3 -24
  234. nautobot/project-static/docs/user-guide/core-data-model/circuits/providernetwork.html +3 -24
  235. nautobot/project-static/docs/user-guide/core-data-model/dcim/cable.html +3 -24
  236. nautobot/project-static/docs/user-guide/core-data-model/dcim/consoleport.html +3 -24
  237. nautobot/project-static/docs/user-guide/core-data-model/dcim/consoleporttemplate.html +3 -24
  238. nautobot/project-static/docs/user-guide/core-data-model/dcim/consoleserverport.html +3 -24
  239. nautobot/project-static/docs/user-guide/core-data-model/dcim/consoleserverporttemplate.html +3 -24
  240. nautobot/project-static/docs/user-guide/core-data-model/dcim/controller.html +11 -259
  241. nautobot/project-static/docs/user-guide/core-data-model/dcim/{controllermanageddevicegroup.html → controllerdevicegroup.html} +17 -107
  242. nautobot/project-static/docs/user-guide/core-data-model/dcim/device.html +3 -24
  243. nautobot/project-static/docs/user-guide/core-data-model/dcim/devicebay.html +3 -24
  244. nautobot/project-static/docs/user-guide/core-data-model/dcim/devicebaytemplate.html +3 -24
  245. nautobot/project-static/docs/user-guide/core-data-model/dcim/devicefamily.html +3 -24
  246. nautobot/project-static/docs/user-guide/core-data-model/dcim/deviceredundancygroup.html +3 -24
  247. nautobot/project-static/docs/user-guide/core-data-model/dcim/devicetype.html +3 -24
  248. nautobot/project-static/docs/user-guide/core-data-model/dcim/frontport.html +3 -24
  249. nautobot/project-static/docs/user-guide/core-data-model/dcim/frontporttemplate.html +3 -24
  250. nautobot/project-static/docs/user-guide/core-data-model/dcim/interface.html +3 -24
  251. nautobot/project-static/docs/user-guide/core-data-model/dcim/interfaceredundancygroup.html +3 -24
  252. nautobot/project-static/docs/user-guide/core-data-model/dcim/interfacetemplate.html +3 -24
  253. nautobot/project-static/docs/user-guide/core-data-model/dcim/inventoryitem.html +3 -24
  254. nautobot/project-static/docs/user-guide/core-data-model/dcim/location.html +3 -24
  255. nautobot/project-static/docs/user-guide/core-data-model/dcim/locationtype.html +3 -24
  256. nautobot/project-static/docs/user-guide/core-data-model/dcim/manufacturer.html +3 -24
  257. nautobot/project-static/docs/user-guide/core-data-model/dcim/platform.html +3 -24
  258. nautobot/project-static/docs/user-guide/core-data-model/dcim/powerfeed.html +3 -24
  259. nautobot/project-static/docs/user-guide/core-data-model/dcim/poweroutlet.html +3 -24
  260. nautobot/project-static/docs/user-guide/core-data-model/dcim/poweroutlettemplate.html +3 -24
  261. nautobot/project-static/docs/user-guide/core-data-model/dcim/powerpanel.html +3 -24
  262. nautobot/project-static/docs/user-guide/core-data-model/dcim/powerport.html +3 -24
  263. nautobot/project-static/docs/user-guide/core-data-model/dcim/powerporttemplate.html +3 -24
  264. nautobot/project-static/docs/user-guide/core-data-model/dcim/rack.html +3 -24
  265. nautobot/project-static/docs/user-guide/core-data-model/dcim/rackgroup.html +3 -24
  266. nautobot/project-static/docs/user-guide/core-data-model/dcim/rackreservation.html +3 -24
  267. nautobot/project-static/docs/user-guide/core-data-model/dcim/rearport.html +3 -24
  268. nautobot/project-static/docs/user-guide/core-data-model/dcim/rearporttemplate.html +3 -24
  269. nautobot/project-static/docs/user-guide/core-data-model/dcim/softwareimagefile.html +3 -24
  270. nautobot/project-static/docs/user-guide/core-data-model/dcim/softwareversion.html +3 -24
  271. nautobot/project-static/docs/user-guide/core-data-model/dcim/virtualchassis.html +3 -24
  272. nautobot/project-static/docs/user-guide/core-data-model/extras/configcontext.html +6 -27
  273. nautobot/project-static/docs/user-guide/core-data-model/extras/configcontextschema.html +3 -24
  274. nautobot/project-static/docs/user-guide/core-data-model/extras/contact.html +3 -24
  275. nautobot/project-static/docs/user-guide/core-data-model/extras/team.html +3 -24
  276. nautobot/project-static/docs/user-guide/core-data-model/ipam/ipaddress.html +3 -24
  277. nautobot/project-static/docs/user-guide/core-data-model/ipam/namespace.html +3 -24
  278. nautobot/project-static/docs/user-guide/core-data-model/ipam/prefix.html +3 -24
  279. nautobot/project-static/docs/user-guide/core-data-model/ipam/rir.html +3 -24
  280. nautobot/project-static/docs/user-guide/core-data-model/ipam/routetarget.html +3 -24
  281. nautobot/project-static/docs/user-guide/core-data-model/ipam/service.html +3 -24
  282. nautobot/project-static/docs/user-guide/core-data-model/ipam/vlan.html +3 -24
  283. nautobot/project-static/docs/user-guide/core-data-model/ipam/vlangroup.html +3 -24
  284. nautobot/project-static/docs/user-guide/core-data-model/ipam/vrf.html +3 -24
  285. nautobot/project-static/docs/user-guide/core-data-model/overview/introduction.html +3 -24
  286. nautobot/project-static/docs/user-guide/core-data-model/tenancy/tenant.html +3 -24
  287. nautobot/project-static/docs/user-guide/core-data-model/tenancy/tenantgroup.html +3 -24
  288. nautobot/project-static/docs/user-guide/core-data-model/virtualization/cluster.html +3 -24
  289. nautobot/project-static/docs/user-guide/core-data-model/virtualization/clustergroup.html +3 -24
  290. nautobot/project-static/docs/user-guide/core-data-model/virtualization/clustertype.html +3 -24
  291. nautobot/project-static/docs/user-guide/core-data-model/virtualization/virtualmachine.html +3 -24
  292. nautobot/project-static/docs/user-guide/core-data-model/virtualization/vminterface.html +3 -24
  293. nautobot/project-static/docs/user-guide/feature-guides/{contacts-and-teams.html → contact-and-team.html} +4 -25
  294. nautobot/project-static/docs/user-guide/feature-guides/custom-fields.html +5 -26
  295. nautobot/project-static/docs/user-guide/feature-guides/getting-started/creating-devices.html +3 -24
  296. nautobot/project-static/docs/user-guide/feature-guides/getting-started/creating-location-types-and-locations.html +3 -24
  297. nautobot/project-static/docs/user-guide/feature-guides/getting-started/index.html +3 -24
  298. nautobot/project-static/docs/user-guide/feature-guides/getting-started/interfaces.html +3 -24
  299. nautobot/project-static/docs/user-guide/feature-guides/getting-started/ipam.html +3 -24
  300. nautobot/project-static/docs/user-guide/feature-guides/getting-started/platforms.html +3 -24
  301. nautobot/project-static/docs/user-guide/feature-guides/getting-started/search-bar.html +5 -26
  302. nautobot/project-static/docs/user-guide/feature-guides/getting-started/tenants.html +3 -24
  303. nautobot/project-static/docs/user-guide/feature-guides/getting-started/vlans-and-vlan-groups.html +3 -24
  304. nautobot/project-static/docs/user-guide/feature-guides/git-data-source.html +3 -24
  305. nautobot/project-static/docs/user-guide/feature-guides/graphql.html +3 -24
  306. nautobot/project-static/docs/user-guide/feature-guides/ip-address-merge-tool.html +3 -24
  307. nautobot/project-static/docs/user-guide/feature-guides/relationships.html +3 -24
  308. nautobot/project-static/docs/user-guide/feature-guides/software-image-files-and-versions.html +3 -24
  309. nautobot/project-static/docs/user-guide/index.html +3 -24
  310. nautobot/project-static/docs/user-guide/platform-functionality/change-logging.html +3 -24
  311. nautobot/project-static/docs/user-guide/platform-functionality/computedfield.html +3 -24
  312. nautobot/project-static/docs/user-guide/platform-functionality/customfield.html +3 -24
  313. nautobot/project-static/docs/user-guide/platform-functionality/customlink.html +3 -24
  314. nautobot/project-static/docs/user-guide/platform-functionality/dynamicgroup.html +3 -24
  315. nautobot/project-static/docs/user-guide/platform-functionality/exporttemplate.html +3 -24
  316. nautobot/project-static/docs/user-guide/platform-functionality/externalintegration.html +3 -24
  317. nautobot/project-static/docs/user-guide/platform-functionality/gitrepository.html +3 -24
  318. nautobot/project-static/docs/user-guide/platform-functionality/graphql.html +3 -24
  319. nautobot/project-static/docs/user-guide/platform-functionality/graphqlquery.html +3 -24
  320. nautobot/project-static/docs/user-guide/platform-functionality/imageattachment.html +3 -24
  321. nautobot/project-static/docs/user-guide/platform-functionality/jobs/index.html +3 -24
  322. nautobot/project-static/docs/user-guide/platform-functionality/jobs/job-scheduling-and-approvals.html +3 -24
  323. nautobot/project-static/docs/user-guide/platform-functionality/jobs/jobbutton.html +3 -24
  324. nautobot/project-static/docs/user-guide/platform-functionality/jobs/jobhook.html +3 -24
  325. nautobot/project-static/docs/user-guide/platform-functionality/jobs/models.html +3 -24
  326. nautobot/project-static/docs/user-guide/platform-functionality/napalm.html +3 -24
  327. nautobot/project-static/docs/user-guide/platform-functionality/note.html +3 -24
  328. nautobot/project-static/docs/user-guide/platform-functionality/relationship.html +3 -24
  329. nautobot/project-static/docs/user-guide/platform-functionality/rest-api/authentication.html +3 -24
  330. nautobot/project-static/docs/user-guide/platform-functionality/rest-api/filtering.html +3 -24
  331. nautobot/project-static/docs/user-guide/platform-functionality/rest-api/overview.html +3 -24
  332. nautobot/project-static/docs/user-guide/platform-functionality/rest-api/ui-related-endpoints.html +3 -24
  333. nautobot/project-static/docs/user-guide/platform-functionality/role.html +3 -24
  334. nautobot/project-static/docs/user-guide/platform-functionality/secret.html +3 -24
  335. nautobot/project-static/docs/user-guide/platform-functionality/status.html +3 -24
  336. nautobot/project-static/docs/user-guide/platform-functionality/tag.html +3 -24
  337. nautobot/project-static/docs/user-guide/platform-functionality/template-filters.html +3 -24
  338. nautobot/project-static/docs/user-guide/platform-functionality/users/objectpermission.html +3 -24
  339. nautobot/project-static/docs/user-guide/platform-functionality/users/token.html +3 -24
  340. nautobot/project-static/docs/user-guide/platform-functionality/webhook.html +3 -24
  341. nautobot/tenancy/api/urls.py +2 -1
  342. nautobot/tenancy/api/views.py +12 -0
  343. nautobot/tenancy/tables.py +1 -1
  344. nautobot/tenancy/tests/test_views.py +0 -1
  345. nautobot/users/api/urls.py +2 -1
  346. nautobot/users/api/views.py +65 -2
  347. nautobot/users/views.py +8 -8
  348. nautobot/virtualization/api/urls.py +2 -1
  349. nautobot/virtualization/api/views.py +12 -0
  350. {nautobot-2.2.0.dist-info → nautobot-2.2.0b1.dist-info}/METADATA +3 -3
  351. {nautobot-2.2.0.dist-info → nautobot-2.2.0b1.dist-info}/RECORD +356 -361
  352. nautobot/core/tests/integration/test_view_authentication.py +0 -67
  353. nautobot/dcim/management/commands/migrate_location_contacts.py +0 -218
  354. nautobot/dcim/templates/dcim/controller_create.html +0 -70
  355. nautobot/dcim/templates/dcim/controllermanageddevicegroup_create.html +0 -88
  356. nautobot/ipam/tests/test_tables.py +0 -42
  357. nautobot/project-static/docs/user-guide/administration/installation/health-checks.html +0 -8581
  358. /nautobot/dcim/templates/dcim/{controllermanageddevicegroup_retrieve.html → controllerdevicegroup_retrieve.html} +0 -0
  359. {nautobot-2.2.0.dist-info → nautobot-2.2.0b1.dist-info}/LICENSE.txt +0 -0
  360. {nautobot-2.2.0.dist-info → nautobot-2.2.0b1.dist-info}/NOTICE +0 -0
  361. {nautobot-2.2.0.dist-info → nautobot-2.2.0b1.dist-info}/WHEEL +0 -0
  362. {nautobot-2.2.0.dist-info → nautobot-2.2.0b1.dist-info}/entry_points.txt +0 -0
@@ -14,7 +14,7 @@
14
14
  <link rel="prev" href="virtualchassis.html">
15
15
 
16
16
 
17
- <link rel="next" href="controllermanageddevicegroup.html">
17
+ <link rel="next" href="controllerdevicegroup.html">
18
18
 
19
19
 
20
20
  <link rel="icon" href="../../../assets/favicon.ico">
@@ -688,27 +688,6 @@
688
688
 
689
689
 
690
690
 
691
- <li class="md-nav__item">
692
- <a href="../../administration/installation/health-checks.html" class="md-nav__link">
693
-
694
-
695
- <span class="md-ellipsis">
696
- Health Checks
697
- </span>
698
-
699
-
700
- </a>
701
- </li>
702
-
703
-
704
-
705
-
706
-
707
-
708
-
709
-
710
-
711
-
712
691
  <li class="md-nav__item">
713
692
  <a href="../../administration/installation/selinux-troubleshooting.html" class="md-nav__link">
714
693
 
@@ -1914,7 +1893,7 @@
1914
1893
 
1915
1894
 
1916
1895
  <li class="md-nav__item">
1917
- <a href="../../feature-guides/contacts-and-teams.html" class="md-nav__link">
1896
+ <a href="../../feature-guides/contact-and-team.html" class="md-nav__link">
1918
1897
 
1919
1898
 
1920
1899
  <span class="md-ellipsis">
@@ -3171,17 +3150,6 @@
3171
3150
 
3172
3151
 
3173
3152
 
3174
- <label class="md-nav__link md-nav__link--active" for="__toc">
3175
-
3176
-
3177
- <span class="md-ellipsis">
3178
- Controller
3179
- </span>
3180
-
3181
-
3182
- <span class="md-nav__icon md-icon"></span>
3183
- </label>
3184
-
3185
3153
  <a href="controller.html" class="md-nav__link md-nav__link--active">
3186
3154
 
3187
3155
 
@@ -3192,94 +3160,6 @@
3192
3160
 
3193
3161
  </a>
3194
3162
 
3195
-
3196
-
3197
- <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
3198
-
3199
-
3200
-
3201
-
3202
-
3203
-
3204
- <label class="md-nav__title" for="__toc">
3205
- <span class="md-nav__icon md-icon"></span>
3206
- Table of contents
3207
- </label>
3208
- <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
3209
-
3210
- <li class="md-nav__item">
3211
- <a href="#key-features" class="md-nav__link">
3212
- <span class="md-ellipsis">
3213
- Key Features
3214
- </span>
3215
- </a>
3216
-
3217
- </li>
3218
-
3219
- <li class="md-nav__item">
3220
- <a href="#use-cases" class="md-nav__link">
3221
- <span class="md-ellipsis">
3222
- Use Cases
3223
- </span>
3224
- </a>
3225
-
3226
- </li>
3227
-
3228
- <li class="md-nav__item">
3229
- <a href="#base-fields" class="md-nav__link">
3230
- <span class="md-ellipsis">
3231
- Base Fields
3232
- </span>
3233
- </a>
3234
-
3235
- </li>
3236
-
3237
- <li class="md-nav__item">
3238
- <a href="#related-models" class="md-nav__link">
3239
- <span class="md-ellipsis">
3240
- Related Models
3241
- </span>
3242
- </a>
3243
-
3244
- </li>
3245
-
3246
- <li class="md-nav__item">
3247
- <a href="#examples" class="md-nav__link">
3248
- <span class="md-ellipsis">
3249
- Examples
3250
- </span>
3251
- </a>
3252
-
3253
- <nav class="md-nav" aria-label="Examples">
3254
- <ul class="md-nav__list">
3255
-
3256
- <li class="md-nav__item">
3257
- <a href="#cisco-aci" class="md-nav__link">
3258
- <span class="md-ellipsis">
3259
- Cisco ACI
3260
- </span>
3261
- </a>
3262
-
3263
- </li>
3264
-
3265
- <li class="md-nav__item">
3266
- <a href="#cisco-meraki" class="md-nav__link">
3267
- <span class="md-ellipsis">
3268
- Cisco Meraki
3269
- </span>
3270
- </a>
3271
-
3272
- </li>
3273
-
3274
- </ul>
3275
- </nav>
3276
-
3277
- </li>
3278
-
3279
- </ul>
3280
-
3281
- </nav>
3282
-
3283
3163
  </li>
3284
3164
 
3285
3165
 
@@ -3292,11 +3172,11 @@
3292
3172
 
3293
3173
 
3294
3174
  <li class="md-nav__item">
3295
- <a href="controllermanageddevicegroup.html" class="md-nav__link">
3175
+ <a href="controllerdevicegroup.html" class="md-nav__link">
3296
3176
 
3297
3177
 
3298
3178
  <span class="md-ellipsis">
3299
- Controller Managed Device Group
3179
+ Controller Device Group
3300
3180
  </span>
3301
3181
 
3302
3182
 
@@ -7775,83 +7655,6 @@
7775
7655
 
7776
7656
 
7777
7657
 
7778
- <label class="md-nav__title" for="__toc">
7779
- <span class="md-nav__icon md-icon"></span>
7780
- Table of contents
7781
- </label>
7782
- <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
7783
-
7784
- <li class="md-nav__item">
7785
- <a href="#key-features" class="md-nav__link">
7786
- <span class="md-ellipsis">
7787
- Key Features
7788
- </span>
7789
- </a>
7790
-
7791
- </li>
7792
-
7793
- <li class="md-nav__item">
7794
- <a href="#use-cases" class="md-nav__link">
7795
- <span class="md-ellipsis">
7796
- Use Cases
7797
- </span>
7798
- </a>
7799
-
7800
- </li>
7801
-
7802
- <li class="md-nav__item">
7803
- <a href="#base-fields" class="md-nav__link">
7804
- <span class="md-ellipsis">
7805
- Base Fields
7806
- </span>
7807
- </a>
7808
-
7809
- </li>
7810
-
7811
- <li class="md-nav__item">
7812
- <a href="#related-models" class="md-nav__link">
7813
- <span class="md-ellipsis">
7814
- Related Models
7815
- </span>
7816
- </a>
7817
-
7818
- </li>
7819
-
7820
- <li class="md-nav__item">
7821
- <a href="#examples" class="md-nav__link">
7822
- <span class="md-ellipsis">
7823
- Examples
7824
- </span>
7825
- </a>
7826
-
7827
- <nav class="md-nav" aria-label="Examples">
7828
- <ul class="md-nav__list">
7829
-
7830
- <li class="md-nav__item">
7831
- <a href="#cisco-aci" class="md-nav__link">
7832
- <span class="md-ellipsis">
7833
- Cisco ACI
7834
- </span>
7835
- </a>
7836
-
7837
- </li>
7838
-
7839
- <li class="md-nav__item">
7840
- <a href="#cisco-meraki" class="md-nav__link">
7841
- <span class="md-ellipsis">
7842
- Cisco Meraki
7843
- </span>
7844
- </a>
7845
-
7846
- </li>
7847
-
7848
- </ul>
7849
- </nav>
7850
-
7851
- </li>
7852
-
7853
- </ul>
7854
-
7855
7658
  </nav>
7856
7659
  </div>
7857
7660
  </div>
@@ -7870,66 +7673,15 @@
7870
7673
 
7871
7674
  <h1 id="controllers">Controllers<a class="headerlink" href="#controllers" title="Permanent link">&para;</a></h1>
7872
7675
  <p>A Controller in Nautobot is an abstraction meant to represent network or SDN (Software-Defined Networking) controllers. These may include, but are not limited to, wireless controllers, cloud-based network management systems, and other forms of central network control mechanisms.</p>
7873
- <h2 id="key-features">Key Features<a class="headerlink" href="#key-features" title="Permanent link">&para;</a></h2>
7676
+ <p>The Controller model is key in representing an entity that is connected to either individual <a href="device.html">Devices</a> or to groups of devices through a <a href="deviceredundancygroup.html"><code>DeviceRedundancyGroup</code></a>.</p>
7677
+ <p>Each controller manages one or more devices using <a href="controllerdevicegroup.html"><code>ControllerDeviceGroup</code></a> to show the connection between the controller and its managed devices.</p>
7678
+ <p>Key Features:</p>
7874
7679
  <ul>
7875
- <li><strong>Flexible Modeling:</strong> Fits various network management scenarios, including SDN controllers, wireless controllers, and cloud-based services.</li>
7680
+ <li><strong>Versatile Modeling:</strong> Suitable for a variety of controllers including Cisco ACI, Juniper MIST, Arista CloudVision, Meraki, and more.</li>
7876
7681
  <li><strong>Device Management:</strong> Allows for the representation of relationships between controllers and the devices or device groups they manage.</li>
7877
7682
  <li><strong>Inventory Queries:</strong> Simplifies finding devices or groups managed by a specific controller, enhancing visibility and management.</li>
7878
7683
  </ul>
7879
- <h2 id="use-cases">Use Cases<a class="headerlink" href="#use-cases" title="Permanent link">&para;</a></h2>
7880
- <p>These models support the representation of various use cases, including, but not limited to:</p>
7881
- <ul>
7882
- <li>Cisco ACI</li>
7883
- <li>Panorama</li>
7884
- <li>Juniper MIST</li>
7885
- <li>Arista CloudVision</li>
7886
- <li>Meraki</li>
7887
- <li>Wireless Controllers (e.g., Ruckus, Cisco)</li>
7888
- <li>OpenStack</li>
7889
- </ul>
7890
- <p><strong>Using controllers enables answering inventory-related queries:</strong></p>
7891
- <p>Find the controller for the given device group:</p>
7892
- <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">controller_managed_device_group_name</span> <span class="o">=</span> <span class="s2">&quot;DC-East-APIC&quot;</span>
7893
- <a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="n">controller</span> <span class="o">=</span> <span class="n">ControllerManagedDeviceGroup</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="n">controller_managed_device_group_name</span><span class="p">)</span><span class="o">.</span><span class="n">controller</span>
7894
- </code></pre></div>
7895
- <p>Find the controller for the given device:</p>
7896
- <div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="n">device_name</span> <span class="o">=</span> <span class="s2">&quot;DC-East-APIC-1&quot;</span>
7897
- <a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="n">controller</span> <span class="o">=</span> <span class="n">Device</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="n">device_name</span><span class="p">)</span><span class="o">.</span><span class="n">controller_managed_device_group</span><span class="o">.</span><span class="n">controller</span>
7898
- </code></pre></div>
7899
- <p>List device groups managed by the controller:</p>
7900
- <div class="highlight"><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="n">controller_name</span> <span class="o">=</span> <span class="s2">&quot;Cisco ACI APIC - east&quot;</span>
7901
- <a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="n">device_groups</span> <span class="o">=</span> <span class="n">ControllerManagedDeviceGroup</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="n">controller__name</span><span class="o">=</span><span class="n">controller_name</span><span class="p">)</span>
7902
- <a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="n">device_groups</span><span class="o">.</span><span class="n">count</span><span class="p">()</span>
7903
- </code></pre></div>
7904
- <p>List devices managed by the controller:</p>
7905
- <div class="highlight"><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="n">controller_name</span> <span class="o">=</span> <span class="s2">&quot;Cisco ACI APIC - east&quot;</span>
7906
- <a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="n">devices</span> <span class="o">=</span> <span class="n">Device</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="n">controller_managed_device_group__controller__name</span><span class="o">=</span><span class="n">controller_name</span><span class="p">)</span>
7907
- <a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="n">devices</span><span class="o">.</span><span class="n">count</span><span class="p">()</span>
7908
- </code></pre></div>
7909
- <h2 id="base-fields">Base Fields<a class="headerlink" href="#base-fields" title="Permanent link">&para;</a></h2>
7910
- <p>A controller is identified by a unique <code>name</code> and can include a <code>description</code>.</p>
7911
- <h2 id="related-models">Related Models<a class="headerlink" href="#related-models" title="Permanent link">&para;</a></h2>
7912
- <p>A controller can be deployed to either an individual <a href="device.html">Device</a> or to a group of devices defined as a <a href="deviceredundancygroup.html">Device Redundancy Group</a> via <code>controller_device</code> or <code>controller_device_redundancy_group</code> fields. These fields are mutually exclusive.</p>
7913
- <p>Each controller can also be connected to a <a href="platform.html">Platform</a> and a specific <a href="../../platform-functionality/externalintegration.html">External Integration</a> to define its connection to an external system.</p>
7914
- <p>A specific <a href="../../platform-functionality/status.html">Status</a> and <a href="location.html">Location</a> are required for each controller.</p>
7915
- <p>For better organization and categorization, a <a href="../../platform-functionality/role.html">Role</a>, <a href="../tenancy/tenant.html">Tenant</a> or <a href="../../platform-functionality/tag.html">tags</a> can be assigned to the controller.</p>
7916
- <p><a href="controllermanageddevicegroup.html">Controller Managed Device Group</a> represents the connection between the controller and devices it manages. It allows for the organization of controlled devices into hierarchical groups for structured representation.</p>
7917
- <p>For more detailed information about model relations, please refer to the <a href="../../../development/core/controllers.html">developer documentation</a>.</p>
7918
- <h2 id="examples">Examples<a class="headerlink" href="#examples" title="Permanent link">&para;</a></h2>
7919
- <h3 id="cisco-aci">Cisco ACI<a class="headerlink" href="#cisco-aci" title="Permanent link">&para;</a></h3>
7920
- <div class="highlight"><pre><span></span><code><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Cisco ACI APIC - east</span>
7921
- <a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="nt">status</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Active</span>
7922
- <a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="nt">controller_device</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DC-East-APIC-1</span>
7923
- <a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="nt">location</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">DC-East</span>
7924
- <a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="nt">platform</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">cisco_apic</span>
7925
- </code></pre></div>
7926
- <h3 id="cisco-meraki">Cisco Meraki<a class="headerlink" href="#cisco-meraki" title="Permanent link">&para;</a></h3>
7927
- <div class="highlight"><pre><span></span><code><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Cisco Meraki SAAS</span>
7928
- <a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="nt">status</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Active</span>
7929
- <a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="nt">controller_device</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">~</span>
7930
- <a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="nt">location</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Cloud Location</span>
7931
- <a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="nt">platform</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">cisco_meraki</span>
7932
- </code></pre></div>
7684
+ <p>For more detailed information about controllers, please refer to the <a href="../../../development/core/controllers.html">developer documentation</a>.</p>
7933
7685
 
7934
7686
 
7935
7687
 
@@ -7976,13 +7728,13 @@
7976
7728
 
7977
7729
 
7978
7730
 
7979
- <a href="controllermanageddevicegroup.html" class="md-footer__link md-footer__link--next" aria-label="Next: Controller Managed Device Group">
7731
+ <a href="controllerdevicegroup.html" class="md-footer__link md-footer__link--next" aria-label="Next: Controller Device Group">
7980
7732
  <div class="md-footer__title">
7981
7733
  <span class="md-footer__direction">
7982
7734
  Next
7983
7735
  </span>
7984
7736
  <div class="md-ellipsis">
7985
- Controller Managed Device Group
7737
+ Controller Device Group
7986
7738
  </div>
7987
7739
  </div>
7988
7740
  <div class="md-footer__button md-icon">
@@ -8,7 +8,7 @@
8
8
 
9
9
 
10
10
 
11
- <link rel="canonical" href="https://docs.nautobot.com/projects/core/en/stable/user-guide/core-data-model/dcim/controllermanageddevicegroup.html">
11
+ <link rel="canonical" href="https://docs.nautobot.com/projects/core/en/stable/user-guide/core-data-model/dcim/controllerdevicegroup.html">
12
12
 
13
13
 
14
14
  <link rel="prev" href="controller.html">
@@ -22,7 +22,7 @@
22
22
 
23
23
 
24
24
 
25
- <title>Controller Managed Device Group - Nautobot Documentation</title>
25
+ <title>Controller Device Group - Nautobot Documentation</title>
26
26
 
27
27
 
28
28
 
@@ -78,7 +78,7 @@
78
78
  <div data-md-component="skip">
79
79
 
80
80
 
81
- <a href="#controller-managed-device-groups" class="md-skip">
81
+ <a href="#controller-device-groups" class="md-skip">
82
82
  Skip to content
83
83
  </a>
84
84
 
@@ -113,7 +113,7 @@
113
113
  <div class="md-header__topic" data-md-component="header-topic">
114
114
  <span class="md-ellipsis">
115
115
 
116
- Controller Managed Device Group
116
+ Controller Device Group
117
117
 
118
118
  </span>
119
119
  </div>
@@ -688,27 +688,6 @@
688
688
 
689
689
 
690
690
 
691
- <li class="md-nav__item">
692
- <a href="../../administration/installation/health-checks.html" class="md-nav__link">
693
-
694
-
695
- <span class="md-ellipsis">
696
- Health Checks
697
- </span>
698
-
699
-
700
- </a>
701
- </li>
702
-
703
-
704
-
705
-
706
-
707
-
708
-
709
-
710
-
711
-
712
691
  <li class="md-nav__item">
713
692
  <a href="../../administration/installation/selinux-troubleshooting.html" class="md-nav__link">
714
693
 
@@ -1914,7 +1893,7 @@
1914
1893
 
1915
1894
 
1916
1895
  <li class="md-nav__item">
1917
- <a href="../../feature-guides/contacts-and-teams.html" class="md-nav__link">
1896
+ <a href="../../feature-guides/contact-and-team.html" class="md-nav__link">
1918
1897
 
1919
1898
 
1920
1899
  <span class="md-ellipsis">
@@ -3192,55 +3171,16 @@
3192
3171
 
3193
3172
 
3194
3173
 
3195
- <label class="md-nav__link md-nav__link--active" for="__toc">
3196
-
3197
-
3198
- <span class="md-ellipsis">
3199
- Controller Managed Device Group
3200
- </span>
3201
-
3202
-
3203
- <span class="md-nav__icon md-icon"></span>
3204
- </label>
3205
-
3206
- <a href="controllermanageddevicegroup.html" class="md-nav__link md-nav__link--active">
3174
+ <a href="controllerdevicegroup.html" class="md-nav__link md-nav__link--active">
3207
3175
 
3208
3176
 
3209
3177
  <span class="md-ellipsis">
3210
- Controller Managed Device Group
3178
+ Controller Device Group
3211
3179
  </span>
3212
3180
 
3213
3181
 
3214
3182
  </a>
3215
3183
 
3216
-
3217
-
3218
- <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
3219
-
3220
-
3221
-
3222
-
3223
-
3224
-
3225
- <label class="md-nav__title" for="__toc">
3226
- <span class="md-nav__icon md-icon"></span>
3227
- Table of contents
3228
- </label>
3229
- <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
3230
-
3231
- <li class="md-nav__item">
3232
- <a href="#examples" class="md-nav__link">
3233
- <span class="md-ellipsis">
3234
- Examples
3235
- </span>
3236
- </a>
3237
-
3238
- </li>
3239
-
3240
- </ul>
3241
-
3242
- </nav>
3243
-
3244
3184
  </li>
3245
3185
 
3246
3186
 
@@ -7715,23 +7655,6 @@
7715
7655
 
7716
7656
 
7717
7657
 
7718
- <label class="md-nav__title" for="__toc">
7719
- <span class="md-nav__icon md-icon"></span>
7720
- Table of contents
7721
- </label>
7722
- <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
7723
-
7724
- <li class="md-nav__item">
7725
- <a href="#examples" class="md-nav__link">
7726
- <span class="md-ellipsis">
7727
- Examples
7728
- </span>
7729
- </a>
7730
-
7731
- </li>
7732
-
7733
- </ul>
7734
-
7735
7658
  </nav>
7736
7659
  </div>
7737
7660
  </div>
@@ -7748,29 +7671,16 @@
7748
7671
 
7749
7672
 
7750
7673
 
7751
- <h1 id="controller-managed-device-groups">Controller Managed Device Groups<a class="headerlink" href="#controller-managed-device-groups" title="Permanent link">&para;</a></h1>
7752
- <p>A Controller Managed Device Group in Nautobot models the relationship between <a href="controller.html">controllers</a> and the <a href="device.html">devices</a> they manage.</p>
7753
- <p>Each device can be assigned to only one Controller Managed Device Group through the <code>Device.controller_managed_device_group</code> field.</p>
7754
- <p>Similarly, each group is linked directly to a Controller via the <code>ControllerManagedDeviceGroup.controller</code> field. This link represents the control connection between the controller and the devices in the group.</p>
7755
- <p>Groups can be arranged in a hierarchical structure. The <code>ControllerManagedDeviceGroup.parent</code> field is used to depict this tree structure of the controlled devices. To organize child groups within a parent group, use the <code>ControllerManagedDeviceGroup.weight</code> field. All child groups must be assigned to the same controller as the parent group.</p>
7756
- <p>For more detailed information about model relations, please refer to the <a href="../../../development/core/controllers.html">developer documentation</a>.</p>
7757
- <h2 id="examples">Examples<a class="headerlink" href="#examples" title="Permanent link">&para;</a></h2>
7758
- <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">controller_managed_device_group</span><span class="p">:</span>
7759
- <a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">campus</span>
7760
- <a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="w"> </span><span class="nt">controller</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Panorama1</span>
7761
- <a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="w"> </span><span class="nt">tags</span><span class="p">:</span>
7762
- <a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">high_security</span>
7763
- <a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="w"> </span><span class="nt">devices</span><span class="p">:</span>
7764
- <a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">dal-fw01</span>
7765
- <a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">chi-fw01</span>
7766
- <a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">dc</span>
7767
- <a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="w"> </span><span class="nt">controller</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Panorama1</span>
7768
- <a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="w"> </span><span class="nt">tags</span><span class="p">:</span>
7769
- <a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">medium_security</span>
7770
- <a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="w"> </span><span class="nt">devices</span><span class="p">:</span>
7771
- <a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">nyc-fw99</span>
7772
- <a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">jcy-fw99</span>
7773
- </code></pre></div>
7674
+ <h1 id="controller-device-groups">Controller Device Groups<a class="headerlink" href="#controller-device-groups" title="Permanent link">&para;</a></h1>
7675
+ <p>A Controller Device Group in Nautobot models the relationship between <a href="controller.html">controllers</a> and the <a href="device.html">devices</a> they manage. It organizes devices under specific controllers, providing a structured way to represent devices controlled by a central network management system. These systems might include, but are not limited to, software-defined networking (SDN) controllers, wireless controllers, and cloud-based network management platforms.</p>
7676
+ <p>The relationship between a Controller Device Group, its controllers, and devices is key to managing and visualizing how devices are grouped and controlled. This model allows devices to be categorized into hierarchical groups, making it easier to manage large networks. Each group is directly associated with a Controller, symbolizing the control link between the controller and the devices within the group.</p>
7677
+ <p>Key Features:</p>
7678
+ <ul>
7679
+ <li><strong>Structured Organization:</strong> Facilitates the grouping of devices under specific controllers, simplifying management tasks.</li>
7680
+ <li><strong>Flexible Modeling:</strong> Fits various network management scenarios, including SDN controllers, wireless controllers, and cloud-based services.</li>
7681
+ <li><strong>Enhanced Management:</strong> Improves the representation of device-controller relationships, aiding in more efficient network management operations.</li>
7682
+ </ul>
7683
+ <p>For more detailed information about controllers, please refer to the <a href="../../../development/core/controllers.html">developer documentation</a>.</p>
7774
7684
 
7775
7685
 
7776
7686
 
@@ -688,27 +688,6 @@
688
688
 
689
689
 
690
690
 
691
- <li class="md-nav__item">
692
- <a href="../../administration/installation/health-checks.html" class="md-nav__link">
693
-
694
-
695
- <span class="md-ellipsis">
696
- Health Checks
697
- </span>
698
-
699
-
700
- </a>
701
- </li>
702
-
703
-
704
-
705
-
706
-
707
-
708
-
709
-
710
-
711
-
712
691
  <li class="md-nav__item">
713
692
  <a href="../../administration/installation/selinux-troubleshooting.html" class="md-nav__link">
714
693
 
@@ -1914,7 +1893,7 @@
1914
1893
 
1915
1894
 
1916
1895
  <li class="md-nav__item">
1917
- <a href="../../feature-guides/contacts-and-teams.html" class="md-nav__link">
1896
+ <a href="../../feature-guides/contact-and-team.html" class="md-nav__link">
1918
1897
 
1919
1898
 
1920
1899
  <span class="md-ellipsis">
@@ -3185,11 +3164,11 @@
3185
3164
 
3186
3165
 
3187
3166
  <li class="md-nav__item">
3188
- <a href="controllermanageddevicegroup.html" class="md-nav__link">
3167
+ <a href="controllerdevicegroup.html" class="md-nav__link">
3189
3168
 
3190
3169
 
3191
3170
  <span class="md-ellipsis">
3192
- Controller Managed Device Group
3171
+ Controller Device Group
3193
3172
  </span>
3194
3173
 
3195
3174
 
@@ -688,27 +688,6 @@
688
688
 
689
689
 
690
690
 
691
- <li class="md-nav__item">
692
- <a href="../../administration/installation/health-checks.html" class="md-nav__link">
693
-
694
-
695
- <span class="md-ellipsis">
696
- Health Checks
697
- </span>
698
-
699
-
700
- </a>
701
- </li>
702
-
703
-
704
-
705
-
706
-
707
-
708
-
709
-
710
-
711
-
712
691
  <li class="md-nav__item">
713
692
  <a href="../../administration/installation/selinux-troubleshooting.html" class="md-nav__link">
714
693
 
@@ -1914,7 +1893,7 @@
1914
1893
 
1915
1894
 
1916
1895
  <li class="md-nav__item">
1917
- <a href="../../feature-guides/contacts-and-teams.html" class="md-nav__link">
1896
+ <a href="../../feature-guides/contact-and-team.html" class="md-nav__link">
1918
1897
 
1919
1898
 
1920
1899
  <span class="md-ellipsis">
@@ -3195,11 +3174,11 @@
3195
3174
 
3196
3175
 
3197
3176
  <li class="md-nav__item">
3198
- <a href="controllermanageddevicegroup.html" class="md-nav__link">
3177
+ <a href="controllerdevicegroup.html" class="md-nav__link">
3199
3178
 
3200
3179
 
3201
3180
  <span class="md-ellipsis">
3202
- Controller Managed Device Group
3181
+ Controller Device Group
3203
3182
  </span>
3204
3183
 
3205
3184