A collection of community-sourced DeviceType definitions for import to NetBox
Go to file
Mark Tinberg 784aad457f
Add Cisco Nexus 77xx family Chassis (#268)
* Add Cisco Nexus 77xx family Chassis
2020-12-02 21:34:52 -05:00
.github/workflows Enable GitHub actions 2019-12-19 11:33:07 -05:00
device-types Add Cisco Nexus 77xx family Chassis (#268) 2020-12-02 21:34:52 -05:00
tests Add duplicate component test 2020-11-24 13:10:31 -06:00
.gitignore ignore .DS_Store 2020-01-02 17:39:35 -05:00
CONTRIBUTING.md Closes #27: Check that definition files end with a blank line 2019-12-30 10:11:25 -05:00
LICENSE.txt Add license (Creative Commons Zero v1.0 Universal) 2019-09-25 14:14:34 -04:00
README.md Update README and contributing guide 2019-12-26 11:14:59 -05:00
requirements.txt Introduced unit tests for definition files 2019-12-19 10:22:26 -05:00

About this Library

This library is intended to be used for populating device types in NetBox version 2.7 or later. It contains a set of device type definitions expressed in YAML and arranged by manufacturer. Each file represents a discrete physical device type (e.g. make and model). These definitions can be loaded into NetBox to obviate the need to create device types and their associated components manually.

If you would like to contribute to this library, please read through our contributing guide before submitting content.

Device Type Definitions

Each definition must include at minimum the following fields:

  • manufacturer: The name of the manufacturer which produces this device type.
  • model: The model number of the device type. This must be unique per manufacturer.
  • slug: A URL-friendly representation of the model number. Like the model number, this must be unique per manufacturer.

The following fields may optionally be declared:

  • part_number: An alternative representation of the model number (e.g. a SKU).
  • u_height: The height of the device type in rack units. (Default: 1)
  • is_full_depth: A boolean which indicates whether the device type consumes both the front and rear rack faces. (Default: true)
  • subdevice_role: Indicates that this is a parent or child device. (Default: None)

For further detail on these attributes and those listed below, please reference the schema definition.

Component Definitions

Valid component types are listed below. Each type of component must declare a list of the individual component templates to be added.

  • console-ports
  • console-server-ports
  • power-ports
  • power-outlets
  • interfaces
  • rear-ports
  • front-ports
  • device-bays

The available fields for each type of component are listed below.

Console Ports

  • name: Port name
  • type: Port type slug (API value)

Console Server Ports

  • name: Port name
  • type: Port type slug (API value)

Power Ports

  • name: Port name
  • type: Port type slug (API value)
  • maximum_draw: The port's maximum power draw, in watts (optional)
  • allocated_draw: The port's allocated power draw, in watts (optional)

Power Outlets

  • name: Outlet name
  • type: Port type slug (API value)
  • power_port: The name of the power port on the device which powers this outlet (optional)
  • feed_leg: The phase (leg) of power to which this outlet is mapped; A, B, or C (optional)

Interfaces

  • name: Interface name
  • type: Interface type slug (API value)
  • mgmt_only: A boolean which indicates whether this interface is used for management purposes only (default: false)

Front Ports

  • name: Port name
  • type: Port type slug (API value)
  • rear_port: The name of the rear port on this device to which the front port maps
  • rear_port_position: The corresponding position on the mapped rear port (default: 1)

Rear Ports

  • name: Port name
  • type: Port type slug (API value)
  • positions: The number of front ports that can map to this rear port (default: 1)

Device Bays

  • name: Bay name