5.2.19 AF Services
23.5023GPPProcedures for the 5G System (5GS)Release 18TS
5.2.19.1 General
The following table illustrates the AF Services.
Table 5.2.19.1-1: Services provided by AF
|
Service Name |
Service Operations |
Operation Semantics |
Example Consumer(s) |
|
Naf_EventExposure |
Subscribe |
Subscribe/Notify |
NEF, NWDAF |
|
Unsubscribe |
NEF, NWDAF |
||
|
Notify |
NEF, NWDAF |
NOTE: In this release of the specification, Naf_EventExposure service is only used for analytics as described in TS 23.288 [50].
5.2.19.2 Naf_EventExposure service
5.2.19.2.1 General
Service description: This service enables consumer NF to subscribe and get notified of events.
The events can be subscribed by a NF consumer are described in TS 23.288 [50].
The following service operations are defined for the Naf_EventExposure service:
– Naf_EventExposure_Subscribe.
– Naf_EventExposure_Unsubscribe.
– Naf_EventExposure_Notify.
The following events can be subscribed by a NF consumer (Event ID is defined in clause 4.15.1):
– Service Experience information, as defined in clause 6.4.2 of TS 23.288 [50].
– Performance Data information, as defined in clauses 6.4.2 and clause 6.14.2 of TS 23.288 [50].
– Collective Behaviour information, as defined in clause 6.5.2 of TS 23.288 [50].
– UE Mobility information, as defined in clause 6.7.2.2 of TS 23.288 [50].
– UE Communication information, as defined in clause 6.7.3.2 of TS 23.288 [50].
– Exceptions information, as defined in clause 6.7.5.2 of TS 23.288 [50].
– User Data Congestion information, as defined in clause 6.8.2 of TS 23.288 [50].
– UE Data volume Dispersion information, as defined in clause 6.10.2 of TS 23.288 [50].
– DN Performance information, as defined in clause 6.14.2 of TS 23.288 [50].
Event Filters are used to specify the conditions to match for notifying the event (i.e. "List of Parameter values to match"). If there are no conditions to match for a specific Event ID, then the Event Filter is not provided. The following table provides some examples on how the conditions to match for event reporting can be specified for various Event IDs for AF exposure.
Table 5.2.19.2.1-1: Example of Event Filters for AF exposure events
|
Event ID for AF exposure |
Event Filter (List of Parameter Values to Match) |
|
Exceptions information |
<Parameter Type = Exception ID, Value = Exception ID1> |
|
Service Experience information |
<Parameter Type = TAI, Value = TAI1> |
|
Service Experience information |
<Parameter Type = geographical area, Value = civic address1 or shape1> |
|
Collective Behaviour information |
<Parameter Type = collective attribute, Value = collective value1> |
|
Collective Behaviour information |
<Parameter Type = data processing type, Value = data processing type1> |
5.2.19.2.2 Naf_EventExposure_Subscribe service operation
Service operation name: Naf_EventExposure_Subscribe
Description: The consumer NF subscribes the event to collect AF data for UE(s), group of UEs, or any UE, or updates the subscription which is already defined in AF.
Input, Required: Target of Event Reporting (either UE ID(s), or UE IPv4 address(es), or UE IPv6 prefix(es), or Internal/External Group Identifier, or indication that any UE is targeted), (set of) Event ID(s), Notification Target Address (+ Notification Correlation ID) and Event Reporting Information as defined in Table 4.15.1-1.
NOTE 1: UE ID includes GPSI or SUPI.
Input, Optional: NF ID, Event Filter(s) associated with each Event ID, (set of) External Application Identifier(s), Subscription Correlation ID (in the case of modification of the existing subscription), Expiry time.
NOTE 2: In the case of untrusted AF, NEF ID is used as NF ID.
Output, Required: Operation execution result indication. When the subscription is accepted: Subscription Correlation ID, Expiry time (required if the subscription can be expired based on the local policy).
Output, Optional: First corresponding event report is included, if corresponding information is available (see clause 4.15.1).
5.2.19.2.3 Naf_EventExposure_Unsubscribe service operation
Service operation name: Naf_EventExposure_Unsubscribe
Description: The consumer NF unsubscribes for a specific event.
Input, Required: Subscription Correlation ID.
Input, Optional: None.
Output, Required: Operation execution result indication.
Output, Optional: None.
5.2.19.2.4 Naf_EventExposure_Notify service operation
Service operation name: Naf_EventExposure_Notify
Description: The AF provides the previously subscribed event information to the consumer NF which has subscribed to that event before.
Input, Required: Notification Correlation Information, Event ID, corresponding UE ID(s) (either external UE ID(s), or Internal/External Group Identifier, or UE IP v4 address(es) or UE IP v6 prefix(es), time stamp.
NOTE: UE ID includes GPSI or SUPI.
Input, Optional: Event specific parameter list.
Output, Required: None.
Output, Optional: None.