1、 ETSI ES 204 915-13 V1.1.1 (2008-05)ETSI Standard Open Service Access (OSA);Application Programming Interface (API);Part 13: Policy Management SCF(Parlay 6)floppy3 ETSI ETSI ES 204 915-13 V1.1.1 (2008-05) 2 Reference DES/TISPAN-01032-13-OSA Keywords API, IDL, OSA, UML ETSI 650 Route des Lucioles F-0
2、6921 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 Association 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.et
3、si.org The present document may be made available in more than one electronic version or in print. In any case of existing or perceived 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 o
4、n ETSI printers of the PDF version kept on a specific network drive within ETSI Secretariat. Users of the present document should 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
5、.etsi.org/tb/status/status.asp If you find errors in the present document, please send your comment to one of the following services: 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 for
6、egoing restriction extend to reproduction in all media. European Telecommunications Standards Institute 2008. The Parlay Group 2008. All rights reserved. DECTTM, PLUGTESTSTM, UMTSTM, TIPHONTM, the TIPHON logo and the ETSI logo are Trade Marks of ETSI registered for the benefit of its Members. 3GPPTM
7、 is a Trade Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. ETSI ETSI ES 204 915-13 V1.1.1 (2008-05) 3 Contents Intellectual Property Rights9 Foreword.9 1 Scope 10 2 References 10 3 Definitions and abbreviations.10 3.1 Definitions10 3.2 Abbreviations .
8、10 4 Policy Management SCF11 5 Sequence Diagrams 11 5.1 Use of Policy Repository11 5.2 Introduce condition and action into rule.13 5.3 Create event15 5.4 Create and modify domain .17 5.5 ASP offering services to prepaid subscribers .19 5.6 Create Signature for an evaluation context.21 5.7 Request Ev
9、aluation of Policies.23 5.8 Register for and Receive Notification of a Policy Event23 6 Class Diagrams.24 6.1 PM Provisioning SCF Class Diagrams.25 6.2 PM Policy Evaluation SCF Class Diagrams.27 7 The Service Interface Specifications27 7.1 Interface Specification Format .27 7.1.1 Interface Class 27
10、7.1.2 Method descriptions27 7.1.3 Parameter descriptions27 7.1.4 State Model.28 7.2 Base Interface.28 7.2.1 Interface Class IpInterface 28 7.3 Service Interfaces .28 7.3.1 Overview 28 7.4 Generic Service Interface .28 7.4.1 Interface Class IpService 28 7.4.1.1 Method setCallback()29 7.4.1.2 Method s
11、etCallbackWithSessionID()29 8 Policy Management (PM) Interface Classes 29 8.1 PM Provisioning SCF Interface Classes.29 8.1.1 Interface Class IpPolicyManager30 8.1.1.1 Method createDomain() 30 8.1.1.2 Method getDomain().31 8.1.1.3 Method removeDomain()31 8.1.1.4 Method getDomainCount() .31 8.1.1.5 Me
12、thod getDomainIterator() .31 8.1.1.6 Method findMatchingDomains().32 8.1.1.7 Method createRepository()32 8.1.1.8 Method getRepository() 32 8.1.1.9 Method removeRepository() .33 8.1.1.10 Method getRepositoryCount().33 8.1.1.11 Method getRepositoryIterator().33 8.1.1.12 Method startTransaction().34 8.
13、1.1.13 Method commitTransaction()34 8.1.1.14 Method abortTransaction()34 ETSI ETSI ES 204 915-13 V1.1.1 (2008-05) 4 8.1.2 Interface Class IpPolicy35 8.1.2.1 Attributes.35 8.1.2.2 Method getAttribute() .36 8.1.2.3 Method setAttribute()36 8.1.2.4 Method getAttributes()36 8.1.2.5 Method setAttributes()
14、 37 8.1.3 Interface Class IpPolicyDomain .37 8.1.3.1 Attributes.39 8.1.3.2 Method getParentDomain().40 8.1.3.3 Method createDomain() 40 8.1.3.4 Method getDomain().40 8.1.3.5 Method removeDomain()41 8.1.3.6 Method getDomainCount() .41 8.1.3.7 Method getDomainIterator() .41 8.1.3.8 Method createGroup(
15、).41 8.1.3.9 Method getGroup()42 8.1.3.10 Method removeGroup() 42 8.1.3.11 Method getGroupCount()42 8.1.3.12 Method getGroupIterator()43 8.1.3.13 Method createRule()43 8.1.3.14 Method getRule() 43 8.1.3.15 Method removeRule() .44 8.1.3.16 Method getRuleCount() 44 8.1.3.17 Method getRuleIterator() 44
16、 8.1.3.18 Method createEventDefinition() .44 8.1.3.19 Method getEventDefinition() 45 8.1.3.20 Method removeEventDefinition().45 8.1.3.21 Method getEventDefinitionCount() 45 8.1.3.22 Method getEventDefinitionIterator() 46 8.1.3.23 Method createVariableSet() 46 8.1.3.24 Method getVariableSet().46 8.1.
17、3.25 Method removeVariableSet()47 8.1.3.26 Method getVariableSetCount() .47 8.1.3.27 Method getVariableSetIterator() .47 8.1.3.28 Method createVariable() .47 8.1.3.29 Method setVariableValue().48 8.1.3.30 Method getVariableType()48 8.1.3.31 Method getVariableValue().48 8.1.3.32 Method getVariable()4
18、9 8.1.3.33 Method removeVariable().49 8.1.3.34 Method createSignature()50 8.1.3.35 Method getSignature() 50 8.1.3.36 Method removeSignature() .50 8.1.3.37 Method getSignatureCount().50 8.1.3.38 Method getSignatureIterator().51 8.1.4 Interface Class IpPolicyGroup51 8.1.4.1 Attributes.52 8.1.4.2 Metho
19、d getParentDomain().53 8.1.4.3 Method getParentGroup() .53 8.1.4.4 Method createGroup().53 8.1.4.5 Method getGroup()54 8.1.4.6 Method removeGroup() 54 8.1.4.7 Method getGroupCount()54 8.1.4.8 Method getGroupIterator()54 8.1.4.9 Method createRule()55 8.1.4.10 Method getRule() 55 8.1.4.11 Method remov
20、eRule() .55 8.1.4.12 Method getRuleCount() 56 8.1.4.13 Method getRuleIterator() 56 8.1.5 Interface Class IpPolicyRepository.56 8.1.5.1 Attributes.57 8.1.5.2 Method getParentRepository() 58 ETSI ETSI ES 204 915-13 V1.1.1 (2008-05) 5 8.1.5.3 Method createRepository()58 8.1.5.4 Method getRepository() 5
21、8 8.1.5.5 Method removeRepository() .59 8.1.5.6 Method getRepositoryCount().59 8.1.5.7 Method getRepositoryIterator().59 8.1.5.8 Method createCondition() .60 8.1.5.9 Method getCondition()60 8.1.5.10 Method removeCondition().60 8.1.5.11 Method getConditionCount() 61 8.1.5.12 Method getConditionIterat
22、or() 61 8.1.5.13 Method createAction() 61 8.1.5.14 Method getAction().62 8.1.5.15 Method removeAction()62 8.1.5.16 Method getActionCount() .62 8.1.5.17 Method getActionIterator() .62 8.1.6 Interface Class IpPolicyRule.63 8.1.6.1 Attributes.65 8.1.6.2 Method getParentGroup() .67 8.1.6.3 Method getPar
23、entDomain().67 8.1.6.4 Method createCondition() .67 8.1.6.5 Method getCondition()68 8.1.6.6 Method removeCondition().68 8.1.6.7 Method getConditionCount() 68 8.1.6.8 Method getConditionIterator() 69 8.1.6.9 Method createAction() 69 8.1.6.10 Method getAction().70 8.1.6.11 Method removeAction()70 8.1.
24、6.12 Method getActionCount() .70 8.1.6.13 Method getActionIterator() .70 8.1.6.14 Method setValidityPeriodConditionByName().71 8.1.6.15 Method setValidityPeriodCondition().71 8.1.6.16 Method getValidityPeriodCondition() 71 8.1.6.17 Method unsetValidityPeriodCondition().71 8.1.6.18 Method setConditio
25、nList() 72 8.1.6.19 Method getConditionList()72 8.1.6.20 Method setActionList() .72 8.1.6.21 Method getActionList().72 8.1.7 Interface Class IpPolicyCondition 73 8.1.7.1 Attributes.74 8.1.7.2 Method getParentRepository() 75 8.1.7.3 Method getParentRule() 75 8.1.8 Interface Class IpPolicyTimePeriodCo
26、ndition .75 8.1.8.1 Attributes.76 8.1.9 Interface Class IpPolicyAction .78 8.1.9.1 Attributes.79 8.1.9.2 Method getParentRepository() 80 8.1.9.3 Method getParentRule() 80 8.1.10 Interface Class IpPolicyEventDefinition 80 8.1.10.1 Attributes.81 8.1.10.2 Method setRequiredAttributes()81 8.1.10.3 Metho
27、d setOptionalAttributes() 82 8.1.10.4 Method getRequiredAttributes() .82 8.1.10.5 Method getOptionalAttributes()82 8.1.10.6 Method getParentDomain().82 8.1.11 Interface Class IpPolicyEventCondition.83 8.1.11.1 Attributes.83 8.1.12 Interface Class IpPolicyExpressionCondition 84 8.1.12.1 Attributes.84
28、 8.1.13 Interface Class IpPolicyEventAction85 8.1.13.1 Attributes.85 8.1.14 Interface Class IpPolicyExpressionAction86 8.1.14.1 Attributes.86 ETSI ETSI ES 204 915-13 V1.1.1 (2008-05) 6 8.1.15 Interface Class IpPolicyIterator 87 8.1.15.1 Attributes.87 8.1.15.2 Method getList() .88 8.1.16 Interface Cl
29、ass IpPolicySignature.88 8.1.16.1 Attributes.89 8.1.16.2 Method setInputVariables().90 8.1.16.3 Method setOutputVariables()90 8.1.16.4 Method getInputVariables() 90 8.1.16.5 Method getOutputVariables() .91 8.1.16.6 Method setGroupNames().91 8.1.16.7 Method setPolicyRoles().91 8.1.16.8 Method getGrou
30、pNames() 91 8.1.16.9 Method getPolicyRoles() 92 8.1.16.10 Method getParentDomain().92 8.2 PM Policy Evaluation SCF Interface Classes.92 8.2.1 Interface Class IpPolicyEvalManager.93 8.2.1.1 Method evalPolicy()93 8.2.1.2 Method evalPolicyReq() .94 8.2.1.3 Method abortEvalPolicyReq().94 8.2.1.4 Method
31、generateEvent()95 8.2.1.5 Method createNotification()95 8.2.1.6 Method destroyNotification()96 8.2.2 Interface Class IpAppPolicyDomain 96 8.2.2.1 Method reportNotification()96 8.2.2.2 Method evalPolicyRes()96 8.2.2.3 Method evalPolicyErr().97 9 State Transition Diagrams97 9.1 PM Provisioning SCF Sta
32、te Transition Diagrams 97 9.2 PM Policy Evaluation SCF State Transition Diagrams97 10 PM Service Properties97 11 Data Definitions .98 11.1 Policy Management Data Definitions.98 11.1.1 TpPolicyConditionListType .98 11.1.2 TpPolicyConditionListElement 99 11.1.3 TpPolicyConditionList99 11.1.4 TpPolicyC
33、onditionType99 11.1.5 TpPolicyActionListElement .99 11.1.6 TpPolicyActionList.99 11.1.7 TpPolicyActionType.99 11.1.8 TpPolicyEvent 99 11.1.9 TpPolicyKeyword.100 11.1.10 TpPolicyKeywordSet101 11.1.11 TpPolicyError .101 11.1.12 IpPolicyDomain101 11.1.13 IpPolicyDomainRef 101 11.1.14 IpPolicyRepository
34、 .101 11.1.15 IpPolicyRepositoryRef101 11.1.16 IpPolicyGroup.101 11.1.17 IpPolicyGroupRef.101 11.1.18 IpPolicyRule .101 11.1.19 IpPolicyRuleRef .102 11.1.20 IpPolicyEventDefinition .102 11.1.21 IpPolicyEventDefinitionRef .102 11.1.22 IpAppPolicyDomain .102 11.1.23 IpAppPolicyDomainRef .102 11.1.24 I
35、pPolicyCondition.102 11.1.25 IpPolicyConditionRef .102 11.1.26 IpPolicyTimePeriodCondition 102 11.1.27 IpPolicyTimePeriodConditionRef 102 11.2 Data Types for PM Variables.102 ETSI ETSI ES 204 915-13 V1.1.1 (2008-05) 7 11.2.1 TpPolicyVar102 11.2.2 TpPolicyVarSet.103 11.2.3 TpPolicyRecordType103 11.2.
36、4 TpPolicyListType .103 11.2.5 TpPolicyTypeInfo.103 11.2.6 TpPolicyType .103 11.2.7 TpPolicyNameValue.104 11.2.8 TpPolicyNameValueList 104 11.3 eBNF for Condition and Action expressions104 11.3.1 Basic Definition104 11.3.2 Definitions of Constant (Literals) .104 11.3.3 Definition of Operators.105 11
37、.3.4 Allowable arithmetic expressions Essential, or potentially Essential, IPRs 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
38、investigation, including IPR searches, has been carried out by ETSI. No guarantee 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 ETSI Standa
39、rd (ES) has been produced by ETSI Technical Committee Telecommunications and Internet converged Services and Protocols for Advanced Networking (TISPAN). The present document is part 13 of a multi-part deliverable covering Open Service Access (OSA); Application Programming Interface (API), as identif
40、ied below. The API specification (ES 204 915) is structured in the following parts: Part 1: “Overview“; Part 2: “Common Data Definitions“; Part 3: “Framework“; Part 4: “Call Control“; Part 5: “User Interaction SCF“; Part 6: “Mobility SCF“; Part 7: “Terminal Capabilities SCF“; Part 8: “Data Session C
41、ontrol SCF“; Part 9: “Generic Messaging SCF“; Part 10: “Connectivity Manager SCF“; Part 11: “Account Management SCF“; Part 12: “Charging SCF“; Part 13: “Policy Management SCF“; Part 14: “Presence and Availability Management SCF“. Part 15: “Multi-Media Messaging SCF“; Part 16: “Service Broker SCF“. T
42、he present document has been defined jointly between ETSI, The Parlay Group (http:/www.parlay.org) and the 3GPP, in co-operation with a number of JAIN Community (http:/ member companies. The present document forms part of the Parlay 6.0 set of specifications. The present document is equivalent to 3G
43、PP TS 29.198-13 V7.0.0 (Release 7). ETSI ETSI ES 204 915-13 V1.1.1 (2008-05) 101 Scope The present document is part 13 of the Stage 3 specification for an Application Programming Interface (API) for Open Service Access (OSA). The OSA specifications define an architecture that enables application dev
44、elopers to make use of network functionality through an open standardised interface, i.e. the OSA APIs. The present document specifies the Policy Management Service Capability Feature (SCF) aspects of the interface. All aspects of the Policy Management SCF are defined here, these being: Sequence Dia
45、grams. Class Diagrams. Interface specification plus detailed method descriptions. State Transition diagrams. Data Definitions. IDL Description of the interfaces. The process by which this task is accomplished is through the use of object modelling techniques described by the Unified Modelling Langua
46、ge (UML). 2 References The references listed in clause 2 of ES 204 915-1 contain provisions which, through reference in this text, constitute provisions of the present document. ETSI ES 204 915-1: “Open Service Access (OSA); Application Programming Interface (API); Part 1: Overview (Parlay 6)“. 3 De
47、finitions and abbreviations 3.1 Definitions For the purposes of the present document, the terms and definitions given in ES 204 915-1 apply. 3.2 Abbreviations For the purposes of the present document, the abbreviations given in ES 204 915-1 apply. ETSI ETSI ES 204 915-13 V1.1.1 (2008-05) 114 Policy
48、Management SCF It is expected that more and more OSA services will use policies to express operational criteria. It is also expected that network providers will host policy-enabled services that have been written by 3rdparty application service providers. In order to manage policy information, contr
49、ol access to it and to request evaluation of policies a policy management service is needed. Consistent with this, a policy management provisioning manager, IpPolicyManager, and a policy evaluation manager, IpPolicyEvalManager have been defined. APIs have been defined to offer provisioning services. These include APIs to create, update or view policy information for any policy enabled service. Similarly APIs have been defined to facilitate interactions between clients (e.g. a 3rdparty application) and the policies of any policy ena
