Tech-invite 3GPPspace IETFspace

21 22 23 24 25 26 27 28 29 31 32 33 34 35 36 37 38 4‑5x

Content for TS 29.576 Word version: 18.3.0

1… 4…

4.1 Introduction 4.2 Nmfaf_3daDataManagement Service 4.3 Nmfaf_3caDataManagement Service 5.1 Nmfaf_3daDataManagement Service API 5.2 Nmfaf_3caDataManagement Service API A.1 General A.2 Nmfaf_3daDataManagement API A.3 Nmfaf_3caDataManagement API

4 Services offered by the MFAF |R18| p. 9

4.1 Introduction p. 9

4.2 Nmfaf_3daDataManagement Service p. 10

4.2.1 Service Description p. 10

4.2.1.1 Overview p. 10

4.2.1.2 Service Architecture p. 10

4.2.1.3 Network Functions p. 11

4.2.1.3.1 Messaging Framework Adaptor Function (MFAF) p. 11

4.2.1.3.2 NF Service Consumers p. 11

4.2.2 Service Operations p. 12

4.2.2.1 Introduction p. 12

4.2.2.2 Nmfaf_3daDataManagement_Configure service operation p. 12

4.2.2.2.1 General p. 12

4.2.2.2.2 Initial configuration for mapping data or analytics p. 12

4.2.2.2.3 Update the configuration of existing individual mapping data or analytics p. 13

4.2.2.3 Nmfaf_3daDataManagement_Deconfigure service operation p. 14

4.2.2.3.1 General p. 14

4.2.2.3.2 Stop mapping data or analytics p. 14

4.3 Nmfaf_3caDataManagement Service p. 15

4.3.1 Service Description p. 15

4.3.1.1 Overview p. 15

4.3.1.2 Service Architecture p. 15

4.3.1.3 Network Functions p. 16

4.3.1.3.1 Messaging Framework Adaptor Function (MFAF) p. 16

4.3.1.3.2 NF Service Consumers p. 16

4.3.2 Service Operations p. 16

4.3.2.1 Introduction p. 16

4.3.2.2 Nmfaf_3caDataManagement_Fetch service operation p. 17

4.3.2.2.1 General p. 17

4.3.2.2.2 Retrieve data or analytics from the MFAF p. 17

4.3.2.2A Nmfaf_3caDataManagement_Subscribe service operation p. 17

4.3.2.3 Nmfaf_3caDataManagement_Notify service operation p. 17

4.3.2.3.1 General p. 17

4.3.2.3.2 Notification about the subscribed data or analytics p. 18

5 API Definitions |R18| p. 19

5.1 Nmfaf_3daDataManagement Service API p. 19

5.1.1 Introduction p. 19

5.1.2 Usage of HTTP p. 19

5.1.2.1 General p. 19

5.1.2.2 HTTP standard headers p. 19

5.1.2.2.1 General p. 19

5.1.2.2.2 Content type p. 19

5.1.2.3 HTTP custom headers p. 19

5.1.3 Resources p. 20

5.1.3.1 Overview p. 20

5.1.3.2 Resource: MFAF Configurations p. 20

5.1.3.2.1 Description p. 20

5.1.3.2.2 Resource Definition p. 20

5.1.3.2.3 Resource Standard Methods p. 21

5.1.3.2.3.1 POST p. 21

5.1.3.2.4 Resource Custom Operations p. 21

5.1.3.3 Resource: Individual MFAF Configuration p. 21

5.1.3.3.1 Description p. 21

5.1.3.3.2 Resource Definition p. 21

5.1.3.3.3 Resource Standard Methods p. 22

5.1.3.3.3.1 PUT p. 22

5.1.3.3.3.2 DELETE p. 23

5.1.4 Custom Operations without associated resources p. 24

5.1.5 Notifications p. 24

5.1.6 Data Model p. 24

5.1.6.1 General p. 24

5.1.6.2 Structured data types p. 24

5.1.6.2.1 Introduction p. 24

5.1.6.2.2 Type: MfafConfiguration p. 25

5.1.6.2.3 Type: MessageConfiguration p. 25

5.1.6.2.4 Type: MfafNotiInfo p. 26

5.1.6.3 Simple data types and enumerations p. 26

5.1.6.3.1 Introduction p. 26

5.1.6.3.2 Simple data types p. 26

5.1.6.4 Data types describing alternative data types or combinations of data types p. 26

5.1.6.5 Binary data p. 26

5.1.7 Error Handling p. 26

5.1.7.1 General p. 26

5.1.7.2 Protocol Errors p. 26

5.1.7.3 Application Errors p. 26

5.1.8 Feature negotiation p. 27

5.1.9 Security p. 27

5.2 Nmfaf_3caDataManagement Service API p. 27

5.2.1 Introduction p. 27

5.2.2 Usage of HTTP p. 28

5.2.2.1 General p. 28

5.2.2.2 HTTP standard headers p. 28

5.2.2.2.1 General p. 28

5.2.2.2.2 Content type p. 28

5.2.2.3 HTTP custom headers p. 28

5.2.3 Resources p. 28

5.2.4 Custom Operations without associated resources p. 28

5.2.5 Notifications p. 28

5.2.5.1 General p. 28

5.2.5.2 MFAF Notification p. 29

5.2.5.2.1 Description p. 29

5.2.5.2.2 Target URI p. 29

5.2.5.2.3 Standard Methods p. 29

5.2.5.2.3.1 POST p. 29

5.2.5.3 Fetch Notification p. 30

5.2.5.3.1 Description p. 30

5.2.5.3.2 Target URI p. 30

5.2.5.3.3 Standard Methods p. 31

5.2.5.3.3.1 POST p. 31

5.2.6 Data Model p. 32

5.2.6.1 General p. 32

5.2.6.2 Structured data types p. 33

5.2.6.2.1 Introduction p. 33

5.2.6.2.2 Type: NmfafDataRetrievalNotification p. 33

5.2.6.2.3 Type: FetchInstruction p. 33

5.2.6.2.4 Type: NmfafDataAnaNotification p. 33

5.2.6.3 Simple data types and enumerations p. 34

5.2.6.3.1 Introduction p. 34

5.2.6.3.2 Simple data types p. 34

5.2.6.4 Data types describing alternative data types or combinations of data types p. 34

5.2.6.5 Binary data p. 34

5.2.7 Error Handling p. 34

5.2.7.1 General p. 34

5.2.7.2 Protocol Errors p. 34

5.2.7.3 Application Errors p. 34

5.2.8 Feature negotiation p. 34

5.2.9 Security p. 34

A (Normative) OpenAPI specification |R18| p. 36

A.1 General p. 36

A.2 Nmfaf_3daDataManagement API p. 36

A.3 Nmfaf_3caDataManagement API p. 39

$ Change history p. 43