Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


  • A LabelResourceAdminService provides services for administrators to interact with the inventory of label resource pools.
  • A LabelResourceService provide services for applications to apply, release and query labels.
  • LabelResourceManager manages interface with multiple Providers via a LabelResourceProviderService interface and multiple listeners via a LabelResourceService interface
  • LabelResourceProviders supports their own network protocol libraries or ways to interface with the network
  • LabelResourceStore tracks LabelResourcPool model objects and generates LabelResourceEvent.


Programming APIs for ONOS applications

The labels are provided in ONOS as a common system resource. Independent applications use the label resource through calling ONOS northbound APIs.

Meanwhile, ONOS provides southbound label APIs for device driver to communicate with ONOS.

There are two ways to create a device’s initial label resource pool, i.e., device upload and admin planned. Firstly, a device driver can call southbound API deviceLabelResourcePoolDetected to upload its local labels to ONOS. The other way is by planning labels when deploying ONOS. After planned label ranges for each device, the network administrative application calls northbound API createDevicePool to create label pool for the device. The admin planned labels will overwrite any reported labels from device. The global labels are always created by admin application via calling createGlobalPool.

Once the label pools are created, customer applications can use the label resource via calling ONOS’s northbound APIs. An applications calls getDeviceLabelResourcePool to get the device label resource pool, or getGlobalLabelResourcePool to get the global label resource pool, then call applyFromDevicePool or applyFromGlobalPool to require label from the device label pool or global label pool. Before requiring a label, application has chance to check label resource’s status in ONOS. For example, calling isDevicePoolFull to check is there is any labels available in the pool, or calling getFreeNumOfDevicePool to get current unused labels in the pool. After using the labels, application should return the labels to ONOS label pool by calling releaseToDevicePool or releaseToGlobalPool.

The followings list current APIs available in ONOS.

Southbound APIs


  • deviceLabelResourcePoolDetected :Signal that a device label resource pool has been detected and upload labels to ONOS.
  • deviceLabelResourcePoolDestroyed :Signal that an label resource pool has been destroyed.

Northbound APIs


  • createDevicePool Create device label resource from begin label to end label.
  • createGlobalPool Create the global label resource pool.
  • destroyDevicePool Destroy a device label resource pool.
  • destroyGlobalPool Destroy the global label resource pool.


  • applyFromDevicePool Apply labels from a device resource pool.
  • applyFromGlobalPool Apply labels from the global label resource pool.
  • releaseToDevicePool Release labels to device pools .
  • releaseToGlobalPool Release labels to the global resource pool.
  • isDevicePoolFull Check if a device pool is full.
  • isGlobalPoolFull Check if the global resource pool is full.
  • getFreeNumOfDevicePool Get unused label number of a device label resource pool.
  • getFreeNumOfGlobalPool Get unused label number of the global label resource pool.
  • getDeviceLabelResourcePool Get a device label resource pool.
  • getGlobalLabelResourcePool Get the global label resource pool.

Label management CLI commands

Besides APIs, ONOS provides CLI commands for label usage and management purpose. Administrators can use CLI commands to interact with the inventory of label resource pools. Currently ONOS supports the following CLI commands:

  • label-apply Apply label resource from device pool by specific device id
  • global-label-apply Apply global labels from global resource pool
  • label-pool-create Creates label resource pool by a specific device id
  • global-label-pool-create Creates global label resource pool.
  • label-pool-destroy Destroys label resource pool by a specific device id
  • global-label-pool-destroy Destroys global label resource pool
  • global-label-pool Gets global label resource pool information.
  • label-pool Gets label resource pool information by a specific device id
  • global-label-release Releases labels to global label resource pool.
  • label-release Releases label ids to label resource pool by a specific device id