Quality of Service (QoS) profiles

Oftentimes, it is necessary to manage or prioritize certain connectivity characteristics over a wide area network (WAN). Network-as-Code Quality-of-service on Demand (QoD) or QoS (CAMARA) profiles allow establishing these prioritized connections between devices or services and request on-demand capabilities from the network. Read more about it on the "What is Quality of Service (QoS)?" section.

Network-as-Code QoS profiles

You can choose the amount of bandwidth with an up/downlink profile label, according to your current demand. These are the specific Network-as-Code QoS profiles labels and their brief description:

NOTE: In each case, the network connection is given priority, which means that the network will aim at maintaining a stable connection at the desired level.

CAMARA QoS profiles

QoD Sessions also support the CAMARA QoS profile labels.

NOTE: You can learn more specifically about each label or its possible constraints here.

These are the currently available ones:

Good to know: The 5G System throughput refers to the ratio of data that can be transmitted in units of time, for example, bits per second(bps). In this case, a maximum throughput refers to a maximum rate at which data will be transmitted.

Using CAMARA QoS profile labels

import network_as_code as nac
 
from network_as_code.models.device import Device, DeviceIpv4Addr
 
client = nac.NetworkAsCodeClient(...)
 
device = client.devices.get(...)
 
# Here you can create a QoD session, identify the service IP address(es) and the network profile
session = device.create_qod_session(
	service_ipv4="233.252.0.2",
	service_ipv6="2001:db8:1234:5678:9abc:def0:fedc:ba98",
	profile="QOS_L"
)
 
# Show a list of all of the QoD sessions associated with a device
print(device.sessions())

Session parameters

What we've just done is instruct Network as Code to set up a session between the device and the service identified by the IP addresses with the CAMARA QoS profile. Then, printing the device.sessions() method will show a list of all of the QoD sessions that have been created for a specific device. Here are the parameters used:

Keywords:

If you want to create the QoD session object without passing its parameters by name (keywords), then remember that their ordering will be important for your code to work properly. In which case, you will need to inform the QoS profile first, before the IP address(es). For example:

session = device.create_qod_session("QOS_L", "233.252.0.2", "2001:db8:1234:5678:9abc:def0:fedc:ba98")

Note that the snippets above assume you have already created a QoD session before, which you can learn how to do here. It also implies that you have already created a Network-as-Code client and identified your mobile network device.