Skip to main content

A Netbox plugin that supports Virtual Circuit

Project description

NetBox Virtual Circuit Plugin

A plugin for NetBox that supports Virtual Circuit management.

Definitions

A Virtual Circuit is a circuit created by routing two or more VLANs together.

Each Virtual Circuit is identified by a name, a numeric ID (0-32767), along with a context. Each Virtual Circuit must be assigned one of the following operational statuses:

  • Pending Configuration
  • Configured
  • Pending Deletion
  • Configuration Error

When a VLAN is assigned to a Virtual Circuit, it can not exist in another Virtual Circuit without first being removed.

Installing

pip install netbox-virtual-circuit-plugin

Using

Once the plugin is installed correctly as guided here, one can find the Virtual Circuit section under Plugins navigation tab via NetBox UI that is ready to use with correct admin permission.

As for REST API use cases, the 2 group endpoints are exposed at:

  • /api/plugins/virtual-circuit/virtual-circuits
  • /api/plugins/virtual-circuit/vlans

While the former one is for creating/retrieving/modifying/deleting Virtual Circuits, the later one is for assigning and managing Virtual-Circuit-to-VLAN connections. For more information, refer to /api/docs as it also conforms to Swagger Specification for hosted visual documentations.

Developing

Plugins are essentially self-contained Django apps which integrate with NetBox to provide custom functionality. For more information, see NetBox documentation.

Contributing

If you experience a bug, would like to ask a question, or request a feature, open a new issue and provide as much context as possible. All contributions, questions, and feedback are welcomed and appreciated.

License

NetBox Virtual Circuit Plugin is licensed under GPLv3. See LICENSE for more info.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

netbox-virtual-circuit-plugin-0.1.0.tar.gz (4.2 kB view details)

Uploaded Source

Built Distribution

File details

Details for the file netbox-virtual-circuit-plugin-0.1.0.tar.gz.

File metadata

  • Download URL: netbox-virtual-circuit-plugin-0.1.0.tar.gz
  • Upload date:
  • Size: 4.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.2.0 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.7.7

File hashes

Hashes for netbox-virtual-circuit-plugin-0.1.0.tar.gz
Algorithm Hash digest
SHA256 fc358ff50ddef9b1269a3761e407f6f8bf61a5acd86b78682be5f657bbf49dc9
MD5 0a8c74e7641ea291195c95b7425b0373
BLAKE2b-256 c7989ed811239a274fcf72278f32f7637e1cdda1bc7f88f09076b99215d31f58

See more details on using hashes here.

Provenance

File details

Details for the file netbox_virtual_circuit_plugin-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: netbox_virtual_circuit_plugin-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 19.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.2.0 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.7.7

File hashes

Hashes for netbox_virtual_circuit_plugin-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1f3cf3fc6dec660583313c19e77184cdfa95414bef45fc92c0ac19dc00f67d30
MD5 63f10efb996b90e7de88bce5c0a1c654
BLAKE2b-256 458134c57bb2e1b532ca888bc314d5aa471c8d60722ca6fec14dccb2d2e2978e

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page