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 24.558 Word version: 17.2.0

1… 5…

5 Services offered by Edge Enabler Server p. 11

5.1 Introduction p. 11

5.2 Eees_EECRegistration Service p. 12

5.2.1 Service Description p. 12

5.2.2 Service Operations p. 12

5.2.2.1 Introduction p. 12

5.2.2.2 Eees_EECRegistration_Request p. 13

5.2.2.2.1 General p. 13

5.2.2.2.2 EEC registering to EES using Eees_EECRegistration_Request operation p. 13

5.2.2.3 Eees_EECRegistration_Update p. 14

5.2.2.3.1 General p. 14

5.2.2.3.2 EEC updating registration information using Eees_EECRegistration_Update operation p. 14

5.2.2.4 Eees_EECRegistration_Deregister p. 15

5.2.2.4.1 General p. 15

5.2.2.4.2 EEC deregistering from EES using Eees_EECRegistration_Deregister operation p. 15

5.3 Eees_EASDiscovery service p. 15

5.3.1 Service Description p. 15

5.3.2 Service Operations p. 15

5.3.2.1 Introduction p. 15

5.3.2.2 Eees_EASDiscovery_EasDiscRequest p. 16

5.3.2.2.1 General p. 16

5.3.2.2.2 EEC requesting EAS discovery information using Eees_EASDiscovery_EasDiscRequest operation p. 16

5.3.2.3 Eees_EASDiscovery_Subscribe p. 17

5.3.2.3.1 General p. 17

5.3.2.3.2 EEC subscribing to EAS discovery information from EES using Eees_EASDiscovery_Subscribe operation p. 17

5.3.2.4 Eees_EASDiscovery_Notify p. 18

5.3.2.4.1 General p. 18

5.3.2.4.2 EES notifying the EAS discovery information to EEC using Eees_EASDiscovery_Notify operation p. 18

5.3.2.5 Eees_EASDiscovery_UpdateSubscription p. 18

5.3.2.5.1 General p. 18

5.3.2.5.2 EEC updating EAS discovery information subscription at EES using Eees_EASDiscovery_UpdateSubscription operation p. 18

5.3.2.6 Eees_EASDiscovery_Unsubscribe p. 19

5.3.2.6.1 General p. 19

5.3.2.6.2 EEC unsubscribing to EAS discovery subscription from EES using Eees_EASDiscovery_Unsubscribe operation p. 19

5.4 Eees_ACREvents Service p. 19

5.4.1 Service Description p. 19

5.4.2 Service Operations p. 20

5.4.2.1 Introduction p. 20

5.4.2.2 Eees_ACREvents_Subscribe p. 20

5.4.2.2.1 General p. 20

5.4.2.2.2 EEC subscribing to ACR information from EES using Eees_ACREvents_Subscribe operation p. 20

5.4.2.3 Eees_ACREvents_Notify p. 21

5.4.2.3.1 General p. 21

5.4.2.3.2 EES notifying the ACR information to EEC using Eees_ACREvents_Notify operation p. 21

5.4.2.4 Eees_ACREvents_UpdateSubscription p. 21

5.4.2.4.1 General p. 21

5.4.2.4.3 EEC updating ACR information subscription at EES using Eees_ACREvents_UpdateSubscription operation p. 21

5.4.2.5 Eees_ACREvents_Unsubscribe p. 22

5.4.2.5.1 General p. 22

5.4.2.5.2 EEC unsubscribing to service provisioning subscription from EES using Eees_ACREvents_Unsubscribe operation p. 22

5.5 Eees_AppContextRelocation Service p. 22

5.5.1 Service Description p. 22

5.5.2 Service Operations p. 22

5.5.2.1 Introduction p. 22

5.5.2.2 Eees_AppContextRelocation_Determine p. 23

5.5.2.2.1 General p. 23

5.5.2.2.2 ACR Determination p. 23

5.5.2.3 Eees_AppContextRelocation_Initiate p. 23

5.5.2.3.1 General p. 23

5.5.2.3.2 ACR Initiation p. 23

6 Edge Enabler Server API Definitions p. 24

6.1 Void

6.2 Eees_EECRegistration API p. 24

6.2.1 API URI p. 24

6.2.2 Resources p. 25

6.2.2.1 Overview p. 25

6.2.2.2 Resource: EEC Registrations p. 25

6.2.2.2.1 Description p. 25

6.2.2.2.2 Resource Definition p. 25

6.2.2.2.3 Resource Standard Methods p. 26

6.2.2.2.4 Resource Custom Operations p. 26

6.2.2.3 Resource: Individual EEC registration p. 26

6.2.2.3.1 Description p. 26

6.2.2.3.2 Resource Definition p. 27

6.2.2.3.3 Resource Standard Methods p. 27

6.2.2.3.4 Resource Custom Operations p. 32

6.2.3 Custom Operations without associated resources p. 32

6.2.4 Notifications p. 32

6.2.5 Data Model p. 32

6.2.5.1 General p. 32

6.2.5.2 Structured data types p. 33

6.2.5.2.1 Introduction p. 33

6.2.5.2.2 Type: EecRegistration p. 33

6.2.5.2.3 Type: ACProfile p. 34

6.2.5.2.4 Type: EasDetail p. 34

6.2.5.2.5 Type: ACServiceKPIs p. 34

6.2.5.2.6 Type: EecRegistrationPatch p. 35

6.2.5.2.7 Type: UnfulfilledAcProfile p. 35

6.2.5.3 Simple data types and enumerations p. 35

6.2.5.3.1 Introduction p. 35

6.2.5.3.2 Simple data types p. 35

6.2.5.3.3 Enumeration: UnfulfillACProfRsn p. 35

6.2.6 Error Handling p. 35

6.2.6.1 Application Errors p. 36

6.2.7 Feature negotiation p. 36

6.3 Eees_EASDiscovery API p. 36

6.3.1 API URI p. 36

6.3.2 Resources p. 37

6.3.2.1 Overview p. 37

6.3.2.2 Resource: EAS Discovery Subscriptions p. 38

6.3.2.2.1 Description p. 38

6.3.2.2.2 Resource Definition p. 38

6.3.2.2.3 Resource Standard Methods p. 38

6.3.2.2.4 Resource Custom Operations p. 39

6.3.2.3 Resource: Individual EAS Discovery Subscription p. 39

6.3.2.3.1 Description p. 39

6.3.2.3.2 Resource Definition p. 39

6.3.2.3.3 Resource Standard Methods p. 39

6.3.2.3.4 Resource Custom Operations p. 42

6.3.2.4 Resource: EAS Profiles p. 42

6.3.2.4.1 Description p. 42

6.3.2.4.2 Resource Definition p. 42

6.3.2.4.3 Resource Standard Methods p. 43

6.3.2.4.4 Resource Custom Operations p. 43

6.3.3 Custom operations without associated resources p. 43

6.3.4 Notifications p. 44

6.3.4.1 General p. 44

6.3.4.2 EAS Discovery Notification p. 44

6.3.4.2.1 Description p. 44

6.3.4.2.2 Target URI p. 44

6.3.4.2.3 Standard Methods p. 44

6.3.5 Data Model p. 45

6.3.5.1 General p. 45

6.3.5.2 Structured data types p. 46

6.3.5.2.1 Introduction p. 46

6.3.5.2.2 Type: EasDiscoveryReq p. 46

6.3.5.2.3 Type: EasDiscoveryResp p. 46

6.3.5.2.4 Type: EasDiscoverySubscription p. 46

6.3.5.2.5 Type: EasDiscoveryNotification p. 47

6.3.5.2.6 Type: EasDiscoveryFilter p. 48

6.3.5.2.7 Type: EasCharacteristics p. 48

6.3.5.2.8 Type: DiscoveredEas p. 48

6.3.5.2.9 Type: EasDynamicInfoFilter p. 48

6.3.5.2.10 Type: EasDynamicInfoFilterData p. 49

6.3.5.2.11 Type: ACCharacteristics p. 49

6.3.5.2.12 Type: EasDiscoverySubscriptionPatch p. 49

6.3.5.2.13 Type: RequestorId p. 49

6.3.5.3 Simple data types and enumerations p. 50

6.3.5.3.1 Introduction p. 50

6.3.5.3.2 Simple data types p. 50

6.3.5.3.3 Enumeration: EASDiscEventIDs p. 50

6.3.6 Error Handling p. 50

6.3.6.1 General p. 50

6.3.6.2 Protocol Errors p. 50

6.3.6.3 Application Errors p. 50

6.3.7 Feature negotiation p. 50

6.4 Eees_ACREvents API p. 51

6.4.1 API URI p. 51

6.4.2 Resources p. 51

6.4.2.1 Overview p. 51

6.4.2.2 Resource: ACR events subscriptions p. 52

6.4.2.2.1 Description p. 52

6.4.2.2.2 Resource Definition p. 52

6.4.2.2.3 Resource Standard Methods p. 52

6.4.2.2.4 Resource Custom Operations p. 53

6.4.2.3 Resource: Individual ACR events subscription p. 53

6.4.2.3.1 Description p. 53

6.4.2.3.2 Resource Definition p. 53

6.4.2.3.3 Resource Standard Methods p. 53

6.4.2.3.4 Resource Custom Operations p. 58

6.4.3 Custom operations without associated resources p. 58

6.4.4 Notifications p. 58

6.4.4.1 General p. 58

6.4.4.2 ACR Information Notification p. 58

6.4.4.2.1 Description p. 58

6.4.4.2.2 Notification definition p. 58

6.4.5 Data Model p. 59

6.4.5.1 General p. 59

6.4.5.2 Structured data types p. 60

6.4.5.2.1 Introduction p. 60

6.4.5.2.2 Type: ACREventsSubscription p. 60

6.4.5.2.3 Type: ACRInfoNotification p. 61

6.4.5.2.4 Type: TargetInfo p. 61

6.4.5.2.5 Type: ACREventsSubscriptionPatch p. 61

6.4.5.2.6 Type: EecCtxtRelocStatus p. 62

6.4.5.2.7 Type: ACRCompleteEventInfo p. 62

6.4.5.3 Simple data types and enumerations p. 62

6.4.5.3.1 Introduction p. 62

6.4.5.3.2 Simple data types p. 62

6.4.5.3.3 Enumeration: ACREventIDs p. 62

6.4.6 Error Handling p. 62

6.4.7 Feature negotiation p. 63

6.5 Eees_AppContextRelocation API p. 63

6.5.1 Introduction p. 63

6.5.2 Resources p. 63

6.5.3 Custom Operations without associated resources p. 63

6.5.3.1 Overview p. 63

6.5.3.2 Operation: Determine p. 64

6.5.3.2.1 Description p. 64

6.5.3.2.2 Operation Definition p. 64

6.5.3.3 Operation: Initiate p. 65

6.5.3.3.1 Description p. 65

6.5.3.3.2 Operation Definition p. 65

6.5.3.4 Operation: Declare p. 66

6.5.3.4.1 Description p. 66

6.5.3.4.2 Operation Definition p. 66

6.5.4 Notifications p. 67

6.5.5 Data Model p. 67

6.5.5.1 General p. 67

6.5.5.2 Structured data types p. 68

6.5.5.2.1 Introduction p. 68

6.5.5.2.2 Type: AcrDetermReq p. 68

6.5.5.2.3 Type: AcrInitReq p. 69

6.5.5.2.4 Type: AcrDecReq p. 69

6.5.5.2.5 Type: EecCtxtReloc p. 70

6.5.6 Error Handling p. 70

6.5.7 Feature negotiation p. 70

7 Services offered by Edge Configuration Server p. 70

7.1 Introduction p. 70

7.2 Eecs_ServiceProvisioning Service p. 71

7.2.1 Service Description p. 71

7.2.2 Service Operations p. 71

7.2.2.1 Introduction p. 71

7.2.2.2 Eecs_ServiceProvisioning_Request p. 71

7.2.2.2.1 General p. 71

7.2.2.2.2 EEC requesting service provisioning information using Eecs_ServiceProvisioning_Request operation p. 71

7.2.2.3 Eecs_ServiceProvisioning_Subscribe p. 72

7.2.2.3.1 General p. 72

7.2.2.3.2 EEC subscribing to service provisioning information from ECS using Eecs_ServiceProvisioning_Subscribe operation p. 72

7.2.2.4 Eecs_ServiceProvisioning_Notify p. 73

7.2.2.4.1 General p. 73

7.2.2.4.2 ECS notifying the service provisioning information to EEC using Eecs_ServiceProvisioning_Notify operation p. 73

7.2.2.5 Eecs_ServiceProvisioning_UpdateSubscription p. 73

7.2.2.5.1 General p. 73

7.2.2.5.2 EEC updating service provisioning information subscription at ECS using Eecs_ServiceProvisioning_UpdateSubscription operation p. 73

7.2.2.6 Eecs_ServiceProvisioning_Unsubscribe p. 74

7.2.2.6.1 General p. 74

7.2.2.6.2 EEC unsubscribing to service provisioning subscription from ECS using Eecs_ServiceProvisioning_Unsubscribe operation p. 74

8 Edge Configuration Server API Definitions p. 74

8.1 Eecs_ServiceProvisioning API p. 74

8.1.1 API URI p. 74

8.1.2 Resources p. 75

8.1.2.1 Overview p. 75

8.1.2.3 Resource: Service Provisioning Subscriptions p. 76

8.1.2.3.1 Description p. 76

8.1.2.3.2 Resource Definition p. 76

8.1.2.3.3 Resource Standard Methods p. 76

8.1.2.3.4 Resource Custom Operations p. 77

8.1.2.4 Resource: Individual Service Provisioning Subscription p. 77

8.1.2.4.1 Description p. 77

8.1.2.4.2 Resource Definition p. 77

8.1.2.4.3 Resource Standard Methods p. 77

8.1.3 Custom Operations without associated resources p. 80

8.1.3.1 Overview p. 80

8.1.3.2 Operation: Request p. 81

8.1.3.2.1 Description p. 81

8.1.3.2.2 Operation Definition p. 81

8.1.4 Notifications p. 82

8.1.4.1 General p. 82

8.1.4.2 Service Provisioning Notification p. 82

8.1.4.2.1 Description p. 82

8.1.4.2.2 Notification definition p. 82

8.1.5 Data Model p. 83

8.1.5.1 General p. 83

8.1.5.2 Structured data types p. 84

8.1.5.2.1 Introduction p. 84

8.1.5.2.2 Type: ECSServProvReq p. 84

8.1.5.2.3 Type: ECSServProvResp p. 84

8.1.5.2.4 Type: ECSServProvSubscription p. 85

8.1.5.2.5 Type: ConnectivityInfo p. 85

8.1.5.2.6 Type: ServProvNotification p. 86

8.1.5.2.7 Type: EDNConfigInfo p. 86

8.1.5.2.8 Type: EDNConInfo p. 86

8.1.5.2.9 Type: EESInfo p. 87

8.1.5.2.10 Type: ECSServProvSubscriptionPatch p. 87

8.1.5.3 Simple data types and enumerations p. 87

8.1.6 Error Handling p. 87

8.1.7 Feature negotiation p. 87

9 Security p. 88

A (Normative) Edge Enabler Server OpenAPI specification p. 88

A.1 General p. 88

A.2 Eees_EECRegistration p. 88

A.3 Eees_EASDiscovery API p. 93

A.4 Eees_ACREvents API p. 100

A.5 Eees_AppContextRelocation API p. 105

B (Normative) Edge Configuration Server OpenAPI specification p. 109

B.1 Eecs_ServiceProvisioning p. 109

C Protocol options considered for EDGE-4 reference point p. 115

$ Change history p. 116