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.549 Word version: 18.4.0

1… 5… 7… 8…

5.1 Introduction of SEAL services 5.2 Location management APIs 5.3 Group management APIs 5.4 Configuration management APIs 5.5 Network resource management APIs 5.6 Events APIs 5.7 Key management APIs 5.8 Network slice capability Enablement APIs 5.9 Identity Management APIs 5.10 Data Delivery APIs
...

5 Services offered by the SEAL servers p. 25

5.1 Introduction of SEAL services p. 25

5.2 Location management APIs p. 28

5.2.1 SS_LocationReporting API p. 28

5.2.1.1 Service Description p. 28

5.2.1.1.1 Overview p. 28

5.2.1.2 Service Operations p. 28

5.2.1.2.1 Introduction p. 28

5.2.1.2.2 Create_Trigger_Location_Reporting p. 29

5.2.1.2.2.1 General p. 29

5.2.1.2.2.2 VAL server providing trigger configuration using Create_Trigger_Location_Reporting service operation p. 29

5.2.1.2.3 Fetch_Location_Report_Trigger p. 29

5.2.1.2.3.1 General p. 29

5.2.1.2.3.2 VAL server fetching trigger configuration using Fetch_Location_Report_Trigger service operation p. 29

5.2.1.2.4 Update_Trigger_Location_Reporting p. 30

5.2.1.2.4.1 General p. 30

5.2.1.2.4.2 VAL server providing trigger configuration using Update_Trigger_Location_Reporting service operation p. 30

5.2.1.2.5 Cancel_Trigger_Location_Reporting p. 30

5.2.1.2.5.1 General p. 30

5.2.1.2.5.2 VAL server providing trigger configuration using Cancel_Trigger_Location_Reporting service operation p. 30

5.2.1.2.6 Notify_Trigger_Location_Reporting |R18| p. 30

5.2.1.2.6.1 General p. 30

5.2.1.2.6.2 LM Server notifies the VAL Server on the location trigger event using Notify_Trigger_Location_Reporting p. 31

5.2.2 SS_LocationInfoEvent API p. 31

5.2.3 SS_LocationInfoRetrieval API p. 31

5.2.4 SS_LocationAreaInfoRetrieval API |R17| p. 31

5.2.4.1 Service Description p. 31

5.2.4.1.1 Overview p. 31

5.2.4.2 Service Operations p. 31

5.2.4.2.1 Introduction p. 31

5.2.4.2.2 Obtain_UEs_Info p. 32

5.2.4.2.2.1 General p. 32

5.2.4.2.2.2 VAL server obtains UE(s) information in an application defined proximity range of a location using Obtain_UEs_Info service operation p. 32

5.2.5 SS_LocationMonitoring API |R17| p. 32

5.2.6 SS_LocationAreaMonitoring API |R17| p. 33

5.2.7 SS_VALServiceAreaConfiguration API |R18| p. 33

5.2.7.1 Service Description p. 33

5.2.7.1.1 Overview p. 33

5.2.7.2 Service Operations p. 33

5.2.7.2.1 Introduction p. 33

5.2.7.2.2 Configure_VAL_Service_Area p. 34

5.2.7.2.2.1 General p. 34

5.2.7.2.2.2 VAL Server configures VAL service area(s) using the Configure_VAL_Service_Area service operation p. 34

5.2.7.2.3 Obtain_VAL_Service_Area p. 34

5.2.7.2.3.1 General p. 34

5.2.7.2.3.2 VAL Server obtains VAL service area(s) using the Obtain_VAL_Service_Area service operation p. 34

5.2.7.2.4 Update_VAL_Service_Area p. 35

5.2.7.2.4.1 General p. 35

5.2.7.2.4.2 VAL Server updates VAL service area(s) using the Update_VAL_Service_Area service operation p. 35

5.2.7.2.5 Delete_VAL_Service_Area p. 35

5.2.7.2.5.1 General p. 35

5.2.7.2.5.2 VAL Server deletes service area(s) using the Delete_VAL_Service_Area service operation p. 35

5.2.7.2.6 Subscribe_VAL_Service_Area_Change_Event p. 36

5.2.7.2.6.1 General p. 36

5.2.7.2.6.2 SEAL Server subscribes for the VAL service area(s) change event(s) reporting using the Subscribe_VAL_Service_Area_Change_Event service operation p. 36

5.2.7.2.7 Update_Subscription_VAL_Service_Area_Change_Event p. 36

5.2.7.2.7.1 General p. 36

5.2.7.2.7.2 SEAL Server updates the subscription for the VAL service area(s) change event(s) reporting using the Update_Subscription_VAL_Service_Area_Change_Event service operation p. 36

5.2.7.2.8 Unsubscribe_VAL_Service_Area_Change_Event p. 37

5.2.7.2.8.1 General p. 37

5.2.7.2.8.2 SEAL server unsubscribes from the VAL service area(s) change event(s) using Unsubscribe_VAL_Service_Area_Change_Event p. 37

5.2.7.2.9 Notify_VAL_Service_Area_Change_Event p. 37

5.2.7.2.9.1 General p. 37

5.2.7.2.9.2 LM server notifies the SEAL Server on VAL service area(s) change event(s) using Notify_VAL_Service_Area_Change_Event p. 37

5.3 Group management APIs p. 38

5.3.1 SS_GroupManagement API p. 38

5.3.1.1 Service Description p. 38

5.3.1.1.1 Overview p. 38

5.3.1.2 Service Operations p. 38

5.3.1.2.1 Introduction p. 38

5.3.1.2.2 Query_Group_Info p. 38

5.3.1.2.2.1 General p. 38

5.3.1.2.2.2 VAL server fetching VAL group documents, group membership and configuration information using Query_Group_Info service operation p. 38

5.3.1.2.3 Update_Group_Info p. 39

5.3.1.2.3.1 General p. 39

5.3.1.2.3.2 VAL server modifying group membership and configuration using Update_Group_Info service operation p. 39

5.3.1.2.4 Create_Group p. 40

5.3.1.2.4.1 General p. 40

5.3.1.2.4.2 VAL server creating new group using Create_Group service operation p. 40

5.3.1.2.5 Delete_Group p. 40

5.3.1.2.5.1 General p. 40

5.3.1.2.5.2 VAL server deleting VAL group using Delete_Group service operation p. 40

5.3.2 SS_GroupManagementEvent API p. 41

5.4 Configuration management APIs p. 41

5.4.1 SS_UserProfileRetrieval API p. 41

5.4.1.1 Service Description p. 41

5.4.1.1.1 Overview p. 41

5.4.1.2 Service Operations p. 41

5.4.1.2.1 Introduction p. 41

5.4.1.2.2 Obtain_User_Profile p. 41

5.4.1.2.2.1 General p. 41

5.4.1.2.2.2 VAL server retrieving VAL user profile information using Obtain_User_Profile service operation p. 42

5.4.2 SS_UserProfileEvent API p. 42

5.4.3 SS_VALServiceData API |R18| p. 42

5.4.3.1 Service Description p. 42

5.4.3.1.1 Overview p. 42

5.4.3.2 Service Operations p. 42

5.4.3.2.1 Introduction p. 42

5.4.3.2.2 Obtain_VAL_Service_Data p. 42

5.4.3.2.2.1 General p. 42

5.4.3.2.2.2 SEAL server retrieving VAL service data using Obtain_VAL_Service_Data service operation p. 42

5.5 Network resource management APIs p. 43

5.5.1 SS_NetworkResourceAdaptation API p. 43

5.5.1.1 Service Description p. 43

5.5.1.1.1 Overview p. 43

5.5.1.2 Service Operations p. 43

5.5.1.2.1 Introduction p. 43

5.5.1.2.2 Reserve_Network_Resource p. 44

5.5.1.2.2.1 General p. 44

5.5.1.2.2.2 VAL server requesting for network resource adaptation using Reserve_Network_Resource service operation p. 44

5.5.1.2.3 Request_Unicast_Resource p. 45

5.5.1.2.3.1 General p. 45

5.5.1.2.3.2 VAL server requesting for unicast resource using Request_Unicast_Resource service operation p. 45

5.5.1.2.4 Update_Unicast_Resource p. 45

5.5.1.2.4.1 General p. 45

5.5.1.2.4.2 VAL server requesting for updating the unicast resource using Update_Unicast_Resource service operation p. 45

5.5.1.2.5 Request_Multicast_Resource p. 45

5.5.1.2.5.1 General p. 45

5.5.1.2.5.2 VAL server requesting for multicast resource using Request_Multicast_Resource service operation p. 45

5.5.1.2.6 Notify_UP_Delivery_Mode p. 46

5.5.1.2.6.1 General p. 46

5.5.1.2.6.2 Notifying user plane events using Notify_UP_Delivery_Mode service operation p. 46

5.5.1.2.7 Create_TSC_Stream |R17| p. 46

5.5.1.2.7.1 General p. 46

5.5.1.2.7.2 VAL server requesting for create TSC stream using Create_TSC_Stream service operation p. 46

5.5.1.2.8 Delete_TSC_Stream |R17| p. 47

5.5.1.2.8.1 General p. 47

5.5.1.2.8.2 VAL server requesting to delete a TSC stream using Delete_TSC_Stream service operation p. 47

5.5.1.2.9 Discover_TSC_Stream_Availability |R17| p. 47

5.5.1.2.9.1 General p. 47

5.5.1.2.9.2 VAL server discovering TSC stream availability using Discover_TSC_Stream_Availability service operation p. 48

5.5.1.2.10 Create_MBS_Resource |R18| p. 48

5.5.1.2.10.1 General p. 48

5.5.1.2.10.2 VAL Server requesting the creation of an MBS Resource using the Create_MBS_Resource service operation p. 48

5.5.1.2.11 Update_MBS_Resource |R18| p. 49

5.5.1.2.11.1 General p. 49

5.5.1.2.11.2 VAL Server requesting the update of an existing MBS Resource using the Update_MBS_Resource service operation p. 49

5.5.1.2.12 Delete_MBS_Resource |R18| p. 49

5.5.1.2.12.1 General p. 49

5.5.1.2.12.2 VAL Server requesting the deletion of an existing MBS Resource using the Delete_MBS_Resource service operation p. 49

5.5.1.2.13 Activate_MBS_Resource |R18| p. 49

5.5.1.2.13.1 General p. 49

5.5.1.2.13.2 VAL Server requesting the activation of an existing MBS Resource using the Activate_MBS_Resource service operation p. 50

5.5.1.2.14 Deactivate_MBS_Resource |R18| p. 50

5.5.1.2.14.1 General p. 50

5.5.1.2.14.2 VAL Server requesting the deactivation of an existing MBS Resource using the Deactivate_MBS_Resource service operation p. 50

5.5.1.2.15 BDT_Configuration_Request |R18| p. 50

5.5.1.2.15.1 General p. 50

5.5.1.2.15.2 VAL Server requesting the background data transfer policy using the BDT_Configuration_Request service operation p. 50

5.5.1.2.16 BDT_Negotiation_Notification |R18| p. 51

5.5.1.2.16.1 General p. 51

5.5.1.2.16.2 NRM Server notifying the background data transfer policy using the BDT_Negotiation_Notification service operation p. 51

5.5.2 SS_EventsMonitoring API |R17| p. 51

5.5.3 SS_NetworkResourceMonitoring API |R17| p. 51

5.5.3.1 Service Description p. 51

5.5.3.1.1 Overview p. 51

5.5.3.2 Service Operations p. 51

5.5.3.2.1 Introduction p. 51

5.5.3.2.2 Subscribe_Unicast_QoS_Monitoring p. 52

5.5.3.2.2.1 General p. 52

5.5.3.2.2.2 VAL server subscribes for Unicast QoS Monitoring using Subscribe_Unicast_QoS_Monitoring p. 52

5.5.3.2.3 Unsubscribe_Unicast_QoS_Monitoring p. 53

5.5.3.2.3.1 General p. 53

5.5.3.2.3.2 VAL server unsubscribes for Unicast QoS Monitoring using Unsubscribe_Unicast_QoS_Monitoring p. 53

5.5.3.2.4 Notify_Unicast_QoS_Monitoring p. 53

5.5.3.2.4.1 General p. 53

5.5.3.2.4.2 NRM server notifies for Unicast QoS Monitoring using Notify_Unicast_QoS_Monitoring p. 53

5.5.3.2.5 Obtain_Unicast_QoS_Monitoring_Data p. 54

5.5.3.2.5.1 General p. 54

5.5.3.2.6 Update_Unicast_QoS_Monitoring_Subscription |R18| p. 54

5.5.3.2.6.1 General p. 54

5.5.3.2.6.2 VAL server modifies for Unicast QoS Monitoring Subscription using Update_Unicast_QoS_Monitoring Subscription p. 54

5.6 Events APIs p. 55

5.6.1 SS_Events API p. 55

5.6.1.1 Service Description p. 55

5.6.1.1.1 Overview p. 55

5.6.1.2 Service Operations p. 55

5.6.1.2.1 Introduction p. 55

5.6.1.2.2 Subscribe_Event p. 56

5.6.1.2.2.1 General p. 56

5.6.1.2.2.2 Subscribing to SEAL events using Subscribe_Event service operation p. 56

5.6.1.2.3 Notify_Event p. 56

5.6.1.2.3.1 General p. 56

5.6.1.2.3.2 Notifying SEAL events using Notify_Event service operation p. 56

5.6.1.2.4 Unsubscribe_Event p. 56

5.6.1.2.4.1 General p. 56

5.6.1.2.4.2 Unsubscribing from SEAL events using Unsubscribe_Event service operation p. 56

5.6.1.2.5 Update_Subscription |R17| p. 57

5.6.1.2.5.1 General p. 57

5.6.1.2.5.2 Updating the SEAL events subscription using Update_Subscription service operation p. 57

5.7 Key management APIs p. 57

5.7.1 SS_KeyInfoRetrieval API p. 57

5.7.1.1 Service Description p. 57

5.7.1.1.1 Overview p. 57

5.7.1.2 Service Operations p. 57

5.7.1.2.1 Introduction p. 57

5.7.1.2.2 Obtain_Key_Info p. 57

5.7.1.2.2.1 General p. 57

5.7.1.2.2.2 VAL server obtaining VAL service specific key material using Obtain_Key_Info service operation p. 58

5.8 Network slice capability Enablement APIs |R17| p. 58

5.8.1 SS_NetworkSliceAdaptation API p. 58

5.8.1.1 Service Description p. 58

5.8.1.1.1 Overview p. 58

5.8.1.2 Service Operations p. 58

5.8.1.2.1 Introduction p. 58

5.8.1.2.2 Network_slice_adaptation p. 58

5.8.1.2.2.1 General p. 58

5.8.1.2.2.2 VAL server requesting network slice adaptation using Network_slice_adaptation service operation p. 58

5.9 Identity Management APIs |R18| p. 59

5.9.1 SS_IdmParameterProvisioning API p. 59

5.9.1.1 Service Description p. 59

5.9.1.1.1 Overview p. 59

5.9.1.2 Service Operations p. 59

5.9.1.2.1 Introduction p. 59

5.9.1.2.2 Provide_Configuration p. 60

5.9.1.2.2.1 General p. 60

5.9.1.2.2.2 VAL server provisioning VAL service specific information using Provide_Configuration service operation p. 60

5.9.1.2.3 Get_Configuration p. 60

5.9.1.2.3.1 General p. 60

5.9.1.2.3.2 Service consumer obtaining the VAL service specific information provisioned using Get_Configuration service operation p. 60

5.9.1.2.4 Update_Configuration p. 60

5.9.1.2.4.1 General p. 60

5.9.1.2.4.2 Service consumer updating VAL service specific information using Update_Configuration service operation p. 61

5.9.1.2.5 Delete_Configuration p. 61

5.9.1.2.5.1 General p. 61

5.9.1.2.5.2 Service consumer deleting VAL service specific information using Delete_Configuration service operation p. 61

5.10 Data Delivery APIs |R18| p. 61

6 SEAL Design Aspects Common for All APIs p. 61

6.1 General p. 61

6.2 Data Types p. 62

6.2.1 General p. 62

6.2.2 Referenced structured data types p. 62

6.2.3 Referenced Simple data types and enumerations p. 62

6.3 Usage of HTTP p. 63

6.4 Content type p. 63

6.5 URI structure p. 63

6.6 Notifications p. 64

6.7 Error Handling p. 64

6.8 Feature negotiation p. 64

6.9 HTTP headers p. 64

6.10 Conventions for Open API specification files p. 64