Tech-invite 3GPPspace IETF RFCs SIP

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

Content for TS 29.591 Word version: 17.7.0

1… 4…

4.1 Introduction 4.2 Nnef_EventExposure Service 4.3 Nnef_EASDeployment Service 5.1 Nnef_EventExposure Service API 5.2 Nnef_EASDeployment Service API

4 Services offered by the NEF p. 9

4.1 Introduction p. 9

4.2 Nnef_EventExposure Service p. 10

4.2.1 Service Description p. 10

4.2.1.1 Overview p. 10

4.2.1.2 Service Architecture p. 11

4.2.1.3 Network Functions p. 12

4.2.1.3.1 Network Exposure Function (NEF) p. 12

4.2.1.3.2 NF Service Consumers p. 12

4.2.2 Service Operations p. 12

4.2.2.1 Introduction p. 12

4.2.2.2 Nnef_EventExposure_Subscribe service operation p. 12

4.2.2.2.1 General p. 12

4.2.2.2.2 Creating a new subscription p. 13

4.2.2.2.3 Modifying an existing subscription p. 15

4.2.2.3 Nnef_EventExposure_Unsubscribe service operation p. 16

4.2.2.3.1 General p. 16

4.2.2.3.2 Unsubscription from event notifications p. 16

4.2.2.4 Nnef_EventExposure_Notify service operation p. 17

4.2.2.4.1 General p. 17

4.2.2.4.2 Notification about subscribed events p. 17

4.3 Nnef_EASDeployment Service |R17| p. 18

4.3.1 Service Description p. 18

4.3.1.1 Overview p. 18

4.3.1.2 Service Architecture p. 18

4.3.1.3 Network Functions p. 19

4.3.1.3.1 Network Exposure Function (NEF) p. 19

4.3.1.3.2 NF Service Consumers p. 19

4.3.2 Service Operations p. 19

4.3.2.1 Introduction p. 19

4.3.2.2 Nnef_EASDeployment_Subscribe service operation p. 20

4.3.2.2.1 General p. 20

4.3.2.2.2 Creating a new subscription p. 20

4.3.2.3 Nnef_EASDeployment_Unsubscribe service operation p. 21

4.3.2.3.1 General p. 21

4.3.2.3.2 Unsubscription of notification of changes of EAS Deployment Information p. 21

4.3.2.4 Nnef_EASDeployment_Notify service operation p. 21

4.3.2.4.1 General p. 21

4.3.2.4.2 Notification of changes of EAS Deployment Information p. 21

5 API Definitions p. 22

5.1 Nnef_EventExposure Service API p. 22

5.1.1 Introduction p. 22

5.1.2 Usage of HTTP p. 22

5.1.2.1 General p. 22

5.1.2.2 HTTP standard headers p. 22

5.1.2.2.1 General p. 22

5.1.2.2.2 Content type p. 22

5.1.2.3 HTTP custom headers p. 22

5.1.3 Resources p. 23

5.1.3.1 Overview p. 23

5.1.3.2 Resource: Network Exposure Event Subscriptions p. 23

5.1.3.2.1 Description p. 23

5.1.3.2.2 Resource Definition p. 23

5.1.3.2.3 Resource Standard Methods p. 24

5.1.3.2.3.1 POST p. 24

5.1.3.3 Resource: Individual Network Exposure Event Subscription p. 24

5.1.3.3.1 Description p. 24

5.1.3.3.2 Resource Definition p. 24

5.1.3.3.3 Resource Standard Methods p. 25

5.1.3.3.3.1 GET p. 25

5.1.3.3.3.2 PUT p. 26

5.1.3.3.3.3 DELETE p. 27

5.1.4 Custom Operations without associated resources p. 27

5.1.5 Notifications p. 28

5.1.5.1 General p. 28

5.1.5.2 Network Exposure Event Notification p. 28

5.1.5.2.1 Description p. 28

5.1.5.2.2 Target URI p. 28

5.1.5.2.3 Standard Methods p. 28

5.1.5.2.3.1 POST p. 28

5.1.6 Data Model p. 29

5.1.6.1 General p. 29

5.1.6.2 Structured data types p. 32

5.1.6.2.1 Introduction p. 32

5.1.6.2.2 Type: NefEventExposureSubsc p. 32

5.1.6.2.3 Type: NefEventExposureNotif p. 33

5.1.6.2.4 Type: NefEventNotification p. 33

5.1.6.2.5 Type NefEventSubs p. 34

5.1.6.2.6 Type UeCommunicationInfo p. 35

5.1.6.2.7 Type NefEventFilter p. 35

5.1.6.2.8 Type TargetUeIdentification p. 36

5.1.6.2.9 Type: ServiceExperienceInfo p. 36

5.1.6.2.10 Type: UeMobilityInfo p. 36

5.1.6.2.11 Type: UeTrajectoryInfo p. 37

5.1.6.2.12 Type PerformanceDataInfo |R17| p. 37

5.1.6.3 Simple data types and enumerations p. 37

5.1.6.3.1 Introduction p. 37

5.1.6.3.2 Simple data types p. 37

5.1.6.3.3 Enumeration: NefEvent p. 37

5.1.7 Error Handling p. 38

5.1.7.1 General p. 38

5.1.7.2 Protocol Errors p. 38

5.1.7.3 Application Errors p. 38

5.1.8 Feature negotiation p. 38

5.1.9 Security p. 39

5.2 Nnef_EASDeployment Service API |R17| p. 40

5.2.1 Introduction p. 40

5.2.2 Usage of HTTP p. 40

5.2.2.1 General p. 40

5.2.2.2 HTTP standard headers p. 40

5.2.2.2.1 General p. 40

5.2.2.2.2 Content type p. 40

5.2.2.3 HTTP custom headers p. 40

5.2.3 Resources p. 41

5.2.3.1 Overview p. 41

5.2.3.2 Resource: EAS Deployment Event Subscriptions p. 41

5.2.3.2.1 Description p. 41

5.2.3.2.2 Resource Definition p. 41

5.2.3.2.3 Resource Standard Methods p. 42

5.2.3.2.3.1 POST p. 42

5.2.3.3 Resource: Individual EAS Deployment Event Subscription p. 42

5.2.3.3.1 Description p. 42

5.2.3.3.2 Resource Definition p. 42

5.2.3.3.3 Resource Standard Methods p. 43

5.2.3.3.3.1 GET p. 43

5.2.3.3.3.2 PUT p. 44

5.2.3.3.3.3 DELETE p. 44

5.2.4 Custom Operations without associated resources p. 44

5.2.5 Notifications p. 45

5.2.5.1 General p. 45

5.2.5.2 EAS Deployment Event Notification p. 45

5.2.5.2.1 Description p. 45

5.2.5.2.2 Target URI p. 45

5.2.5.2.3 Standard Methods p. 45

5.2.5.2.3.1 POST p. 45

5.2.6 Data Model p. 46

5.2.6.1 General p. 46

5.2.6.2 Structured data types p. 47

5.2.6.2.1 Introduction p. 47

5.2.6.2.2 Type: EasDeploySubData p. 47

5.2.6.2.3 Type: EasDeployInfoNotif p. 48

5.2.6.2.4 Type: EasDepNotification p. 48

5.2.6.2.5 Type: EasDeployInfoData p. 48

5.2.6.3 Simple data types and enumerations p. 48

5.2.6.3.1 Introduction p. 48

5.2.6.3.2 Simple data types p. 48

5.2.6.3.3 Enumeration: EasEvent p. 49

5.2.7 Error Handling p. 49

5.2.7.1 General p. 49

5.2.7.2 Protocol Errors p. 49

5.2.7.3 Application Errors p. 49

5.2.8 Feature negotiation p. 49

5.2.9 Security p. 49

A (Normative) OpenAPI specification p. 51

A.1 General p. 51

A.2 Nnef_EventExposure API p. 51

A.3 Nnef_EASDeployment API |R17| p. 58

$ Change history p. 63