Docs

Assets

An asset is a junction between a BOM and an individual NetBox object (a rack, device, module, or cable) gathered by the BOM's scope rules. The set of assets is a point-in-time snapshot of the BOM's scope: it is cleared and rebuilt each time the BOM is regenerated.

Assets are also used to track installation. Once equipment has been received, each asset may be linked to the shipment that delivered the item it represents, or to the spares pool it was pulled from to fulfill it. The pool - rather than the individual spare item consumed - is recorded, so the provenance survives even after that spare is drawn down and removed from inventory. The link is retained after installation so the asset's procurement provenance - the BOM, and (via the shipment) the purchase order through which it was acquired - can be traced for posterity. Installed devices, racks, modules, and cables surface this in a Procurement panel on their detail page.

Fields

BOM

The BOM which includes this asset in its scope.

Assigned Object Type

The content type of the referenced NetBox object. One of dcim.rack, dcim.device, dcim.module, or dcim.cable.

Assigned Object ID

The primary key of the referenced object within its type.

Shipment

The shipment that delivered the equipment installed as this asset. Optional. Mutually informative with Spares Pool - only one is set for any given installed asset.

Spares Pool

The spares pool a spare was drawn from to fulfill this asset from existing inventory. Optional. The originating pool is recorded rather than the specific spare item consumed, so the link persists even if that spare is later removed from inventory.

Installed

The date and time at which the asset was installed (i.e. first sourced from a shipment or spares pool). Set automatically when a Shipment or Spares Pool is assigned, and cleared if that link is later removed. Read-only.

On this page