Content for TS 29.558 Word version: 18.6.0
8 Edge Enabler Server API Definitions
8.1 Eees_EASRegistration API
8.2 Eees_UELocation API
8.3 Eees_UEIdentifier API
8.4 Eees_AppClientInformation API
8.5 Eees_SessionWithQoS API
8.6 Eees_ACRManagementEvent API
8.7 Eees_EECContextRelocation API
8.8 Eees_EELManagedACR API
8.9 Eees_ACRStatusUpdate API
8.10 Eees_ACRParameterInformation API
8.11 Eees_CommonEASAnnouncement API
8.12 Eees_TrafficInfluenceEAS API
8A CAS API Definitions
8A.1 Ecas_SelectedEES API
8 Edge Enabler Server API Definitions p. 73
8.1 Eees_EASRegistration API p. 73
8.1.1 Introduction p. 73
8.1.2 Resources p. 73
8.1.2.1 Overview p. 73
8.1.2.2 Resource: EAS Registrations p. 74
8.1.2.2.1 Description p. 74
8.1.2.2.2 Resource Definition p. 74
8.1.2.2.3 Resource Standard Methods p. 74
8.1.2.2.3.1 POST p. 74
8.1.2.2.4 Resource Custom Operations p. 75
8.1.2.3 Resource: Individual EAS Registration p. 75
8.1.3 Custom Operations without associated resources p. 79
8.1.4 Notifications p. 79
8.1.5 Data Model p. 79
8.1.5.1 General p. 79
8.1.5.2 Structured data types p. 81
8.1.5.2.1 Introduction p. 81
8.1.5.2.2 Type: EASRegistration p. 81
8.1.5.2.3 Type: EASProfile p. 82
8.1.5.2.4 Type: EASServiceKPI p. 85
8.1.5.2.5 Type: EndPoint p. 85
8.1.5.2.6 Type: EASRegistrationPatch p. 85
8.1.5.2.7 Type: TransContSuppDetails |R18| p. 86
8.1.5.2.8 Type: EASBundleInfo |R18| p. 86
8.1.5.2.9 Type: EASBdlReqs |R18| p. 86
8.1.5.2.10 Type: CoordinatedAcrReqs |R18| p. 87
8.1.5.3 Simple data types and enumerations p. 87
8.1.5.3.1 Introduction p. 87
8.1.5.3.2 Simple data types p. 87
8.1.5.3.3 Enumeration: PermissionLevel p. 87
8.1.5.3.4 Enumeration: EASCategory p. 88
8.1.5.3.5 Enumeration: TransportProtocol |R18| p. 88
8.1.5.3.6 Enumeration: BdlType |R18| p. 88
8.1.5.3.7 Enumeration: Affinity |R18| p. 88
8.1.5.3.8 Enumeration: FailureAction |R18| p. 89
8.1.6 Error Handling p. 89
8.1.7 Feature negotiation p. 89
8.2 Eees_UELocation API p. 89
8.2.1 Introduction p. 89
8.2.2 Resources p. 90
8.2.2.1 Overview p. 90
8.2.2.2 Resource: Location Information Subscriptions p. 90
8.2.2.2.1 Description p. 90
8.2.2.2.2 Resource Definition p. 91
8.2.2.2.3 Resource Standard Methods p. 91
8.2.2.2.3.1 POST p. 91
8.2.2.2.4 Resource Custom Operations p. 92
8.2.2.3 Resource: Individual Location Information Subscription p. 92
8.2.3 Custom Operations without associated resources p. 96
8.2.3.1 Overview p. 96
8.2.3.2 Operation: Fetch p. 97
8.2.3.2.1 Description p. 97
8.2.3.2.2 Operation Definition p. 97
8.2.4 Notifications p. 98
8.2.4.1 General p. 98
8.2.4.2 Location Information Notification p. 99
8.2.4.2.1 Description p. 99
8.2.4.2.2 Target URI p. 99
8.2.4.2.3 Standard Methods p. 99
8.2.4.2.3.1 POST p. 99
8.2.4.3 User Consent Revocation Notification p. 100
8.2.5 Data Model p. 101
8.2.5.1 General p. 101
8.2.5.2 Structured data types p. 103
8.2.5.2.1 Introduction p. 103
8.2.5.2.2 Type: LocationSubscription p. 103
8.2.5.2.3 Type: LocationSubscriptionPatch p. 105
8.2.5.2.4 Type: LocationNotification p. 105
8.2.5.2.5 Type: LocationEvent p. 105
8.2.5.2.6 Type: LocationRequest p. 106
8.2.5.2.7 Type: LocationResponse p. 106
8.2.5.2.8 Type: ConsentRevocNotif p. 106
8.2.5.2.9 Type: ConsentRevoked p. 107
8.2.5.3 Simple data types and enumerations p. 107
8.2.6 Error Handling p. 107
8.2.7 Feature negotiation p. 107
8.3 Eees_UEIdentifier API p. 108
8.3.1 Introduction p. 108
8.3.2 Resources p. 108
8.3.3 Custom Operations without associated resources p. 108
8.3.3.1 Overview p. 108
8.3.3.2 Operation: Fetch p. 109
8.3.3.2.1 Description p. 109
8.3.3.2.2 Operation Definition p. 109
8.3.3.3 Operation: Get |R18| p. 110
8.3.3.3.1 Description p. 110
8.3.3.3.2 Operation Definition p. 110
8.3.4 Notifications p. 111
8.3.5 Data Model p. 111
8.3.5.1 General p. 111
8.3.5.2 Structured data types p. 112
8.3.5.2.1 Introduction p. 112
8.3.5.2.2 Type: UserInformation p. 112
8.3.5.2.3 Type: UserInfo |R18| p. 113
8.3.5.2.4 Type: UeIdInfo |R18| p. 113
8.3.5.2.5 Type: UeId |R18| p. 114
8.3.5.3 Simple data types and enumerations p. 114
8.3.6 Error Handling p. 114
8.3.6.1 General |R18| p. 114
8.3.6.2 Protocol Errors |R18| p. 114
8.3.6.3 Application Errors |R18| p. 114
8.3.7 Feature negotiation p. 115
8.4 Eees_AppClientInformation API p. 115
8.4.1 Introduction p. 115
8.4.2 Resources p. 115
8.4.2.1 Overview p. 115
8.4.2.2 Resource: Application Client Information Subscriptions p. 116
8.4.2.2.1 Description p. 116
8.4.2.2.2 Resource Definition p. 116
8.4.2.2.3 Resource Standard Methods p. 117
8.4.2.2.3.1 POST p. 117
8.4.2.2.4 Resource Custom Operations p. 117
8.4.2.3 Resource: Individual Application Client Information Subscription p. 117
8.4.2.3.1 Description p. 117
8.4.2.3.2 Resource Definition p. 117
8.4.2.3.3 Resource Standard Methods p. 118
8.4.2.3.4 Resource Custom Operations p. 122
8.4.3 Custom Operations without associated resources p. 122
8.4.4 Notifications p. 122
8.4.4.1 General p. 122
8.4.4.2 AC Information Notification p. 122
8.4.4.2.1 Description p. 122
8.4.4.2.2 Target URI p. 122
8.4.4.2.3 Standard Methods p. 122
8.4.4.2.3.1 POST p. 122
8.4.5 Data Model p. 123
8.4.5.1 General p. 123
8.4.5.2 Structured data types p. 126
8.4.5.2.1 Introduction p. 126
8.4.5.2.2 Type: ACInfoSubscription p. 126
8.4.5.2.3 Type: ACInfoSubscriptionPatch p. 127
8.4.5.2.4 Type: ACFilters p. 128
8.4.5.2.5 Type: ACInfoNotification p. 128
8.4.5.2.6 Type: ACInformation p. 129
8.4.5.2.7 Type: EASBdlInd |R18| p. 129
8.4.5.3 Simple data types and enumerations p. 129
8.4.6 Error Handling p. 130
8.4.7 Feature negotiation p. 130
8.5 Eees_SessionWithQoS API p. 131
8.5.1 Introduction p. 131
8.5.2 Resources p. 131
8.5.2.1 Overview p. 131
8.5.2.2 Resource: Sessions with QoS p. 132
8.5.2.2.1 Description p. 132
8.5.2.2.2 Resource Definition p. 132
8.5.2.2.3 Resource Standard Methods p. 133
8.5.2.2.3.1 POST p. 133
8.5.2.2.3.2 GET p. 133
8.5.2.2.4 Resource Custom Operations p. 134
8.5.2.3 Resource: Individual Session with QoS p. 134
8.5.2.3.1 Description p. 134
8.5.2.3.2 Resource Definition p. 135
8.5.2.3.3 Resource Standard Methods p. 135
8.5.2.3.4 Resource Custom Operations p. 139
8.5.3 Custom Operations without associated resources p. 139
8.5.4 Notifications p. 139
8.5.4.1 General p. 139
8.5.4.2 User Plane Event Notification p. 140
8.5.4.2.1 Description p. 140
8.5.4.2.2 TargetURI p. 140
8.5.4.2.3 Standard Methods p. 140
8.5.4.2.3.1 POST p. 140
8.5.5 Data Model p. 141
8.5.5.1 General p. 141
8.5.5.2 Structured data types p. 143
8.5.5.2.1 Introduction p. 143
8.5.5.2.2 Type: SessionWithQoS p. 143
8.5.5.2.3 Type: SessionWithQoSPatch p. 146
8.5.5.2.4 Type: UserPlaneEventNotification p. 146
8.5.5.3 Simple data types and enumerations p. 147
8.5.6 Error Handling p. 147
8.5.6.1 General |R18| p. 147
8.5.6.2 Protocol Errors |R18| p. 147
8.5.6.3 Application Errors |R18| p. 147
8.5.7 Feature negotiation p. 147
8.6 Eees_ACRManagementEvent API p. 147
8.6.1 Introduction p. 147
8.6.2 Resources p. 148
8.6.2.1 Overview p. 148
8.6.2.2 Resource: ACR Management Events Subscriptions p. 149
8.6.2.2.1 Description p. 149
8.6.2.2.2 Resource Definition p. 149
8.6.2.2.3 Resource Standard Methods p. 149
8.6.2.2.3.1 POST p. 149
8.6.2.2.3.2 GET p. 150
8.6.2.2.4 Resource Custom Operations p. 151
8.6.2.3 Resource: Individual ACR Management Events Subscription p. 151
8.6.2.3.1 Description p. 151
8.6.2.3.2 Resource Definition p. 151
8.6.2.3.3 Resource Standard Methods p. 151
8.6.2.3.4 Resource Custom Operations p. 155
8.6.3 Custom Operations without associated resources p. 155
8.6.4 Notifications p. 156
8.6.4.1 General p. 156
8.6.4.2 ACR Management Events Notification p. 156
8.6.4.2.1 Description p. 156
8.6.4.2.2 Notification definition p. 156
8.6.4.3 User Plane Path Change Availability Notification p. 157
8.6.5 Data Model p. 158
8.6.5.1 General p. 158
8.6.5.2 Structured data types p. 161
8.6.5.2.1 Introduction p. 161
8.6.5.2.2 Type: AcrMgntEventsSubscription p. 161
8.6.5.2.3 Type: AcrMgntEventSubsc p. 164
8.6.5.2.4 Type: AcrMgntEventsSubscriptionPatch p. 166
8.6.5.2.5 Type: AcrMgntEventsNotification p. 167
8.6.5.2.6 Type: AcrMgntEventReport p. 168
8.6.5.2.7 Type: FailureAcrMgntEventInfo p. 170
8.6.5.2.8 Type: TargetUeIdentification p. 170
8.6.5.2.9 Type: UpPathChangeInfo p. 171
8.6.5.2.10 Type: IndUeIdentification p. 171
8.6.5.2.11 Type: AvailabilityNotif p. 171
8.6.5.2.12 Type: SelectedACRScenarios |R18| p. 172
8.6.5.2.13 Type: ACRParameters |R18| p. 172
8.6.5.2.14 Type: TrafficFilterInfo |R18| p. 172
8.6.5.2.15 Type: EasAckInformation |R18| p. 173
8.6.5.2.16 Type: EasInBundleInfo |R18| p. 173
8.6.5.3 Simple data types and enumerations p. 173
8.6.5.3.1 Introduction p. 173
8.6.5.3.2 Simple data types p. 173
8.6.5.3.3 Enumeration: AcrMgntEvent p. 173
8.6.5.3.4 Enumeration: AcrMgntEventFilter p. 174
8.6.5.3.5 Enumeration: ActStatus p. 174
8.6.5.3.6 Enumeration: AcrMgntEventFailureCode p. 174
8.6.5.3.7 Enumeration: AvailabilityStatus p. 174
8.6.5.3.8 Enumeration: ResultCode |R18| p. 174
8.6.6 Error Handling p. 175
8.6.6.1 General |R18| p. 175
8.6.6.2 Protocol Errors |R18| p. 175
8.6.6.3 Application Errors |R18| p. 175
8.6.7 Feature negotiation p. 175
8.7 Eees_EECContextRelocation API p. 175
8.7.1 API URI p. 175
8.7.1A Usage of HTTP |R18| p. 176
8.7.2 Resources p. 176
8.7.2.1 Overview p. 176
8.7.2.2 Resource: EEC Contexts p. 176
8.7.2.2.1 Description p. 176
8.7.2.2.2 Resource Definition p. 176
8.7.2.2.3 Resource Standard Methods p. 177
8.7.2.2.3.1 GET p. 177
8.7.2.2.3.2 POST p. 177
8.7.2.2.4 Resource Custom Operations p. 178
8.7.3 Custom Operations without associated resources p. 178
8.7.4 Notifications p. 178
8.7.5 Data Model p. 178
8.7.5.1 General p. 178
8.7.5.2 Structured data types p. 179
8.7.5.2.1 Introduction p. 179
8.7.5.2.2 Type: SessionContexts p. 179
8.7.5.2.3 Type: IndividualSessionContext p. 179
8.7.5.2.4 Type: EECContextPush p. 180
8.7.5.2.5 Type: EECContext p. 180
8.7.5.2.6 Type: EECContextPushRes p. 181
8.7.5.2.7 Type: ImplicitRegDetails p. 181
8.7.5.2.8 Type: EECSrvContinuitySupport |R18| p. 181
8.7.5.3 Simple data types and enumerations p. 181
8.7.5.4 Data types describing alternative data types or combinations of data types |R18| p. 182
8.7.5.5 Binary data |R18| p. 182
8.7.5.5.1 Binary Data Types p. 182
8.7.6 Error Handling p. 182
8.7.6.1 General |R18| p. 182
8.7.6.2 Protocol Errors |R18| p. 182
8.7.6.3 Application Errors |R18| p. 182
8.7.7 Feature negotiation p. 182
8.8 Eees_EELManagedACR API p. 183
8.8.1 Introduction p. 183
8.8.2 Usage of HTTP p. 183
8.8.3 Resources p. 183
8.8.3.1 Overview p. 183
8.8.3.2 Resource: ACT Status Subscriptions p. 184
8.8.3.2.1 Description p. 184
8.8.3.2.2 Resource Definition p. 184
8.8.3.2.3 Resource Standard Methods p. 184
8.8.3.2.3.1 GET p. 185
8.8.3.2.3.2 POST p. 185
8.8.3.2.4 Resource Custom Operations p. 186
8.8.3.3 Resource: Individual ACT Status Subscription p. 186
8.8.3.3.1 Description p. 186
8.8.3.3.2 Resource Definition p. 186
8.8.3.3.3 Resource Standard Methods p. 186
8.8.3.3.3.1 GET p. 187
8.8.3.3.4 Resource Custom Operations p. 187
8.8.4 Custom Operations without associated resources p. 188
8.8.4.1 Overview p. 188
8.8.4.2 Operation: RequestEELManagedACR p. 188
8.8.4.2.1 Description p. 188
8.8.4.2.2 Operation Definition p. 188
8.8.5 Notifications p. 189
8.8.5.1 General p. 189
8.8.5.2 ACT Status Notification p. 189
8.8.5.2.1 Description p. 189
8.8.5.2.2 Target URI p. 189
8.8.5.2.3 Standard Methods p. 190
8.8.5.2.3.1 POST p. 190
8.8.6 Data Model p. 190
8.8.6.1 General p. 190
8.8.6.2 Structured data types p. 191
8.8.6.2.1 Introduction p. 191
8.8.6.2.2 Type: EELACRReq p. 191
8.8.6.2.3 Type: EELACRResp p. 192
8.8.6.2.4 Type: ACTStatusSubsc p. 192
8.8.6.2.5 Type: ACTStatusNotif p. 192
8.8.6.3 Simple data types and enumerations p. 192
8.8.6.3.1 Introduction p. 192
8.8.6.3.2 Simple data types p. 192
8.8.6.4 Data types describing alternative data types or combinations of data types p. 193
8.8.6.5 Binary data p. 193
8.8.6.5.1 Binary Data Types p. 193
8.8.7 Error Handling p. 193
8.8.8 Feature negotiation p. 193
8.9 Eees_ACRStatusUpdate API p. 193
8.9.1 Introduction p. 193
8.9.2 Usage of HTTP p. 194
8.9.3 Resources p. 194
8.9.4 Custom Operations without associated resources p. 194
8.9.4.1 Overview p. 194
8.9.4.2 Operation: RequestACRUpdate p. 195
8.9.4.2.1 Description p. 195
8.9.4.2.2 Operation Definition p. 195
8.9.5 Notifications p. 195
8.9.6 Data Model p. 196
8.9.6.1 General p. 196
8.9.6.2 Structured data types p. 196
8.9.6.2.1 Introduction p. 196
8.9.6.2.2 Type: ACRUpdateData p. 197
8.9.6.2.3 Type: ACRDataStatus p. 197
8.9.6.2.4 Type: ACTResultInfo p. 198
8.9.6.3 Simple data types and enumerations p. 198
8.9.6.3.1 Introduction p. 198
8.9.6.3.2 Simple data types p. 198
8.9.6.3.3 Enumeration: ACTResult p. 198
8.9.6.3.4 Enumeration: E3SubscsStatus p. 198
8.9.6.3.5 Enumeration: ACTFailureCause p. 199
8.9.6.4 Data types describing alternative data types or combinations of data types p. 199
8.9.6.5 Binary data p. 199
8.9.6.5.1 Binary Data Types p. 199
8.9.7 Error Handling p. 199
8.9.8 Feature negotiation p. 199
8.10 Eees_ACRParameterInformation API |R18| p. 200
8.10.1 Introduction p. 200
8.10.2 Usage of HTTP p. 200
8.10.3 Resources p. 200
8.10.4 Custom Operations without associated resources p. 200
8.10.4.1 Overview p. 200
8.10.4.2 Operation: Request p. 201
8.10.4.2.1 Description p. 201
8.10.4.2.2 Operation Definition p. 201
8.10.5 Notifications p. 202
8.10.6 Data Model p. 202
8.10.6.1 General p. 202
8.10.6.2 Structured data types p. 202
8.10.6.2.1 Introduction p. 202
8.10.6.2.2 Type: ACRParamsInfo p. 202
8.10.6.3 Simple data types and enumerations p. 202
8.10.6.3.1 Introduction p. 202
8.10.6.3.2 Simple data types p. 203
8.10.6.4 Data types describing alternative data types or combinations of data types p. 203
8.10.6.5 Binary data p. 203
8.10.6.5.1 Binary Data Types p. 203
8.10.7 Error Handling p. 203
8.10.8 Feature negotiation p. 203
8.11 Eees_CommonEASAnnouncement API |R18| p. 204
8.11.1 Introduction p. 204
8.11.2 Usage of HTTP p. 204
8.11.3 Resources p. 204
8.11.4 Custom Operations without associated resources p. 204
8.11.4.1 Overview p. 204
8.11.4.2 Operation: Declare p. 205
8.11.4.2.1 Description p. 205
8.11.4.2.2 Operation Definition p. 205
8.11.5 Notifications p. 206
8.11.6 Data Model p. 206
8.11.6.1 General p. 206
8.11.6.2 Structured data types p. 206
8.11.6.2.1 Introduction p. 206
8.11.6.2.2 Type: CommonEASInfo p. 206
8.11.6.3 Simple data types and enumerations p. 206
8.11.6.3.1 Introduction p. 206
8.11.6.3.2 Simple data types p. 207
8.11.6.4 Data types describing alternative data types or combinations of data types p. 207
8.11.6.5 Binary data p. 207
8.11.6.5.1 Binary Data Types p. 207
8.11.7 Error Handling p. 207
8.11.8 Feature negotiation p. 207
8.12 Eees_TrafficInfluenceEAS API |R18| p. 208
8.12.1 Introduction p. 208
8.12.2 Usage of HTTP p. 208
8.12.3 Resources p. 208
8.12.3.1 Overview p. 208
8.12.3.2 Resource: Application Traffic Influence p. 209
8.12.3.2.1 Description p. 209
8.12.3.2.2 Resource Definition p. 209
8.12.3.2.3 Resource Standard Methods p. 209
8.12.3.2.3.1 POST p. 209
8.12.3.2.4 Resource Custom Operations p. 210
8.12.3.3 Resource: Individual Application Traffic Influence p. 210
8.12.3.3.1 Description p. 210
8.12.3.3.2 Resource Definition p. 210
8.12.3.3.3 Resource Standard Methods p. 210
8.12.3.3.3.1 GET p. 210
8.12.3.3.3.2 PUT p. 211
8.12.3.3.3.3 PATCH p. 212
8.12.3.3.3.4 DELETE p. 213
8.12.3.3.4 Resource Custom Operations p. 214
8.12.4 Notifications p. 214
8.12.5 Data Model p. 214
8.12.5.1 General p. 214
8.12.5.2 Structured data types p. 215
8.12.5.2.1 Introduction p. 215
8.12.5.2.2 Type: AppTrafficInfluence p. 216
8.12.5.2.3 Type: AppTrafficInfluencePatch p. 217
8.12.5.3 Simple data types and enumerations p. 217
8.12.5.3.1 Introduction p. 217
8.12.5.3.2 Simple data types p. 217
8.12.5.4 Data types describing alternative data types or combinations of data types p. 217
8.12.5.5 Binary data p. 217
8.12.5.5.1 Binary Data Types p. 217
8.12.6 Error Handling p. 218
8.12.7 Feature negotiation p. 218
8A CAS API Definitions |R18| p. 218
8A.1 Ecas_SelectedEES API p. 218
8A.1.1 Introduction p. 218
8A.1.2 Usage of HTTP p. 219
8A.1.3 Resources p. 219
8A.1.4 Custom Operations without associated resources p. 219
8A.1.4.1 Overview p. 219
8A.1.4.2 Operation: Declare p. 219
8A.1.4.2.1 Description p. 219
8A.1.4.2.2 Operation Definition p. 219
8A.1.5 Notifications p. 220
8A.1.6 Data Model p. 220
8A.1.6.1 General p. 220
8A.1.6.2 Structured data types p. 221
8A.1.6.2.1 Introduction p. 221
8A.1.6.2.2 Type: SelEESDecInfo p. 221
8A.1.6.3 Simple data types and enumerations p. 221
8A.1.6.3.1 Introduction p. 221
8A.1.6.3.2 Simple data types p. 221
8A.1.6.4 Data types describing alternative data types or combinations of data types p. 221
8A.1.6.5 Binary data p. 222
8A.1.6.5.1 Binary Data Types p. 222
8A.1.7 Error Handling p. 222
8A.1.8 Feature negotiation p. 222
