The EES exposes the Session with QoS API to the EAS in order to support the setup of a data session between AC and EAS with a specific QoS and the modification of the QoS of this data session.
The Session with QoS API exposed by the EES relies on the northbound Policy Authorization Service API exposed by the PCF as specified in
TS 23.502 and
TS 23.503, if the EES is connected to the PCF via the N5 reference point, or on the northbound AF Session with QoS Service API exposed by the NEF as specified in
TS 23.502 and
TS 23.503, if the EES is connected to the PCF via an NEF.
This API supports to apply the required QoS for both ongoing session and future session for a UE or a group of UEs.
The level of support of the Session with QoS API may change due to UE mobility between 5GC and EPC. E.g. QoS monitoring is only applicable in 5GC. If an EES exposes the Session with QoS API to EAS(s) for a UE, the EES monitors such changes and provides the available information to the EAS.
Alternatively to using the API described in the following clauses, the EAS may also act as an AF and directly access the 3GPP Core Network capabilities to request an AF session with QoS (see
clause 8.7.2). For any data session between AC and EAS, the EAS shall use only one of these alternatives.
The following information flows are specified for Session with QoS API:
-
Session with QoS create request and response;
-
Session with QoS update request and response;
-
Session with QoS revoke request and response; and
-
Session with QoS event notification.
Table 8.6.6.3.2-1 describes the information elements for a Session with QoS create request from the EAS to the EES.
Information element |
Status |
Description |
EASID | M | The identifier of the EAS. |
Security credentials | M | Security credentials of the EAS. |
UE IP address (NOTE 1) | O | The UE IP address. |
UE ID (NOTE 1) | O | The identifier of the UE (i.e. GPSI) |
UE Group ID (NOTE 1) | O | Identifies a group of UEs as defined in clause 7.2.7. |
IP flow description (NOTE 4) | O | The IP flow description for the application traffic. |
Domain description (NOTE 4) | O | The domain description including domain name, applicable protocol and matching criteria (e.g. TLS SNI). |
URI (NOTE 4) | O | Uniform resource identifier. It represents the application traffic URI. |
Requested QoS reference (NOTE 2) | O | Refers to pre-defined QoS information for the data session between AC and EAS (NOTE 3). |
List of alternative QoS references | O | A list of alternative QoS references, referring to pre-defined QoS information for the data session between AC and EAS and containing one or more QoS reference parameters in a prioritized order (NOTE 3). |
Event list | O | A list of associated events to which the EAS subscribes (see clause 6.1.3.18 of TS 23.503). |
> Event specific data | O | For usage monitoring: the sponsoring information (sponsor id, ASP id).
For QoS monitoring: Target of monitoring (DL, UL or roundtrip packet delay). |
> Frequency of reporting | O | The reporting frequency (e.g. event triggered) and additional related data (e.g. threshold, minimum waiting time) as described in clause 6.1.3.21 of TS 23.503, applicable for QoS monitoring event. |
Notification Target Address | M | The Notification Target Address (e.g. URL) where the notifications destined for the EAS should be sent to. |
DNN | O | DNN for the data session between AC and EAS. |
S-NSSAI | O | S-NSSAI for the data session between AC and EAS. |
Requested bandwidth (NOTE 2) | O | Bandwidth requested for the data session between AC and EAS. |
NOTE 1:
Only one of UE IP address, UE ID or UE Group ID shall be provided.
NOTE 2:
Only one of requested QoS reference or requested bandwidth shall be provided.
NOTE 3:
NOTE 4:
At least one of these information elements shall be present.
|
Table 8.6.6.3.3-1 describes the information elements for a Session with QoS create response from the EES to the EAS.
Information element |
Status |
Description |
Successful response | O | Indicates that the Session with QoS create request was successful. |
> Context ID | M | Context identifier corresponding to the information stored for the request in the EES |
Failure response | O | Indicates that the Session with QoS create request failed. |
> Cause | O | Indicates the cause of Session with QoS create request failure |
Table 8.6.6.3.4-1 describes the information elements for a Session with QoS update request from the EAS to the EES.
Information element |
Status |
Description |
Security credentials | M | Security credentials of the EAS |
Context ID | M | Context identifier corresponding to the information stored for the request in the EES. |
Requested QoS reference (NOTE 1) | O | Refers to pre-defined QoS information for the data session between AC and EAS (NOTE 2). |
List of alternative QoS references | O | A list of alternative QoS references, referring to pre-defined QoS information for the data session between AC and EAS and containing one or more QoS reference parameters in a prioritized order (NOTE 2). |
Event list | O | A list of associated events to which the EAS subscribes (see clause 6.1.3.18 of TS 23.503). |
> Event specific data | O | For usage monitoring: the sponsoring information (sponsor id, ASP id).
For QoS monitoring: Target of monitoring (DL, UL or roundtrip packet delay). |
> Frequency of reporting | O | The reporting frequency (e.g. event triggered) and additional related data (e.g. threshold, minimum waiting time) as described in clause 6.1.3.21 of TS 23.503, applicable for QoS monitoring event. |
Requested bandwidth (NOTE 1) | O | Bandwidth requested for the data session between AC and EAS |
NOTE 1:
Only one of requested QoS reference or requested bandwidth shall be provided.
NOTE 2:
|
Table 8.6.6.3.5-1 describes the information elements for a Session with QoS update response from the EES to the EAS.
Information element |
Status |
Description |
Successful response | O | Indicates that the Session with QoS update request was successful. |
Failure response | O | Indicates that the Session with QoS update request failed. |
> Cause | O | Indicates the cause of Session with QoS update request failure |
Table 8.6.6.3.6-1 describes the information elements for a Session with QoS revoke request from the EAS to the EES.
Information element |
Status |
Description |
Security credentials | M | Security credentials of the EAS |
Context ID | M | Context identifier corresponding to the information stored for the request in the EES |
Table 8.6.6.3.7-1 describes the information elements for a Session with QoS revoke response from the EES to the EAS.
Information element |
Status |
Description |
Successful response | O | Indicates that the Session with QoS revoke request was successful. |
Failure response | O | Indicates that the Session with QoS revoke request failed. |
> Cause | O | Indicates the cause of Session with QoS revoke request failure |
Table 8.6.6.3.8-1 describes the information elements for a Session with QoS event notification from the EES to the EAS.
Information element |
Status |
Description |
Context ID | M | Context identifier corresponding to the information stored in the EES during the initial session with QoS create request. |
Event report (NOTE) | M | Event reporting information as specified in clause 6.1.3.18 of TS 23.503. |
NOTE:
Only the following events are applicable:
-
Reporting Usage for Sponsored Data Connectivity
-
Service Data Flow deactivation
-
Resource allocation outcome
-
QoS targets can no longer (or can again) be fulfilled
-
QoS Monitoring parameters
|
Table 8.6.6.4.1-1 illustrates the API for Session with QoS.
API Name |
API Operations |
Operation Semantics |
Consumer(s) |
Eees_SessionWithQoS | Create | Request/ Response | EAS |
Update |
Revoke |
Notify | Subscribe/ Notify (NOTE) | EAS |
NOTE:
The Subscribe operation is embedded in the Request operation of the Create and Update API operation.
|
API operation name:
Eees_SessionWithQoS_Create
Description:
The consumer requests a data session with the UE with a specific QoS and may also subscribe to certain event notifications related to the user plane traffic.
Inputs:
Outputs:
See
clause 8.6.6.2.2 for details of usage of this operation.
API operation name:
Eees_SessionWithQoS_Update
Description:
The consumer requests a modification of the QoS of the data session with the UE and may also update event notifications related to the user plane traffic.
Inputs:
Outputs:
See
clause 8.6.6.2.3 for details of usage of this operation.
API operation name:
Eees_SessionWithQoS_Revoke
Description:
The consumer requests a revoke of the data session with QoS with the UE and unsubscribes to all related event notifications.
Inputs:
Outputs:
See
clause 8.6.6.2.4 for details of usage of this operation.
API operation name:
Eees_SessionWithQoS_Notify
Description:
The consumer is notified by the EES of an event related to the user plane traffic.
Inputs:
Outputs:
None.
See
clause 8.6.6.2.5 for details of usage of this operation.