Content for TS 29.591 Word version: 19.0.0
4.6 Nnef_DNAIMapping Service
4.6.1 Service Description
4.6.1.1 Overview
4.6.1.2 Service Architecture
4.6.1.3 Network Functions
4.6.2 Service Operations
4.6.2.1 Introduction
4.6.2.2 Nnef_DNAIMapping_Subscribe service operation
4.6.2.3 Nnef_DNAIMapping_Unsubscribe service operation
4.6.2.4 Nnef_DNAIMapping_Notify service operation
...
...
4.6 Nnef_DNAIMapping Service |R18| p. 37
4.6.1 Service Description p. 37
4.6.1.1 Overview p. 37
The Nnef_DNAIMapping service, as defined in TS 23.502, is provided by the Network Exposure Function (NEF). This service allows the NEF service consumer (e.g. NWDAF) to create or delete subscription(s) of DNAI Mapping information to NEF and also by NEF to notify the NF service consumer about the update of the DNAI Mapping information.
4.6.1.2 Service Architecture p. 37
The Nnef_DNAIMapping service is part of the Nnef service-based interface exhibited by the Network Exposure Function (NEF).
Known consumer of the Nnef_DNAIMapping service is:
- Network Data Analytics Function (NWDAF)
4.6.1.3 Network Functions p. 38
4.6.1.3.1 Network Exposure Function (NEF) p. 38
The Network Exposure Function (NEF) allows the NF service consumer (e.g. NWDAF) to subscribe to and unsubscribe from the NEF for the DNAI Mapping information and also by NEF to notify the NF service consumer about the update of the DNAI Mapping information.
4.6.1.3.2 NF Service Consumers p. 38
The known NF service consumers are as follows:
The Network Data Analytics Function (NWDAF):
- supports (un)subscribing to notifications of DNAI Mapping information from the NEF.
- supports receiving the notifications of Update of DNAI Mapping Information from the NEF.
4.6.2 Service Operations p. 38
4.6.2.1 Introduction p. 38
Service operations defined for the Nnef_DNAIMapping Service are shown in Table 4.6.2.1-1.
| Service Operation Name | Description | Initiated by |
|---|---|---|
| Nnef_ | This service operation is used by an NF service consumer to explicitly subscribe the notification of DNAI Mapping Information. | NF service consumer |
| Nnef_ | This service operation is used by an NF service consumer to explicitly unsubscribe the notification of DNAI Mapping Information. | NF service consumer |
| Nnef_ | This service operation is used by the NEF to provide Update DNAI Mapping Information to the NF service consumer. | NEF |
4.6.2.2 Nnef_DNAIMapping_Subscribe service operation p. 39
4.6.2.2.1 General p. 39
This service operation is provided by the NEF for the NF service consumers to explicitly subscribe the notification of DNAI Mapping Information.
4.6.2.2.2 Creating a new subscription for notification of DNAI Mapping Information p. 39
Figure 4.6.2.2.2-1 illustrates the creation of a Individual DNAI Mapping Information Subscription.
In order to subscribe to DNAI Mapping Information, the NF service consumer shall send an Nnef_DNAIMapping_Subscribe request using the HTTP POST method to the NEF with "{apiRoot}/nnef-dnai-mapping/<apiVersion>/subscriptions" as request URI as shown in step 1 of Figure 4.6.2.2.2-1. The HTTP POST message shall include DnaiMapSub data structure as request body. The contents of the DnaiMapSub data structure are as described in clause 4.4.34.2 of TS 29.522.
Upon receipt of the corresponding HTTP POST message, the NEF shall interact with the UDR by invoking the Nudr_DataRepository service as described in TS 29.504, if the NEF receives an error response from the UDR, the NEF shall not create the resource and shall respond to the NF service consumer with a proper error status code. If the NEF received within an error response a "ProblemDetails" data structure with a "cause" attribute indicating an application error, the NEF shall relay this error response to the NF service consumer with a corresponding application error, when applicable.
On successful DNAI Mapping subscription creation, the NEF shall return an HTTP POST response with an HTTP "201 Created" status code to the NF service consumer, including a "Location" header containing the URI of the created "Individual DNAI Mapping Subscription" resource and the response body containing a representation of the created resource within the DnaiMapSub data structure. The contents of the DnaiMapSub data structure in the response are as described for the subscription response in clause 4.4.34.2 of TS 29.522.
On failure, the NEF shall take proper error handling actions, as specified in clause 5.5.7, and respond to the NF service consumer with an appropriate error status code.
4.6.2.3 Nnef_DNAIMapping_Unsubscribe service operation p. 40
4.6.2.3.1 General p. 40
This service operation is used by an NF service consumer (e.g. NWDAF) to explicitly unsubscribe the notification of DNAI Mapping information.
The following procedure using the Nnef_DNAIMapping_Unsubscribe service operation is supported:
- unsubscription from the notification of DNAI Mapping information.
4.6.2.3.2 Unsubscription of notification of DNAI Mapping Information p. 40
Figure 4.6.2.3.2-1 illustrates the unsubscription of event notifications from NEF.
In order to delete an existing subscription to DNAI Mapping Information, the NF service consumer shall send an HTTP DELETE request message with "{apiRoot}/nnef-dnai-mapping/<apiVersion>/subscriptions/{subscriptionId}" as request URI, as shown in step 1 of Figure 4.6.2.3.2-1, where "{subscriptionId}" is the subscription identifier of the existing subscription resource that is to be deleted.
Upon successful reception of an HTTP DELETE, the NEF shall delete the individual resource and shall respond to the NF service consumer with an HTTP "204 No Content" response message, as shown in step 2 of Figure 4.6.2.3.2-1.
If the received HTTP DELETE request needs to be redirected, the NEF shall send an HTTP redirect response as specified in clause 6.10.9 of TS 29.500.
If errors occur when processing the HTTP DELETE request, the NEF shall send an HTTP error response as specified in clause 5.5.7.
4.6.2.4 Nnef_DNAIMapping_Notify service operation p. 40
4.6.2.4.1 General p. 40
The Nnef_DNAIMapping_Notify service operation enables the NEF to notify the DNAI Mapping Information to the NF service consumer.
The following procedure using the Nnef_DNAIMapping_Notify service operation is supported:
- notification about subscribed DNAI Mapping Information.
4.6.2.4.2 Notification of changes of DNAI Mapping Information p. 40
Figure 4.6.2.4.2-1 illustrates the notification about DNAI Mapping Information.
If the NEF observes DNAI Mapping Information that an NF service consumer has subscribed, the NEF shall send an HTTP POST request as shown in step 1 of Figure 4.6.2.4.2-1, with the "{notifUri}" as request URI containing the value previously provided by the NF service consumer within the corresponding subscription, and the DnaiMapUpdateNotif data structure as request body.
Upon successful reception of an HTTP POST request with "{notifUri}" as request URI and DnaiMapUpdateNotif data structure as request body, the NF service consumer shall send an HTTP "204 No Content" response, as shown in step 2 of Figure 4.6.2.4.2-1.
On failure, the NF service consumer shall take proper error handling actions, as specified in clause 5.5.7, and respond to the NEF with an appropriate error status code.
