5.14 AsSessionWithQoS API

29.1223GPPRelease 18T8 reference point for Northbound APIsTS

5.14.1 Overview

The AsSessionWithQoS API is a RESTful API that allows the SCS/AS to set up a session with SCEF with required QoS based on the application and service requirement. The AsSessionWithQoS API defines a set of data models, resources and the related procedures for the creation and management of the AS sessions with required QoS. The corresponding JSON schema for the representation of the resources and operations defined by the AsSessionWithQoS API is provided in its complete form in Annex A.14.

5.14.2 Data model

5.14.2.1 Resource data types

5.14.2.1.1 Introduction

This clause defines data structures to be used in resource representations, including subscription resources.

Table 5.14.2.1.1-1 specifies data types re-used by the AsSessionWithQoS API from other specifications, including a reference to their respective specifications and when needed, a short description of their use within the AsSessionWithQoS API.

Table 5.14.2.1.1-1: AsSessionWithQoS API re-used Data Types

Data type

Reference

Comments

AlternativeServiceRequirementsData

3GPP TS 29.514 [52]

Contains alternative QoS related parameters and a reference to them.

BitRate

3GPP TS 29.571 [45]

String representing a bit rate that shall be formatted as follows:

Pattern: ‘^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$’

Examples:

"125 Mbps", "0.125 Gbps", "125000 Kbps"

BitRateRm

3GPP TS 29.571 [45]

This data type is defined in the same way as the "BitRate" data type, but with the OpenAPI "nullable: true" property.

Dnn

3GPP TS 29.571 [45]

Identifies a DNN.

EthFlowDescription

3GPP TS 29.514 [52]

Defines a packet filter for an Ethernet flow.(NOTE 1)

ExtMaxDataBurstVol

3GPP TS 29.571 [45]

Unsigned integer indicating Maximum Data Burst Volume (see clauses 5.7.3.7 and 5.7.4 of 3GPP TS 23.501 [8]), expressed in Bytes.

Minimum = 4096. Maximum = 2000000.

ExtMaxDataBurstVolRm

3GPP TS 29.571 [45]

This data type is defined in the same way as the "ExtMaxDataBurstVol" data type, but with the OpenAPI "nullable: true" property.

IpAddr

3GPP TS 29.571 [45]

UE IP Address.

MacAddr48

3GPP TS 29.571 [45]

MAC Address.

PacketDelBudget

3GPP TS 29.571 [45]

Unsigned integer indicating Packet Delay Budget (see clauses 5.7.3.4 and 5.7.4 of 3GPP TS 23.501 [8])), expressed in milliseconds.

Minimum = 1.

PacketDelBudgetRm

3GPP TS 29.571 [45]

This data type is defined in the same way as the "PacketDelBudget" data type, but with the OpenAPI "nullable: true" property.

PlmnIdNid

3GPP TS 29.571 [45]

Identifies the network: the PLMN Identifier (the mobile country code and the mobile network code) or the SNPN Identifier (the PLMN Identifier and the NID).

RatType

3GPP TS 29.571 [45]

Identifies the RAT Type.

ReportingFrequency

3GPP TS 29.512 [8]

Indicates the frequency for the reporting, such as event triggered, periodic, when the PDU Session is released, and/or any combination. (NOTE 2)

RequestedQosMonitoringParameter

3GPP TS 29.512 [8]

Indicate the UL packet delay, DL packet delay or round trip packet delay between the UE and the UPF is to be monitored when the QoS Monitoring for URLLC is enabled for the service data flow. (NOTE 2)

Snssai

3GPP TS 29.571 [45]

Identifies the S-NSSAI.

SupportedFeatures

3GPP TS 29.571 [45]

Used to negotiate the applicability of the optional features defined in table 5.14.4-1.

TscaiInputContainer

3GPP TS 29.514 [52]

TSCAI Input information container.

TscPriorityLevel

3GPP TS 29.514 [52]

Represents priority of TSC Flows.

TscPriorityLevelRm

3GPP TS 29.514 [52]

Represents the same as the TscPriorityLevel data type, but with the OpenAPI "nullable: true" property.

Uinteger

3GPP TS 29.571 [45]

Unsigned Integer, i.e. only value 0 and integers above 0 are permissible.

Minimum = 0.

UintegerRm

3GPP TS 29.571 [45]

This data type is defined in the same way as the "Uinteger" data type, but with the OpenAPI "nullable: true" property.

NOTE 1: In order to support a set of MAC addresses with a specific range in the traffic filter, feature MacAddressRange_5G as specified in clause 5.14.4 shall be supported.

NOTE 2: In order to support QoS Monitoring, feature QoSMonitoring_5G as specified in clause 5.14.4 shall be supported.

Table 5.14.2.1.1-2 specifies the data types defined for the AsSessionWithQoS API.

Table 5.14.2.1.1-2: AsSessionWithQoS API specific Data Types

Data type

Clause defined

Description

Applicability

AsSessionWithQoSSubscription

5.14.2.1.2

Represents an individual AS session with required QoS subscription resource.

AsSessionWithQoSSubscriptionPatch

5.14.2.1.3

Represents parameters to modify an AS session with specific QoS subscription.

QosMonitoringInformation

5.14.2.1.6

Represents QoS monitoring information.

QoSMonitoring_5G

QosMonitoringInformationRm

5.14.2.1.7

Represents the same as the QosMonitoringInformation data type but with the "nullable: true" property.

QoSMonitoring_5G

QosMonitoringReport

5.14.2.1.8

Represents a QoS monitoring report.

QoSMonitoring_5G

TscQosRequirement

5.14.2.1.9

Represents QoS requirements for time sensitive communication.

TSC_5G

TscQosRequirementRm

5.14.2.1.10

Represents the same as the TscQosRequirement data type but with the "nullable: true" property.

TSC_5G

UserPlaneEvent

5.14.2.2.3

Represents the user plane event.

enNB

UserPlaneEventReport

5.14.2.1.5

Represents an event report for user plane.

enNB

UserPlaneNotificationData

5.14.2.1.4

Represents the parameters to be conveyed in a user plane event(s) notification.

enNB

5.14.2.1.2 Type: AsSessionWithQoSSubscription

This type represents an AS session request with specific QoS for the service provided by the SCS/AS to the SCEF via T8 interface. The structure is used for subscription request and response.

Table 5.14.2.1.2-1: Definition of type AsSessionWithQoSSubscription

Attribute name

Data type

Cardinality

Description

Applicability (NOTE 1)

self

Link

0..1

Link to the resource "Individual AS Session with Required QoS Subscription".

This parameter shall be supplied by the SCEF in HTTP responses.

dnn

Dnn

0..1

Identifies a DNN, a full DNN with both the Network Identifier and Operator Identifier, or a DNN with the Network Identifier only. (NOTE 3)

snssai

Snssai

0..1

Identifies an S-NSSAI. (NOTE 3)

supportedFeatures

SupportedFeatures

0..1

Used to negotiate the supported optional features of the API as described in clause 5.2.7.

This attribute shall be provided in the POST request and in the response of successful resource creation.

notificationDestination

Link

1

Contains the URL to receive the notification bearer level event(s) from the SCEF.

exterAppId

string

0..1

Identifies the external Application Identifier. (NOTE 2)

AppId

flowInfo

array(FlowInfo)

0..N

Describe the IP data flow which requires QoS.

(NOTE 2)

ethFlowInfo

array(EthFlowDescription)

0..N

Identifies Ethernet packet flows.

(NOTE 2) (NOTE 6)

EthAsSessionQoS_5G

enEthFlowInfo

array(EthFlowInfo)

0..N

Identifies the Ethernet flows which require QoS. Each Ethernet flow consists of a flow identifier and the corresponding UL and/or DL flows.

(NOTE 2) (NOTE 6)

EnEthAsSessionQoS_5G

qosReference

string

0..1

Identifies a pre-defined QoS information. (NOTE 5)

altQoSReferences

array(string)

0..N

Identifies an ordered list of pre-defined QoS information. The lower the index of the array for a given entry, the higher the priority. (NOTE 4)

AlternativeQoS_5G

altQosReqs

array(AlternativeServiceRequirementsData)

0..N

Identifies an ordered list of alternative service requirements that include individual QoS parameter sets. The lower the index of the array for a given entry, the higher the priority. (NOTE 4)

AltQosWithIndParams_5G

disUeNotif

boolean

0..1

Indicates whether to disable QoS flow parameters signalling to the UE when the SMF is notified by the NG-RAN of changes in the fulfilled QoS situation. The fulfilled situation is either the QoS profile or an Alternative QoS Profile.

– true: the QoS flow parameters signalling to the UE is disabled;

– false (default): the QoS flow parameters signalling to the UE is not disabled.

DisableUENotification_5G

ueIpv4Addr

Ipv4Addr

0..1

The Ipv4 address of the UE.

(NOTE 2)

ipDomain

string

0..1

The IPv4 address domain identifier.

The attribute may only be provided if the ueIpv4Addr attribute is present.

ueIpv6Addr

Ipv6Addr

0..1

The Ipv6 address of the UE.

(NOTE 2)

macAddr

MacAddr48

0..1

Identifies the MAC address.

(NOTE 2)

EthAsSessionQoS_5G

usageThreshold

UsageThreshold

0..1

Time period and/or traffic volume in which the QoS is to be applied.

sponsorInfo

SponsorInformation

0..1

Indicates a sponsor information

qosMonInfo

QosMonitoringInformation

0..1

Qos Monitoring information. It can be present when the event "QOS_MONITORING" is subscribed.

QoSMonitoring_5G

directNotifInd

boolean

0..1

Indicates whether the direct event notification is requested.

– true: the direct event notification is requested;

– false (default): the direct event notification is not requested.

ExposureToEAS

tscQosReq

TscQosRequirement

0..1

Contains the QoS requirements for time sensitive communication. (NOTE 5)

TSC_5G

requestTestNotification

boolean

0..1

Set to true by the SCS/AS to request the SCEF to send a test notification as defined in clause 5.2.5.3. Set to false or omitted otherwise.

Notification_test_event

websockNotifConfig

WebsockNotifConfig

0..1

Configuration parameters to set up notification delivery over Websocket protocol as defined in clause 5.2.5.4.

Notification_websocket

events

array(UserPlaneEvent)

0..N

Corresponds to the list of user plane event(s) to which the SCS/AS requests to subscribe to.

enNB

NOTE 1: Properties marked with a feature as defined in clause 5.14.4 are applicable as described in clause 5.2.7. If no features are indicated, the related property applies for all the features.

NOTE 2: One of "ueIpv4Addr", "ueIpv6Addr" or "macAddr" shall be included. If ipv4 or ipv6 address is provided, IP flow information shall be provided. If MAC address is provided and the AppId feature is not supported, Ethernet flow information (either "ethFlowInfo", or if the feature EnEthAsSessionQoS_5G is supported, "enEthFlowInfo")shall be provided. If the AppId feature is supported, one of IP flow information, Ethernet flow information (if EthAsSessionQoS_5G and/or EnEthAsSessionQoS_5G is supported) or External Application Identifier shall be provided.

NOTE 3: The property is only applicable for the NEF.

NOTE 4: The attributes "altQoSReferences" and "altQosReqs" are mutually exclusive. The attributes "qosReference" and "altQosReqs" are also mutually exclusive.

NOTE 5: The attributes "reqGbrDl", "reqGbrUl", "reqMbrDl", "reqMbrUl", "maxTscBurstSize", "req5Gsdelay", and "priority" within the "tscQosReq" attribute may be provided only if the "qosReference" attribute is not provided.

NOTE 6: When the Ethernet flow information is provided and, the EthAsSessionQoS_5G and EnEthAsSessionQoS_5G features are supported, either the "ethFlowInfo" or the "enEthFlowInfo" shall be provided, but not both simultenously.

5.14.2.1.3 Type: AsSessionWithQoSSubscriptionPatch

This type represents an AS session request with specific QoS for the service provided by the SCS/AS to the SCEF via T8 interface. The structure is used for PATCH request.

Table 5.14.2.1.3-1: Definition of type AsSessionWithQoSSubscriptionPatch

Attribute name

Data type

Cardinality

Description

Applicability (NOTE)

exterAppId

string

0..1

Identifies the external Application Identifier. (NOTE 2)

AppId

flowInfo

array(FlowInfo)

0..N

Describe the data flow which requires QoS. (NOTE 2)

ethFlowInfo

array(EthFlowDescription)

0..N

Describes Ethernet packet flows. (NOTE 2)

EthAsSessionQoS_5G

enEthFlowInfo

array(EthFlowInfo)

0..N

Identifies the Ethernet flows which require QoS. Each Ethernet flow consists of a flow identifier and the corresponding UL and/or DL flows.

(NOTE 2)

EnEthAsSessionQoS_5G

qosReference

string

0..1

Pre-defined QoS reference. (NOTE 3) (NOTE 4)

altQoSReferences

array(string)

0..N

Identifiers an ordered list of pre-defined QoS information. The lower the index of the array for a given entry, the higher the priority. (NOTE 3)

AlternativeQoS_5G

altQosReqs

array(AlternativeServiceRequirementsData)

1..N

Identifies an ordered list of alternative service requirements that include individual QoS parameter sets. The lower the index of the array for a given entry, the higher the priority. (NOTE 3)

AltQosWithIndParams_5G

disUeNotif

boolean

0..1

Indicates whether to disable QoS flow parameters signalling to the UE when the SMF is notified by the NG-RAN of changes in the fulfilled QoS situation. The fulfilled situation is either the QoS profile or an Alternative QoS Profile.

– true: the QoS flow parameters signalling to the UE is disabled;

– false: the QoS flow parameters signalling to the UE is not disabled.

DisableUENotification_5G

usageThreshold

UsageThresholdRm

0..1

Time period and/or traffic volume in which the QoS is to be applied.

qosMonInfo

QosMonitoringInformationRm

0..1

Qos Monitoring information. It can be present when the event "QOS_MONITORING" is subscribed.

QoSMonitoring_5G

directNotifInd

boolean

0..1

Indicates whether the direct event notification is requested.

– true: the direct event notification is requested;

– false: the direct event notification is not requested.

ExposureToEAS

tscQosReq

TscQosRequirementRm

0..1

Contains the QoS requirements for time sensitive communication. (NOTE 4)

TSC_5G

notificationDestination

Link

0..1

Contains the URL to receive the notification event(s) from the SCEF.

events

array(UserPlaneEvent)

0..N

Corresponds to the list of user plane event(s) to which the SCS/AS requests to subscribe to.

enNB

NOTE 1: Properties marked with a feature as defined in clause 5.14.4 are applicable as described in clause 5.2.7. If no features are indicated, the related property applies for all the features.

NOTE 2: One of "exterAppId", "flowInfo" or either "ethFlowInfo" or "enEthFlowInfo" may be provided.

NOTE 3 The attributes "altQoSReferences" and "altQosReqs" are mutually exclusive. The attributes "qosReference" and "altQosReqs" are also mutually exclusive.

NOTE 4: The attributes "reqGbrDl", "reqGbrUl", "reqMbrDl", "reqMbrUl", "maxTscBurstSize", "req5Gsdelay", and "priority" within the "tscQosReq" attribute may be provided only if the "qosReference" attribute is not provided.

5.14.2.1.4 Type: UserPlaneNotificationData

This type represents the parameters which shall be notify the SCS/AS for user plane event(s).

Table 5.14.2.1.4-1: Definition of the UserPlaneNotificationData data type

Attribute name

Data type

Cardinality

Description

transaction

Link

1

Link to the transaction resource to which this notification is related.

eventReports

array(UserPlaneEventReport)

1..N

Contains the reported event and applicable information

5.14.2.1.5 Type: UserPlaneEventReport

This type represents an event report for user plane. It shall comply with the provisions defined in table 5.14.2.1.5-1.

Table 5.14.2.1.5-1: Definition of the UserPlaneEventReport data type

Attribute name

Data type

Cardinality

Description

Applicability (NOTE)

event

UserPlaneEvent

1

Indicates the event reported by the SCEF.

accumulatedUsage

AccumulatedUsage

0..1

Contains the applicable information corresponding to the event.

flowIds

array(integer)

0..N

Identifies the affected flows that were sent during event subscription. It may be omitted when the reported event applies to all the flows sent during the subscription.

appliedQosRef

string

0..1

The currently applied QoS reference (or applied individual QoS parameter set, if AltQosWithIndParams_5G is supported). Applicable for event QOS_NOT_GUARANTEED or SUCCESSFUL_RESOURCES_ALLOCATION.

When it is omitted and the "event" attribute is QOS_NOT_GUARANTEED, the event report indicates that the lowest priority alternative QoS profile could not be fulfilled either.

AlternativeQoS_5G, AltQosWithIndParams_5G

plmnId

PlmnIdNid

0..1

PLMN Identifier or the SNPN Identifier.

It may be present when the reported event is "PLMN_CHG" and which is allowed to be exposured to the AF based on the local policy or local configuration.

enNB_5G

qosMonReports

array(QosMonitoringReport)

0..N

Contains the QoS Monitoring Reporting information.

QoSMonitoring_5G

ratType

RatType

0..1

RAT type may be present if applicable, when the notified event is "ACCESS_TYPE_CHANGE" and which is allowed to be exposured to the AF based on the local policy or local configuration.

enNB_5G

NOTE: Properties marked with a feature as defined in clause 5.14.4 are applicable as described in clause 5.2.7. If no features are indicated, the related property applies for all the features.

5.14.2.1.6 Type: QosMonitoringInformation

Table 5.14.2.1.6-1: Definition of type QosMonitoringInformation

Attribute name

Data type

Cardinality

Description

Applicability

reqQosMonParams

array(RequestedQosMonitoringParameter)

1..N

Indicates the UL packet delay, DL packet delay and/or round trip packet delay between the UE and the UPF is to be monitored when the QoS Monitoring for URLLC is enabled for the service data flow.

repFreqs

array(ReportingFrequency)

1..N

Indicates the frequency for the reporting, such as event triggered, periodic, when the PDU Session is released, and/or any combination.

repThreshDl

Uinteger

0..1

Unsigned integer identifying a threshold in units of milliseconds for DL packet delay. It shall be present when the "reqQosMonParams" attribute includes "DOWNLINK".

repThreshUl

Uinteger

0..1

Unsigned integer identifying a threshold in units of milliseconds for UL packet delay. It shall be present when the "reqQosMonParams" attribute includes "UPLINK".

repThreshRp

Uinteger

0..1

Unsigned integer identifying a threshold in units of milliseconds for round trip packet delay. It shall be present when the "reqQosMonParams" attribute includes "ROUND_TRIP".

waitTime

DurationSec

0..1

Indicates the minimum waiting time between subsequent reports. It shall be present when the "repFreqs" attribute includes "EVENT_TRIGGERED".

repPeriod

DurationSec

0..1

Indicates the time interval between successive reporting. It shall be present when the "repFreqs" attribute includes "PERIODIC".

5.14.2.1.7 Type: QosMonitoringInformationRm

This type represents a QoS Monitoring Information which is defined in clause 5.14.2.1.7 but defined with "nullable: true" property so it can be removed in "JSON Merge Patch", as defined in IETF RFC 7396 [39]. It shall comply with the provisions defined in table 5.14.2.1.7-1.

Duration and volume are also removable in "JSON Merge Patch".

Table 5.14.2.1.7-1: Definition of type QosMonitoringInformationRm

Attribute name

Data type

Cardinality

Description

Applicability

reqQosMonParams

array(RequestedQosMonitoringParameter)

0..N

Indicates the UL packet delay, DL packet delay and/or round trip packet delay between the UE and the UPF is to be monitored when the QoS Monitoring for URLLC is enabled for the service data flow.

repFreqs

array(ReportingFrequency)

0..N

Indicates the frequency for the reporting, such as event triggered, periodic, when the PDU Session is released, and/or any combination.

repThreshDl

UintegerRm

0..1

Unsigned integer identifying a threshold in units of milliseconds for DL packet delay. It shall be present when the "reqQosMonParams" attribute includes "DOWNLINK".

repThreshUl

UintegerRm

0..1

Unsigned integer identifying a threshold in units of milliseconds for UL packet delay. It shall be present when the "reqQosMonParams" attribute includes "UPLINK".

repThreshRp

UintegerRm

0..1

Unsigned integer identifying a threshold in units of milliseconds for round trip packet delay. It shall be present when the "reqQosMonParams" attribute includes "ROUND_TRIP".

waitTime

DurationSecRm

0..1

Indicates the minimum waiting time between subsequent reports. It shall be present when the "repFreqs" attribute includes "EVENT_TRIGGERED".

repPeriod

DurationSecRm

0..1

Indicates the time interval between successive reporting. It shall be present when the "repFreqs" attribute includes "PERIODIC".

5.14.2.1.8 Type: QosMonitoringReport

Table 5.14.2.1.8-1: Definition of type QosMonitoringReport

Attribute name

Data type

Cardinality

Description

Applicability

ulDelays

array(Uinteger)

0..N

Uplink packet delay in units of milliseconds. (NOTE)

dlDelays

array(Uinteger)

0..N

Downlink packet delay in units of milliseconds. (NOTE)

rtDelays

array(Uinteger)

0..N

Round trip delay in units of milliseconds. (NOTE)

NOTE: In this release of the specification the maximum number of elements in the array is 2.

5.14.2.1.9 Type: TscQosRequirement

Table 5.14.2.1.9-1: Definition of type TscQosRequirement

Attribute name

Data type

Cardinality

Description

Applicability

reqGbrDl

BitRate

0..1

Requested GBR in downlink.

reqGbrUl

BitRate

0..1

Requested GBR in uplink.

reqMbrDl

BitRate

0..1

Requested MBR in downlink.

reqMbrUl

BitRate

0..1

Requested MBR in uplink.

maxTscBurstSize

ExtMaxDataBurstVol

0..1

Maximum burst size of the TSC traffic in units of Bytes.
Minimum = 4096, Maximum = 2000000.

req5Gsdelay

PacketDelBudget

0..1

Requested Delay of the TSC traffic.

priority

TscPriorityLevel

0..1

Unsigned integer indicating the TSC traffic priority in relation to other TSC and non-TSC traffic.

tscaiTimeDom

Uinteger

0..1

Indicates the (g)PTP domain that the (TSN)AF is located in.

tscaiInputUl

TscaiInputContainer

0..1

Transports the input parameters for TSC traffic to construct the TSC Assistance Container in uplink direction.

tscaiInputDl

TscaiInputContainer

0..1

Transports the input parameters for TSC traffic to construct the TSC Assistance Container in downlink direction.

5.14.2.1.10 Type: TscQosRequirementRm

This data type is defined in the same way as the "TscQosRequirement" data type, but:

– the removable attributes "reqGbrDl", "reqGbrUl", "reqMbrDl" and "reqMbrUl" are defined with the removable data type "BitRateRm"; the removal attribute "tscaiTimeDom" is defined with the removal data type "UintegerRm", "priority" attribute is defined with the removal data type "TscPriorityLevelRm", "maxTscBurstSize" is defined with the removable data type "ExtMaxDataBurstVolRm"; "req5Gsdelay" is defined with the removable data type "PacketDelBudgetRm" in the OpenAPI.

Table 5.14.2.1.10-1: Definition of type TscQosRequirementRm

Attribute name

Data type

Cardinality

Description

Applicability

reqGbrDl

BitRateRm

0..1

Requested GBR in downlink.

reqGbrUl

BitRateRm

0..1

Requested GBR in uplink.

reqMbrDl

BitRateRm

0..1

Requested MBR in downlink.

reqMbrUl

BitRateRm

0..1

Requested MBR in uplink.

maxTscBurstSize

ExtMaxDataBurstVolRm

0..1

Maximum burst size of the TSC traffic in units of Bytes.
Minimum = 4096, Maximum = 2000000.

req5Gsdelay

PacketDelBudgetRm

0..1

Requested Delay of the TSC traffic.

priority

TscPriorityLevelRm

0..1

Unsigned integer indicating the TSC traffic priority in relation to other TSC and non-TSC traffic.

tscaiTimeDom

UintegerRm

0..1

Indicates the (g)PTP domain that the (TSN)AF is located in.

tscaiInputUl

TscaiInputContainer

0..1

Transports the input parameters for TSC traffic to construct the TSC Assistance Container in uplink direction.

tscaiInputDl

TscaiInputContainer

0..1

Transports the input parameters for TSC traffic to construct the TSC Assistance Container in downlink direction.

5.14.2.2 Referenced simple data types and enumerations

5.14.2.2.1 Introduction

This clause defines simple data types and enumerations that can be referenced from data structures defined in the previous clauses. In addition, data types and enumerations defined in clause 5.2.1 can be referenced.

5.14.2.2.2 Simple data types

The simple data types defined in table 5.14.2.2.2-1 shall be supported.

Table 5.14.2.2.2-1: Simple data types

Type name

Description

5.14.2.2.3 Enumeration: UserPlaneEvent

The enumeration UserPlaneEvent represents the user plane event.

Table 5.14.2.2.3-1: Enumeration UserPlaneEvent

Enumeration value

Description

Applicability (NOTE)

SESSION_TERMINATION

Indicates that Rx session is terminated.

LOSS_OF_BEARER

Indicates a loss of a bearer.

RECOVERY_OF_BEARER

Indicates a recovery of a bearer.

RELEASE_OF_BEARER

Indicates a release of a bearer.

USAGE_REPORT

Indicates the usage report event.

FAILED_RESOURCES_ALLOCATION

Indicates the resource allocation is failed.

SUCCESSFUL_RESOURCES_ALLOCATION

Indicates the resource allocation is successful.

QOS_GUARANTEED

The QoS targets of one or more SDFs are guaranteed again.

AlternativeQoS_5G

QOS_NOT_GUARANTEED

The QoS targets of one or more SDFs are not being guaranteed.

AlternativeQoS_5G

QOS_MONITORING

Indicates a QoS monitoring event.

QoSMonitoring_5G

ACCESS_TYPE_CHANGE

Indicates an Access type change. (NOTE 2)

enNB_5G

PLMN_CHG

Indicates a PLMN change. (NOTE 2)

enNB_5G

NOTE 1: Properties marked with a feature as defined in clause 5.14.4 are applicable as described in clause 5.2.7. If no features are indicated, the related property applies for all the features.

NOTE 2: The exposure of such network information to the AF needs to be authorized based on the local policy or local configuration.

5.14.3 Resource structure

5.14.3.1 General

All resource URIs of this API should have the following root:

{apiRoot}/3gpp-as-session-with-qos/v1

"apiRoot" is set as described in clause 5.2.4. "apiName" shall be set to "3gppassessionwithqos" and "apiVersion" shall be set to "v1" for the version defined in the present document. All resource URIs in the clauses below are defined relative to the above root URI.

The following resources and HTTP methods are supported for this API:

Table 5.14.3.1-1: Resources and methods overview

Resource name

Resource URI

HTTP method

Meaning

AS Session with Required QoS Subscriptions

/{scsAsId}/subscriptions

GET

Get all or queried subscription resources for a given SCS/AS.

POST

Create a new AS session.

Individual AS Session with Required QoS Subscription

/{scsAsId}/subscriptions/{subscriptionId}

GET

Read a subscription resource for a given SCS/AS and a subscription Id.

PUT

Modify a subscription resource for a given SCS/AS and a subscription Id.

PATCH

Modify a subscription resource for a given SCS/AS and a subscription Id.

DELETE

Delete a subscription resource for a given SCS/AS and a subscription Id.

5.14.3.2 Resource: AS Session with Required QoS subscriptions

5.14.3.2.1 Introduction

This resource allows the SCS/AS to read all active AS session with required QoS subscription resources, or create a new subscription resource for the SCS/AS.

5.14.3.2.2 Resource definition

Resource URI: {apiRoot}/3gpp-as-session-with-qos/v1/{scsAsId}/subscriptions

This resource shall support the resource URI variables defined in table 5.14.3.2.2-1.

Table 5.14.3.2.2-1: Resource URI variables for resource "AS Session with Required QoS Subscriptions"

Name

Data type

Definition

apiRoot

string

See clause 5.2.4.

scsAsId

string

Identifier of the SCS/AS.

5.14.3.2.3 Resource methods
5.14.3.2.3.1 GET

The GET method allows to read all or queried active subscriptions for a given SCS/AS. The SCS/AS shall initiate the HTTP GET request message and the SCEF shall respond to the message.

This method shall support the URI query parameters, request and response data structures, and response codes, as specified in the table 5.14.3.2.3.1-1 and table 5.14.3.2.3.1-2.

Table 5.14.3.2.3.1-1: URI query parameters supported by the GET method on this resource

Name

Data type

Cardinality

Remarks

Applicability

ip-addrs

array(IpAddr)

0..N

The IP address(es) of the requested UE(s).

enNB

ip-domain

string

0..1

The IPv4 address domain identifier.

The attribute may only be provided if IPv4 address is included in the ip-addrs query parameter.

enNB

mac-addrs

array(MacAddr48)

0..N

The MAC address(es) of the requested UE(s).

enNB

NOTE: Either the "ip-addrs" parameter or the "mac-addrs" parameter may be provided at the same time. If multiple elements are provided in the array structure, then each element shall be treated as a separate query parameter.

Table 5.14.3.2.3.1-2: Data structures supported by the GET request/response by the resource

Request body

Data type

Cardinality

Remarks

none

Response body

Data type

Cardinality

Response

codes

Remarks

array(AsSessionWithQoSSubscription)

0..N

200 OK

The subscription information related to the request URI is returned.

none

307 Temporary Redirect

Temporary redirection, during subscription retrieval. The response shall include a Location header field containing an alternative URI of the resource located in an alternative SCEF.

Redirection handling is described in clause 5.2.10.

none

308 Permanent Redirect

Permanent redirection, during subscription retrieval. The response shall include a Location header field containing an alternative URI of the resource located in an alternative SCEF.

Redirection handling is described in clause 5.2.10.

NOTE: The mandatory HTTP error status codes for the GET method listed in table 5.2.6-1 also apply.

Table 5.14.3.2.3.1-3: Headers supported by the 307 Response Code on this resource

Name

Data type

P

Cardinality

Description

Location

string

M

1

An alternative URI of the resource located in an alternative SCEF.

Table 5.14.3.2.3.1-4: Headers supported by the 308 Response Code on this resource

Name

Data type

P

Cardinality

Description

Location

string

M

1

An alternative URI of the resource located in an alternative SCEF.

5.14.3.2.3.2 PUT

This HTTP method is not supported for the resource.

5.14.3.2.3.3 PATCH

This HTTP method is not supported for the resource.

5.14.3.2.3.4 POST

The POST method creates a new subscription resource for a given SCS/AS. The SCS/AS shall initiate the HTTP POST request message and the SCEF shall respond to the message. The SCEF shall construct the URI of the created resource using that URI.

This method shall support the URI query parameters, request and response data structures, and response codes, as specified in the table 5.14.3.2.3.4-1 and table 5.14.3.2.3.4-2.

Table 5.14.3.2.3.4-1: URI query parameters supported by the POST method on this resource

Name

Data type

Cardinality

Remarks

Table 5.14.3.2.3.4-2: Data structures supported by the POST request/response by the resource

Request body

Data type

Cardinality

Remarks

AsSessionWithQoSSubscription

1

Parameters to create a subscription for an AS session with required QoS for the service requirement.

Response body

Data type

Cardinality

Response

codes

Remarks

AsSessionWithQoSSubscription

1

201

Created

The subscription was created successfully.

The URI of the created resource shall be returned in the "Location" HTTP header.

NOTE: The mandatory HTTP error status codes for the POST method listed in table 5.2.6-1 also apply.

Table 5.14.3.2.3.4-3: Headers supported by the 201 Response Code on this resource

Name

Data type

P

Cardinality

Description

Location

string

M

1

Contains the URI of the newly created resource, according to the structure: {apiRoot}/3gpp-as-session-with-qos/v1/{scsAsId}/subscriptions/{subscriptionId}

5.14.3.2.3.5 DELETE

This HTTP method is not supported for the resource.

5.14.3.3 Resource: Individual AS Session with Required QoS Subscription

5.14.3.3.1 Introduction

This resource allows an SCS/AS to query, update and delete an AS session with required QoS subscription.

5.14.3.3.2 Resource definition

Resource URI: {apiRoot}/3gpp-as-session-with-qos/v1/{scsAsId}/subscriptions/{subscriptionId}

This resource shall support the resource URI variables defined in table 5.14.3.3.2-1.

Table 5.14.3.2.2-1: Resource URI variables for resource "Individual AS Session with Required QoS Subscription"

Name

Data type

Definition

apiRoot

string

See clause 5.2.4.

scsAsId

string

Identifier of the SCS/AS of type ScsAsId.

subscriptionId

string

Identifier of the subscription resource of type string. The subscriptionId corresponds to the stage 2 TLTRI.

5.14.3.3.3 Resource methods
5.14.3.3.3.1 GET

The GET method allows to read a subscription resource. The SCS/AS shall initiate the HTTP GET request message and the SCEF shall respond to the message.

This method shall support the URI query parameters, request and response data structures, and response codes, as specified in the table 5.14.3.3.3.1-1 and table 5.14.3.3.3.1-2.

Table 5.14.3.3.3.1-1: URI query parameters supported by the GET method on this resource

Name

Data type

Cardinality

Remarks

Table 5.14.3.3.3.1-2: Data structures supported by the GET request/response by the resource

Request body

Data type

Cardinality

Remarks

none

Response body

Data type

Cardinality

Response

codes

Remarks

AsSessionWithQoSSubscription

1

200 OK

The subscription information related to the resource URI is returned.

none

307 Temporary Redirect

Temporary redirection, during subscription retrieval. The response shall include a Location header field containing an alternative URI of the resource located in an alternative SCEF.

Redirection handling is described in clause 5.2.10.

none

308 Permanent Redirect

Permanent redirection, during subscription retrieval. The response shall include a Location header field containing an alternative URI of the resource located in an alternative SCEF.

Redirection handling is described in clause 5.2.10.

NOTE: The mandatory HTTP error status codes for the GET method listed in table 5.2.6-1 also apply.

Table 5.14.3.3.3.1-3: Headers supported by the 307 Response Code on this resource

Name

Data type

P

Cardinality

Description

Location

string

M

1

An alternative URI of the resource located in an alternative SCEF.

Table 5.14.3.3.3.1-4: Headers supported by the 308 Response Code on this resource

Name

Data type

P

Cardinality

Description

Location

string

M

1

An alternative URI of the resource located in an alternative SCEF.

5.14.3.3.3.2 PUT

The PUT method allows changing the service information of an active subscription. The properties "ueIpv4Addr" or "ueIpv6Addr" shall remain unchanged from previously provided value.

This method shall support request and response data structures, and response codes, as specified in the table 5.14.3.3.3.2-1.

Table 5.14.3.3.3.2-1: Data structures supported by the PUT request/response by the resource

Request body

Data type

Cardinality

Remarks

AsSessionWithQoSSubscription

1

Set up AS session with required QoS.

Response body

Data type

Cardinality

Response

codes

Remarks

AsSessionWithQoSSubscription

1

200 OK

The subscription was modified successfully.

The SCEF shall return an updated subscription in the response payload body.

none

204 No Content

The subscription was updated successfully.

none

307 Temporary Redirect

Temporary redirection, during subscription modification. The response shall include a Location header field containing an alternative URI of the resource located in an alternative SCEF.

Redirection handling is described in clause 5.2.10.

none

308 Permanent Redirect

Permanent redirection, during subscription modification. The response shall include a Location header field containing an alternative URI of the resource located in an alternative SCEF.

Redirection handling is described in clause 5.2.10.

NOTE: The mandatory HTTP error status codes for the PUT method listed in table 5.2.6-1 also apply.

Table 5.14.3.3.3.2-2: Headers supported by the 307 Response Code on this resource

Name

Data type

P

Cardinality

Description

Location

string

M

1

An alternative URI of the resource located in an alternative SCEF.

Table 5.14.3.3.3.2-3: Headers supported by the 308 Response Code on this resource

Name

Data type

P

Cardinality

Description

Location

string

M

1

An alternative URI of the resource located in an alternative SCEF.

5.14.3.3.3.3 PATCH

The PATCH method allows to change the service information of an active subscription.

This method shall support request and response data structures, and response codes, as specified in the table 5.14.3.3.3.3-1.

Table 5.14.3.3.3.3-1: Data structures supported by the PATCH request/response by the resource

Request body

Data type

Cardinality

Remarks

AsSessionWithQoSSubscriptionPatch

1

Partial update of an AS session with required QoS.

Response body

Data type

Cardinality

Response

codes

Remarks

AsSessionWithQoSSubscription

1

200 OK

The subscription was modified successfully.

The SCEF shall return an updated subscription in the response payload body.

none

204 No Content

The subscription was modified successfully.

none

307 Temporary Redirect

Temporary redirection, during subscription modification. The response shall include a Location header field containing an alternative URI of the resource located in an alternative SCEF.

Redirection handling is described in clause 5.2.10.

none

308 Permanent Redirect

Permanent redirection, during subscription modification. The response shall include a Location header field containing an alternative URI of the resource located in an alternative SCEF.

Redirection handling is described in clause 5.2.10.

NOTE: The mandatory HTTP error status codes for the PATCH method listed in table 5.2.6-1 also apply.

Table 5.14.3.3.3.3-2: Headers supported by the 307 Response Code on this resource

Name

Data type

P

Cardinality

Description

Location

string

M

1

An alternative URI of the resource located in an alternative SCEF.

Table 5.14.3.3.3.3-3: Headers supported by the 308 Response Code on this resource

Name

Data type

P

Cardinality

Description

Location

string

M

1

An alternative URI of the resource located in an alternative SCEF.

5.14.3.3.3.4 POST

This HTTP method is not supported for the resource.

5.14.3.3.3.5 DELETE

The DELETE method deletes the AsSessionWithQoSSubscription resource and terminates the related subscription. The SCS/AS shall initiate the HTTP DELETE request message and the SCEF shall respond to the message.

This method shall support the URI query parameters, request and response data structures, and response codes, as specified in the table 5.14.3.3.3.5-1 and table 5.14.3.3.3.5-2.

Table 5.14.3.3.3.5-1: URI query parameters supported by the DELETE method on this resource

Name

Data type

Cardinality

Remarks

Table 5.14.3.3.3.5-2: Data structures supported by the DELETE request/response by the resource

Request body

Data type

Cardinality

Remarks

none

Response body

Data type

Cardinality

Response

codes

Remarks

none

204 No Content

The subscription was terminated successfully.

The response body shall be empty.

UserPlaneNotificationData

1

200 OK

The subscription was terminated successfully. The user plane notification data shall be included in the response.

none

307 Temporary Redirect

Temporary redirection, during subscription termination. The response shall include a Location header field containing an alternative URI of the resource located in an alternative SCEF.

Redirection handling is described in clause 5.2.10.

none

308 Permanent Redirect

Permanent redirection, during subscription termination. The response shall include a Location header field containing an alternative URI of the resource located in an alternative SCEF.

Redirection handling is described in clause 5.2.10.

NOTE: The mandatory HTTP error status codes for the DELETE method listed in table 5.2.6-1 also apply.

Table 5.14.3.3.3.5-3: Headers supported by the 307 Response Code on this resource

Name

Data type

P

Cardinality

Description

Location

string

M

1

An alternative URI of the resource located in an alternative SCEF.

Table 5.14.3.3.3.5-4: Headers supported by the 308 Response Code on this resource

Name

Data type

P

Cardinality

Description

Location

string

M

1

An alternative URI of the resource located in an alternative SCEF.

5.14.3.4 Void

5.14.3A Notifications

5.14.3A.1 General

The notifications provided by the AsSessionWithQoS API are specified in this clause.

Table 5.14.3A-1: Notifications overview

Notification

Callback URI

HTTP method or custom operation

Description

(service operation)

Event Notification

{notificationUri}

POST

Notify the bearer level event(s) from the SCEF to the SCS/AS

5.14.3A.2 Event Notification

5.14.3A.2.1 Description

The Event Notification allows the SCEF to notify the SCS/AS of the bearer level event(s).

5.14.3A.2.2 Target URI

The Callback URI "{notificationUri}" shall be used with the callback URI variables defined in table 5.14.3A.2.2-1.

Table 5.14.3A.2.2-1: Callback URI variables

Name

Data type

Definition

notificationUri

Link

Reference provided by the SCS/AS when the SCS/AS requests to sponsor the traffic from the beginning or to become the chargeable party at a later point.

This URI shall be provided within the "notificationDestination" attribute in the AsSessionWithQoSSubscription type.

5.14.3A.2.3 Standard Methods
5.14.3A.2.3.1 Notification via POST

The POST method allows to notify SCS/AS of the bearer level event(s) by the SCEF and the SCS/AS shall respond to the message.

This method shall support the request data structures specified in table 5.14.3A.2.3.1-1 and the response data structures and response codes specified in table 5.14.3A.2.3.1-2.

Table 5.14.3A.2.3.1-1: Data structures supported by the POST Request Body

Data type

Cardinality

Description

UserPlaneNotificationData

1

Representation of the bearer level notification.

Table 5.14.3A.2.3.1-2: Data structures supported by the POST Response Body

Data type

Cardinality

Response codes

Description

none

204 No Content

This case represents a successful notification of bearer level event(s).

none

307 Temporary Redirect

Temporary redirection, during event notification. The response shall include a Location header field containing an alternative URI representing the end point of an alternative SCS/AS where the notification should be sent.

Redirection handling is described in clause 5.2.10.

none

308 Permanent Redirect

Permanent redirection, during event notification. The response shall include a Location header field containing an alternative URI representing the end point of an alternative SCS/AS where the notification should be sent.

Redirection handling is described in clause 5.2.10.

NOTE: The mandatory HTTP error status codes for the POST method listed in table 5.2.6-1 also apply.

Table 5.14.3A.2.3.1-3: Headers supported by the 307 Response Code on this resource

Name

Data type

P

Cardinality

Description

Location

string

M

1

An alternative URI representing the end point of an alternative SCS/AS towards which the notification should be redirected.

Table 5.14.3A.2.3.1-4: Headers supported by the 308 Response Code on this resource

Name

Data type

P

Cardinality

Description

Location

string

M

1

An alternative URI representing the end point of an alternative SCS/AS towards which the notification should be redirected.

5.14.3A.2.3.2 Notification via Websocket

If supported by both SCS/AS and SCEF and successfully negotiated, the UserPlaneNotificationData may alternatively be delivered through the Websocket mechanism as defined in clause 5.2.5.4.

5.14.4 Used Features

The table below defines the features applicable to the AsSessionWithQoS API. Those features are negotiated as described in subclause 5.2.7.

Table 5.14.4-1: Features used by AsSessionWithQoS API

Feature Number

Feature

Description

1

Notification_websocket

The delivery of notifications over Websocket is supported according to clause 5.2.5.4. This feature requires that the Notification_test_event featute is also supported.

2

Notification_test_event

The testing of notifications connections is supported according to clause 5.2.5.3.

3

EthAsSessionQoS_5G

Setting up required QoS for Ethernet UE. This feature may only be supported in 5G.

4

MacAddressRange_5G

Indicates the support of a set of MAC addresses with a specific range in the traffic filter. This feature may only be supported in 5G.

5

AlternativeQoS_5G

Indicates the support of alternative QoS requirements and the QoS notification (i.e. whether the QoS targets for SDF(s) are not guaranteed or guaranteed again). This feature may only be supported in 5G.

6

QoSMonitoring_5G

Indicates the support of QoS Monitoring. This feature may only be supported in 5G.

7

DisableUENotification_5G

Indicates the support of disabling QoS flow parameters signalling to the UE when the SMF is notified by the NG-RAN of changes in the fulfilled QoS situation. This feature may only be supported in 5G. This feature requires that the AlternativeQoS_5G feature is also supported.

8

TSC_5G

Indicates the support of Time Sensitive Communication. This feature may only be supported in 5G.

9

AppId

Indicates the support of dynamically providing the Application Identifier via the API.

10

ExposureToEAS

This feature indicates the support of direct notification in 5GC. This feature requires that the QoSMonitoring_5G feature is also supported.

11

enNB

Indicates the support of enhancements to the northbound interfaces.

12

AltQosWithIndParams_5G

This feature indicates the support of provisioning Alternative Service Requirements with individual QoS parameters. This feature requires that the AlternativeQoS_5G feature is also supported.

13

EnEthAsSessionQoS_5G

Indicates the support of required QoS for Ethernet UE, allowing to indicate separately different UL and/or DL Ethernet flows. This feature may only be supported in 5G.

14

enNB_5G

Indicates the support of enhancements to the northbound interfaces and only applicable to 5G.

Feature: A short name that can be used to refer to the bit and to the feature, e.g. "Notification".

Description: A clear textual description of the feature.

5.14.5 Error handling

5.14.5.1 General

HTTP error handling shall be supported as specified in clause 5.2.6.

In addition, the requirements in the following clauses shall apply.

5.14.5.2 Protocol Errors

In this Release of the specification, there are no additional protocol errors applicable for the AsSessionWithQoS API.

5.14.5.3 Application Errors

The application errors defined for AsSessionWithQoS API are listed in table 5.14.5.3-1.

Table 5.14.5.3-1: Application errors

Application Error

HTTP status code

Description

Applicability