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.563 Word version: 19.1.0

1… 5… 6…

6.1 Nhss_UEAuthentication Service API 6.2 Nhss_SubscriberDataManagement Service API 6.3 Nhss_UEContextManagement Service API 6.4 Nhss_EventExposure Service API 6.5 Nhss_ParameterProvision Service API

6 API Definitions p. 28

6.1 Nhss_UEAuthentication Service API p. 28

6.1.1 Introduction p. 28

6.1.2 Usage of HTTP p. 29

6.1.2.1 General p. 29

6.1.2.2 HTTP standard headers p. 29

6.1.2.2.1 General p. 29

6.1.2.2.2 Content type p. 29

6.1.2.3 HTTP custom headers p. 29

6.1.2.3.1 General p. 29

6.1.3 Resources p. 29

6.1.3.1 Overview p. 29

6.1.4 Custom Operations without associated resources p. 30

6.1.4.1 Overview p. 30

6.1.4.2 Operation: Generate AV p. 30

6.1.4.2.1 Description p. 30

6.1.4.2.2 Operation Definition p. 30

6.1.5 Notifications p. 31

6.1.6 Data Model p. 31

6.1.6.1 General p. 31

6.1.6.2 Structured data types p. 32

6.1.6.2.1 Introduction p. 32

6.1.6.2.2 Type: AvGenerationRequest p. 32

6.1.6.2.3 Type: AvGenerationResponse p. 32

6.1.6.3 Simple data types and enumerations p. 32

6.1.6.3.1 Introduction p. 32

6.1.6.3.2 Simple data types p. 32

6.1.7 Error Handling p. 32

6.1.7.1 General p. 32

6.1.7.2 Protocol Errors p. 32

6.1.7.3 Application Errors p. 33

6.1.8 Feature negotiation p. 33

6.1.9 Security |R18| p. 33

6.1.10 HTTP redirection |R18| p. 33

6.2 Nhss_SubscriberDataManagement Service API p. 33

6.2.1 API URI p. 33

6.2.2 Usage of HTTP p. 34

6.2.2.1 General p. 34

6.2.2.2 HTTP standard headers p. 34

6.2.2.2.1 General p. 34

6.2.2.2.2 Content type p. 34

6.2.2.3 HTTP custom headers p. 34

6.2.2.3.1 General p. 34

6.2.3 Resources p. 35

6.2.3.1 Overview p. 35

6.2.3.2 Resource: UeContextInPgwData p. 35

6.2.3.2.1 Description p. 35

6.2.3.2.2 Resource Definition p. 35

6.2.3.2.3 Resource Standard Methods p. 36

6.2.3.3 Resource: Subscriptions p. 37

6.2.3.3.1 Description p. 37

6.2.3.3.2 Resource Definition p. 37

6.2.3.3.3 Resource Standard Methods p. 37

6.2.3.4 Resource: Individual subscription p. 38

6.2.3.4.1 Description p. 38

6.2.3.4.2 Resource Definition p. 38

6.2.3.4.3 Resource Standard Methods p. 39

6.2.4 Custom Operations without associated resources |R17| p. 41

6.2.5 Notifications |R17| p. 41

6.2.5.1 General p. 41

6.2.5.2 Data Change Notification p. 41

6.2.6 Data Model p. 42

6.2.6.1 General p. 42

6.2.6.2 Structured data types p. 43

6.2.6.2.1 Introduction p. 43

6.2.6.2.2 Type: UeContextInPgwData p. 43

6.2.6.2.3 Type: SubscriptionData p. 44

6.2.6.2.4 Type: SubscriptionDataSets p. 44

6.2.6.3 Simple data types and enumerations p. 44

6.2.6.3.1 Introduction p. 44

6.2.6.3.2 Simple data types p. 44

6.2.7 Error Handling p. 45

6.2.7.1 General p. 45

6.2.7.2 Protocol Errors p. 45

6.2.7.3 Application Errors p. 45

6.2.8 Feature Negotiation p. 45

6.2.9 Security |R18| p. 45

6.2.10 HTTP redirection |R18| p. 45

6.3 Nhss_UEContextManagement Service API p. 46

6.3.1 Introduction p. 46

6.3.2 Usage of HTTP p. 46

6.3.2.1 General p. 46

6.3.2.2 HTTP standard headers p. 46

6.3.2.2.1 General p. 46

6.3.2.2.2 Content type p. 46

6.3.2.3 HTTP custom headers p. 46

6.3.2.3.1 General p. 46

6.3.3 Resources p. 47

6.3.3.1 Overview p. 47

6.3.4 Custom Operations without associated resources p. 47

6.3.4.1 Overview p. 47

6.3.4.2 Operation: deregister-sn p. 47

6.3.4.2.1 Description p. 47

6.3.4.2.2 Operation Definition p. 47

6.3.4.3 Operation: imei-update p. 48

6.3.4.3.1 Description p. 48

6.3.4.3.2 Operation Definition p. 48

6.3.4.4 Operation: roaming-status-update |R17| p. 49

6.3.4.4.1 Description p. 49

6.3.4.4.2 Operation Definition p. 49

6.3.5 Notifications p. 50

6.3.6 Data Model p. 50

6.3.6.1 General p. 50

6.3.6.2 Structured data types p. 51

6.3.6.2.1 Introduction p. 51

6.3.6.2.2 Type: DeregistrationRequest p. 51

6.3.6.2.3 Type: ImeiUpdateInfo p. 51

6.3.6.2.4 Type: ImeiUpdateResponse |R17| p. 52

6.3.6.2.5 Type: RoamingStatusUpdateInfo |R17| p. 52

6.3.6.3 Simple data types and enumerations p. 52

6.3.6.3.1 Introduction p. 52

6.3.6.3.2 Simple data types p. 52

6.3.6.3.3 Enumeration: DeregistrationReason p. 53

6.3.7 Error Handling p. 53

6.3.7.1 General p. 53

6.3.7.2 Protocol Errors p. 53

6.3.7.3 Application Errors p. 53

6.3.8 Feature Negotiation p. 53

6.3.9 Security |R18| p. 54

6.3.10 HTTP redirection |R18| p. 54

6.4 Nhss_EventExposure Service API p. 54

6.4.1 API URI p. 54

6.4.2 Usage of HTTP p. 54

6.4.2.1 General p. 54

6.4.2.2 HTTP standard headers p. 54

6.4.2.2.1 General p. 54

6.4.2.2.2 Content type p. 55

6.4.2.3 HTTP custom headers p. 55

6.4.2.3.1 General p. 55

6.4.3 Resources p. 55

6.4.3.1 Overview p. 55

6.4.3.2 Resource: EeSubscriptions (Collection) p. 56

6.4.3.2.1 Description p. 56

6.4.3.2.2 Resource Definition p. 56

6.4.3.2.3 Resource Standard Methods p. 56

6.4.3.3 Resource: Individual subscription (Document) p. 57

6.4.3.3.1 Resource Definition p. 57

6.4.3.3.2 Resource Standard Methods p. 58

6.4.4 Custom Operations without associated resources p. 60

6.4.5 Notifications p. 60

6.4.5.1 General p. 60

6.4.5.2 Event Occurrence Notification p. 61

6.4.6 Data Model p. 62

6.4.6.1 General p. 62

6.4.6.2 Structured data types p. 62

6.4.6.2.1 Introduction p. 62

6.4.6.2.2 Type: EeSubscription p. 63

6.4.6.2.3 Type: CreatedEeSubscription p. 64

6.4.6.2.4 Type: MonitoringConfiguration p. 65

6.4.6.2.5 Type: MonitoringReport p. 65

6.4.6.2.6 Type: Report p. 66

6.4.6.2.7 Type: ReportingOptions p. 66

6.4.6.2.8 Type: LocationReportingConfiguration p. 66

6.4.6.2.9 Type: ReachabilityForSmsReport p. 67

6.4.6.2.10 Type: LossConnectivityConfiguration p. 67

6.4.6.2.11 Type: ReachabilityForDataConfiguration p. 67

6.4.6.2.12 Type: PduSessionStatusCfg p. 67

6.4.6.2.13 Type: ReachabilityForDataReport p. 68

6.4.6.2.14 Type: FailedMonitoringConfiguration |R17| p. 68

6.4.6.2.15 Type: EeSubscriptionErrorAddInfo |R18| p. 68

6.4.6.2.16 Type: EeSubscriptionError |R18| p. 68

6.4.6.3 Simple data types and enumerations p. 68

6.4.6.3.1 Introduction p. 68

6.4.6.3.2 Simple data types p. 68

6.4.6.3.3 Enumeration: EventType p. 69

6.4.6.3.4 Enumeration: LocationAccuracy p. 69

6.4.6.3.5 Enumeration: FailedCause |R17| p. 70

6.4.7 Error Handling p. 70

6.4.7.1 General p. 70

6.4.7.2 Protocol Errors p. 70

6.4.7.3 Application Errors p. 70

6.4.8 Feature Negotiation p. 70

6.4.9 Security p. 71

6.4.10 HTTP redirection |R18| p. 71

6.5 Nhss_ParameterProvision Service API |R19| p. 71

6.5.1 API URI p. 71

6.5.2 Usage of HTTP p. 72

6.5.2.1 General p. 72

6.5.2.2 HTTP standard headers p. 72

6.5.2.2.1 General p. 72

6.5.2.2.2 Content type p. 72

6.5.2.3 HTTP custom headers p. 72

6.5.2.3.1 General p. 72

6.5.3 Resources p. 72

6.5.3.1 Overview p. 72

6.5.3.2 Resource: ParameterProvisioningDataEntry p. 73

6.5.3.2.1 Description p. 73

6.5.3.2.2 Resource Definition p. 73

6.5.3.2.3 Resource Standard Methods p. 74

6.5.4 Custom Operations without associated resources p. 76

6.5.5 Notifications p. 76

6.5.6 Data Model p. 76

6.5.6.1 General p. 76

6.5.6.2 Structured data types p. 76

6.5.6.2.1 Introduction p. 76

6.5.6.2.2 Type: PpDataEntry p. 77

6.5.6.2.3 Type: CommunicationCharacteristicsAF p. 77

6.5.6.3 Simple data types and enumerations p. 77

6.5.6.3.1 Introduction p. 77

6.5.6.3.2 Simple data types p. 77

6.5.7 Error Handling p. 78

6.5.7.1 General p. 78

6.5.7.2 Protocol Errors p. 78

6.5.7.3 Application Errors p. 78

6.5.8 Feature Negotiation p. 78

6.5.9 Security p. 78

6.5.10 HTTP redirection p. 79

A (Normative) OpenAPI specification p. 80

A.1 General p. 80

A.2 Nhss_UEAuthentication API p. 80

A.3 Nhss_SubscriberDataManagement API p. 82

A.4 Nhss_UEContextManagement API p. 86

A.5 Nhss_EE API p. 90

A.6 Nhss_PP API |R19| p. 97

B Withdrawn API versions p. 101

B.1 General p. 101

$ Change history p. 102