1、 ETSI TS 129 198-3 V9.0.0 (2010-01)Technical Specification Digital cellular telecommunications system (Phase 2+);Universal Mobile Telecommunications System (UMTS);LTE;Open Service Access (OSA)Application Programming Interface (API);Part 3: Framework (3GPP TS 29.198-03 version 9.0.0 Release 9)floppy3
2、ETSI ETSI TS 129 198-3 V9.0.0 (2010-01)13GPP TS 29.198-03 version 9.0.0 Release 9Reference RTS/TSGC-0029198-03v900 Keywords GSM, LTE, UMTS ETSI 650 Route des Lucioles F-06921 Sophia Antipolis Cedex - FRANCE Tel.: +33 4 92 94 42 00 Fax: +33 4 93 65 47 16 Siret N 348 623 562 00017 - NAF 742 C Associat
3、ion but non lucratif enregistre la Sous-Prfecture de Grasse (06) N 7803/88 Important notice Individual copies of the present document can be downloaded from: http:/www.etsi.org The present document may be made available in more than one electronic version or in print. In any case of existing or perc
4、eived difference in contents between such versions, the reference version is the Portable Document Format (PDF). In case of dispute, the reference shall be the printing on ETSI printers of the PDF version kept on a specific network drive within ETSI Secretariat. Users of the present document should
5、be aware that the document may be subject to revision or change of status. Information on the current status of this and other ETSI documents is available at http:/portal.etsi.org/tb/status/status.asp If you find errors in the present document, please send your comment to one of the following servic
6、es: http:/portal.etsi.org/chaircor/ETSI_support.asp Copyright Notification No part may be reproduced except as authorized by written permission. The copyright and the foregoing restriction extend to reproduction in all media. European Telecommunications Standards Institute 2010. All rights reserved.
7、 DECTTM, PLUGTESTSTM, UMTSTM, TIPHONTM, the TIPHON logo and the ETSI logo are Trade Marks of ETSI registered for the benefit of its Members. 3GPPTM is a Trade Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. LTE is a Trade Mark of ETSI currently being r
8、egistered for the benefit of its Members and of the 3GPP Organizational Partners. GSM and the GSM logo are Trade Marks registered and owned by the GSM Association. ETSI ETSI TS 129 198-3 V9.0.0 (2010-01)23GPP TS 29.198-03 version 9.0.0 Release 9Intellectual Property Rights IPRs essential or potentia
9、lly essential to the present document may have been declared to ETSI. The information pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found in ETSI SR 000 314: “Intellectual Property Rights (IPRs); Essential, or potentially Essential, IP
10、Rs notified to ETSI in respect of ETSI standards“, which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web server (http:/webapp.etsi.org/IPR/home.asp). Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guara
11、ntee can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web server) which are, or may be, or may become, essential to the present document. Foreword This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Projec
12、t (3GPP). The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. The cross reference between GSM, UMTS, 3GPP and ETSI identities can
13、be found under http:/webapp.etsi.org/key/queryform.asp. ETSI ETSI TS 129 198-3 V9.0.0 (2010-01)33GPP TS 29.198-03 version 9.0.0 Release 9Contents Intellectual Property Rights 2g3Foreword . 2g3Foreword . 13g3Introduction 13g31 Scope 15g32 References 15g33 Definitions, symbols and abbreviations . 16g3
14、3.1 Definitions 16g33.2 Abbreviations . 16g34 Overview of the Framework . 16g35 The Base Interface Specification 17g35.1 Interface Specification Format . 17g35.1.1 Interface Class 18g35.1.2 Method descriptions 18g35.1.3 Parameter descriptions 18g35.1.4 State Model . 18g35.2 Base Interface . 18g35.2.
15、1 Interface Class IpInterface 18g35.3 Service Interfaces . 18g35.3.1 Overview 18g35.4 Generic Service Interface . 19g35.4.1 Interface Class IpService 19g35.4.1.1 Method setCallback() 19g35.4.1.2 Method setCallbackWithSessionID() 19g36 Framework Access Session API . 20g36.1 Sequence Diagrams 20g36.1.
16、1 Trust and Security Management Sequence Diagrams 20g36.1.1.1 Initial Access. 20g36.1.1.2 Framework Terminates Access . 22g36.1.1.3 Application Terminates Access. 23g36.1.1.4 Non-API level Authentication . 23g36.1.1.5 API Level Authentication . 24g36.2 Class Diagrams . 26g36.3 Interface Classes . 27
17、g36.3.1 Trust and Security Management Interface Classes . 27g36.3.1.1 Interface Class IpClientAPILevelAuthentication 27g36.3.1.1.1 Method abortAuthentication() . 28g36.3.1.1.2 Method authenticationSucceeded() . 28g36.3.1.1.3 Method challenge() 28g36.3.1.2 Interface Class IpClientAccess 29g36.3.1.2.1
18、 Method terminateAccess() . 30g36.3.1.3 Interface Class IpInitial . 30g36.3.1.3.1 Method initiateAuthenticationWithVersion() 31g36.3.1.4 Interface Class IpAuthentication . 32g36.3.1.4.1 Method requestAccess() 32g36.3.1.5 Interface Class IpAPILevelAuthentication . 33g36.3.1.5.1 Method abortAuthentica
19、tion() . 33g36.3.1.5.2 Method authenticationSucceeded() . 34g36.3.1.5.3 Method selectAuthenticationMechanism() 34g36.3.1.5.4 Method challenge() 34g36.3.1.6 Interface Class IpAccess . 36g3ETSI ETSI TS 129 198-3 V9.0.0 (2010-01)43GPP TS 29.198-03 version 9.0.0 Release 96.3.1.6.1 Method obtainInterface
20、() . 36g36.3.1.6.2 Method obtainInterfaceWithCallback() . 36g36.3.1.6.3 Method listInterfaces() 37g36.3.1.6.4 Method selectSigningAlgorithm() . 37g36.3.1.6.5 Method terminateAccess() . 38g36.3.1.6.6 Method relinquishInterface() . 38g36.4 State Transition Diagrams 39g36.4.1 Trust and Security Managem
21、ent State Transition Diagrams 39g36.4.1.1 State Transition Diagrams for IpInitial . 39g36.4.1.2 State Transition Diagrams for IpAPILevelAuthentication 39g36.4.1.2.1 Idle State 40g36.4.1.2.2 Authenticating Framework State . 40g36.4.1.2.3 Framework Authenticated State 41g36.4.1.2.4 Authenticating Clie
22、nt State 41g36.4.1.2.5 Client Authenticated State . 41g36.4.1.2.6 Idle State 42g36.4.1.2.7 Authenticating Framework State . 42g36.4.1.2.8 Framework Authenticated State 42g36.4.1.2.9 Authenticating Client State 43g36.4.1.2.10 Client Authenticated State . 43g36.4.1.3 State Transition Diagrams for IpAc
23、cess 43g36.4.1.3.1 Active State . 44g37 Framework-to-Application API . 44g37.1 Sequence Diagrams 44g37.1.1 Event Notification Sequence Diagrams 44g37.1.1.1 Enable Event Notification . 44g37.1.2 Integrity Management Sequence Diagrams 45g37.1.2.1 Load Management: Suspend/resume notification from appli
24、cation 45g37.1.2.2 Load Management: Framework queries load statistics . 46g37.1.2.3 Load Management: Framework callback registration and Application load control 47g37.1.2.4 Load Management: Application reports current load condition 48g37.1.2.5 Load Management: Application queries load statistics .
25、 49g37.1.2.6 Load Management: Application callback registration and load control 50g37.1.2.7 Heartbeat Management: Start/perform/end heartbeat supervision of the application . 51g37.1.2.8 Fault Management: Framework detects a Service failure . 52g37.1.2.9 Fault Management: Application requests a Fra
26、mework activity test 53g37.1.3 Service Discovery Sequence Diagrams 54g37.1.3.1 Service Discovery . 54g37.1.4 Service Agreement Management Sequence Diagrams . 56g37.1.4.1 Service Selection . 56g37.2 Class Diagrams . 58g37.3 Interface Classes . 61g37.3.1 Service Discovery Interface Classes . 61g37.3.1
27、.1 Interface Class IpServiceDiscovery 61g37.3.1.1.1 Method listServiceTypes() 62g37.3.1.1.2 Method describeServiceType() 62g37.3.1.1.3 Method discoverService() 63g37.3.1.1.4 Method listSubscribedServices() . 64g37.3.2 Service Agreement Management Interface Classes 64g37.3.2.1 Interface Class IpAppSe
28、rviceAgreementManagement . 64g37.3.2.1.1 Method signServiceAgreement() . 65g37.3.2.1.2 Method terminateServiceAgreement() 65g37.3.2.2 Interface Class IpServiceAgreementManagement 66g37.3.2.2.1 Method signServiceAgreement() . 66g37.3.2.2.2 Method terminateServiceAgreement() 67g37.3.2.2.3 Method selec
29、tService() 68g37.3.2.2.4 Method initiateSignServiceAgreement() . 68g37.3.3 Integrity Management Interface Classes . 69g37.3.3.1 Interface Class IpAppFaultManager . 69g37.3.3.1.1 Method activityTestRes() 69g37.3.3.1.2 Method appActivityTestReq() . 70g3ETSI ETSI TS 129 198-3 V9.0.0 (2010-01)53GPP TS 2
30、9.198-03 version 9.0.0 Release 97.3.3.1.3 Method fwFaultReportInd() . 70g37.3.3.1.4 Method fwFaultRecoveryInd() . 70g37.3.3.1.5 Method fwUnavailableInd() . 70g37.3.3.1.6 Method activityTestErr() . 71g37.3.3.1.7 Method appUnavailableInd(). 71g37.3.3.1.8 Method svcAvailStatusInd() 71g37.3.3.1.9 Method
31、 generateFaultStatisticsRecordRes() 71g37.3.3.1.10 Method generateFaultStatisticsRecordErr() 72g37.3.3.1.11 Method generateFaultStatisticsRecordReq() . 72g37.3.3.1.12 Method fwAvailStatusInd() . 72g37.3.3.2 Interface Class IpFaultManager 73g37.3.3.2.1 Method activityTestReq() 73g37.3.3.2.2 Method ap
32、pActivityTestRes() . 74g37.3.3.2.3 Method svcUnavailableInd() . 74g37.3.3.2.4 Method appActivityTestErr() 74g37.3.3.2.5 Method appAvailStatusInd() . 75g37.3.3.2.6 Method generateFaultStatisticsRecordReq() . 75g37.3.3.2.7 Method generateFaultStatisticsRecordRes() 76g37.3.3.2.8 Method generateFaultSta
33、tisticsRecordErr() 76g37.3.3.3 Interface Class IpAppHeartBeatMgmt 76g37.3.3.3.1 Method enableAppHeartBeat() 77g37.3.3.3.2 Method disableAppHeartBeat() . 77g37.3.3.3.3 Method changeInterval() . 77g37.3.3.4 Interface Class IpAppHeartBeat 77g37.3.3.4.1 Method pulse() 78g37.3.3.5 Interface Class IpHeart
34、BeatMgmt . 78g37.3.3.5.1 Method enableHeartBeat() 78g37.3.3.5.2 Method disableHeartBeat() 79g37.3.3.5.3 Method changeInterval() . 79g37.3.3.6 Interface Class IpHeartBeat 79g37.3.3.6.1 Method pulse() 79g37.3.3.7 Interface Class IpAppLoadManager . 80g37.3.3.7.1 Method loadLevelNotification() 80g37.3.3
35、.7.2 Method resumeNotification() 80g37.3.3.7.3 Method suspendNotification(). 81g37.3.3.7.4 Method createLoadLevelNotification() . 81g37.3.3.7.5 Method destroyLoadLevelNotification() . 81g37.3.3.7.6 Method queryAppLoadStatsReq() . 81g37.3.3.7.7 Method queryLoadStatsRes() 81g37.3.3.7.8 Method queryLoa
36、dStatsErr() . 82g37.3.3.8 Interface Class IpLoadManager 82g37.3.3.8.1 Method reportLoad() . 83g37.3.3.8.2 Method createLoadLevelNotification() . 83g37.3.3.8.3 Method destroyLoadLevelNotification() . 84g37.3.3.8.4 Method resumeNotification() 84g37.3.3.8.5 Method suspendNotification(). 84g37.3.3.8.6 M
37、ethod queryLoadStatsReq() 85g37.3.3.8.7 Method queryAppLoadStatsRes() . 85g37.3.3.8.8 Method queryAppLoadStatsErr() 86g37.3.3.9 Interface Class IpOAM . 86g37.3.3.9.1 Method systemDateTimeQuery() 86g37.3.3.10 Interface Class IpAppOAM 87g37.3.3.10.1 Method systemDateTimeQuery() 87g37.3.4 Event Notific
38、ation Interface Classes . 87g37.3.4.1 Interface Class IpAppEventNotification . 87g37.3.4.1.1 Method reportNotification() 88g37.3.4.1.2 Method notificationTerminated() 88g37.3.4.2 Interface Class IpEventNotification 88g37.3.4.2.1 Method createNotification() 89g37.3.4.2.2 Method destroyNotification()
39、89g37.4 State Transition Diagrams 89g37.4.1 Service Discovery State Transition Diagrams 89g3ETSI ETSI TS 129 198-3 V9.0.0 (2010-01)63GPP TS 29.198-03 version 9.0.0 Release 97.4.1.1 State Transition Diagrams for IpServiceDiscovery . 89g37.4.1.1.1 Active State . 90g37.4.2 Service Agreement Management
40、State Transition Diagrams . 90g37.4.3 Integrity Management State Transition Diagrams 90g37.4.3.1 State Transition Diagrams for IpLoadManager . 90g37.4.3.1.1 Idle State 91g37.4.3.1.2 Notification Suspended State . 91g37.4.3.1.3 Active State . 91g37.4.3.2 State Transition Diagrams for LoadManagerInter
41、nal 91g37.4.3.2.1 Normal load State 92g37.4.3.2.2 Application Overload State . 92g37.4.3.2.3 Internal overload State . 92g37.4.3.2.4 Internal and Application Overload State . 92g37.4.3.3 State Transition Diagrams for IpOAM 93g37.4.3.3.1 Active State . 93g37.4.3.4 State Transition Diagrams for IpFaul
42、tManager . 93g37.4.3.4.1 Framework Active State 94g37.4.3.4.2 Framework Faulty State. 94g37.4.3.4.3 Framework Activity Test State 94g37.4.3.4.4 Service Activity Test State 94g37.4.4 Event Notification State Transition Diagrams 94g37.4.4.1 State Transition Diagrams for IpEventNotification 94g38 Frame
43、work-to-Service API 95g38.1 Sequence Diagrams 95g38.1.1 Service Discovery Sequence Diagrams 95g38.1.2 Service Registration Sequence Diagrams . 95g38.1.2.1 New SCF Sub Type Registration 95g38.1.2.2 New SCF Registration. 96g38.1.3 Service Instance Lifecycle Manager Sequence Diagrams . 98g38.1.3.1 Sign
44、 Service Agreement 98g38.1.4 Integrity Management Sequence Diagrams 99g38.1.4.1 Load Management: Service callback registration and load control . 99g38.1.4.2 Load Management: Framework callback registration and service load control 100g38.1.4.3 Load Management: Client and Service Load Balancing . 10
45、1g38.1.4.4 Heartbeat Management: Start/perform/end heartbeat supervision of the service 102g38.1.4.5 Fault Management: Service requests Framework activity test 103g38.1.4.6 Fault Management: Service requests Application activity test . 104g38.1.4.7 Fault Management: Application requests Service acti
46、vity test . 104g38.1.4.8 Fault Management: Application detects service is unavailable . 106g38.1.5 Event Notification Sequence Diagrams 106g38.2 Class Diagrams . 106g38.3 Interface Classes . 110g38.3.1 Service Registration Interface Classes 110g38.3.1.1 Interface Class IpFwServiceRegistration 110g38
47、.3.1.1.1 Method registerService() . 110g38.3.1.1.2 Method announceServiceAvailability() . 111g38.3.1.1.3 Method unregisterService() . 112g38.3.1.1.4 Method describeService() 112g38.3.1.1.5 Method unannounceService() 113g38.3.1.1.6 Method registerServiceSubType() . 113g38.3.2 Service Instance Lifecyc
48、le Manager Interface Classes 114g38.3.2.1 Interface Class IpServiceInstanceLifecycleManager 114g38.3.2.1.1 Method createServiceManager() . 115g38.3.2.1.2 Method destroyServiceManager() . 115g38.3.3 Service Discovery Interface Classes . 116g38.3.3.1 Interface Class IpFwServiceDiscovery . 116g38.3.3.1
49、.1 Method listServiceTypes() 116g38.3.3.1.2 Method describeServiceType() 117g38.3.3.1.3 Method discoverService() 117g38.3.3.1.4 Method listRegisteredServices() 118g38.3.4 Integrity Management Interface Classes . 118g3ETSI ETSI TS 129 198-3 V9.0.0 (2010-01)73GPP TS 29.198-03 version 9.0.0 Release 98.3.4.1 Interface Class IpFwFaultManager . 118g38.3.4.1.1 Method activityTestReq() 119g38.3.4.1.2 Method svcActivityTestRes() 120g38.3.4.1.3 Method appUnavailableInd() . 120g38.3.4.1.4 Method svcActivityTestErr() . 120g38.3.4.1.5 Method svcAvailStatusInd() 121g38.3.4.1.6 Method gener
