YD/T 2145-2010.Guidance for defining Web service technology-based network management interface.
1范围
YD/T 2145规定了基于Webservice技术的网络管理接口的通用技术要求。
YD/T 2145适用于基于Web servcie技术的网络管理接口，也适用于采用该技术实现的其他管理接口。
2规范性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准。然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。
ITU-T M.3010电信 网络管理基本原则
3缩略语
下列缩略语适用于本标准。
HTTP                   HyperText Transfer Protocol                                                 超文本传输协议
TTU-T        Telecommunication Standardization Sector of International    国际电信联盟电信标准部                      Telecommunication Union
4基于Web service技术的网络管理接口位置
本标准所定义的基于Web service技术的网络管理接口适用于ITU-T M.3010定义的下图中X、Q和F接口。
5基于Web service技术的网络管理接口的层次结构
基于Web service技术的网管接口概念上可分为3层，如图2所示。
1)应用传输层为通信双方提供了通信手段，使数据能够可靠、安全的被传输;

ICS 33.040.01
中华人民共和国通信行业标准
YD/T2145-2010
基于WebService技术的
网络管理接口定义指南
Guidance for defining Web service technology-based networkmanagementinterface
2010-12-29 发布
2011-01-01 实施
中华人民共和国工业和信息化部发布前
规范性引用文件··
3缩略语
4基于Web service技术的网络管理接口位置次
5基于FWebservice技术的网络管理接口的层次结构·6基本技术要求
7信息模型层技术要求
8MEP层技术要求·
9传输层的技术要求·
10安全要求··
附录A（资料性附录）使用JMS作为传输协议的技术要求附录B（资料性附录）使用REST技术实现网络管理接口参考文献··
HTYKAONIKAa-
YD/T 2145-2010
YD/T 2145-2010
本标准在编制过程中，主要参考了国际电信联盟-电信标准部(ITU-T）标准M.3010、电信管理论坛（TMF）标准TMF854、高级信息化结构标准经织（OASIS）标准WS系列标准：并结合我国的具体情况编制而成。
其中，对相关主要标准的引用或参考情况如下：ITU-TM.3010：本标准参考了该标准关于TMN功能架构中参考点的定义内容。TMIF854：参考了该标准用Web seryice技术作为网络管理接口的基本技术框架、交互模式和定义方法等内容。
OASISWS系列标准：本标准参考了该系列标准关子Web service通知、安全、选代、可靠传输等方面的内容。
本标准与工述国际规范问的关系为非等效。本标准的附录A和附录B为资料性附录。本标准由中国通信标准化协会提出并归口。本标准起草单位：华为技术有限公司、中国移动通信集团公司。本标淮王要起草人：张天虎、李晖。1范围
YD/T2145-2010
基于Webservice技术的网络管理接口定义指南本标准规定了基于Webservice技术的网络管理接口的通用技术要求。本标准适用丁基丁Web serveie技术的网络管理接口，也适月于采该技术实现的其他管理接口。2规范性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适于本标准。然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。ITU-TM.3010电信网络管理基本原则3缩略语
下列缩略语适用于本标准。
HyperText Transfer Protocol
Telecommunication Standardization Sector of IntermationalTelecommunication Union
Java Message service
Message exchange Pattern
Multi-Technology Operations System InterfaceRepresentational State TransferSimple Object Access ProtocolSecure Sockets Layer
TeleManagement Forum
Telecommunications Managcment NetworkcXtensibleMarkupLanguage
4基于Webservice技术的网络管理接口位画超文本传输协议
国际电信联盟电信标准化部
Java消息服务
消息交互模式
多技术操作系统接口
具象状态传输
简单对象访问协议
安全套接层
国际电信管理论坛
电信管理网
可扩展的标记语言
本标准所定义的基于Webservice技术的网络管理接口适用于ITU-TM.3010定义的下图中X、Q和F接口。
HTYKAONIKAa-
YD/T2145-2010
T04t03950-93/d14
图1基于 Web service 技术的网络管理接口适用位置5基于Web service技术的网络管理接口的层次结构基于Web servicc技术的网管接凹概念上可分为3层，如图2所示。1）应旧传输层为通信双方提供了通信手段，使数据能够可靠、安全的被传输：2）消息交换模式（MEP）层描述通信双方采用SOAP消息进行通信的交互方式：3）信息模型层抽象和描述了被管对象。其内容依赖F特定的业务和对象，本标准了描述这些业务和对象的公共技术要求。
信息模型层
消息交互模式（MEP）层
短用传输层
HITPHTTPS/JMS/--
陶2 基于 Web service 技术的网络管理接口层次结构6基本技术要求
基于Web service技术的网络管理接口必须满足如下基本条件：1）传输层需要制支持如下两种通信模式之一=a）同步调用模式：
b）异步交互模式：
YD/T2145-2010
如果选择使用同步调用模式，建议优先使用HTTP或HTTPS协议作为传输协议：如果选择使打异步交互模式，建议使用JMS或其他消息中问件来作为传输协议：2）MEP层至少支持简单的Request-Response模式（包one-way模式）和定购通知模式：3）信息模型层所定义业务和对象模型必须能够通过XMLSCHEMA来描述或者能够转换成XMISCHEMA的语方来描述：
4）MEP层与传输层之闻要松耦合，确保在不影响具体业务的前提下可以使川不间的传输层。7信息模型层技术要求
信息模型层必须满足如下要求：[）信息模型摧述语言必须遵守Weh Service Description Languageversion 1.1（WSDL）规范和WS-Rasic Profile 1.2规范：
2）用于传送XML数据的消息格式定义必须遵守SimpleObjeciAccessProloculversion1.1/1.2(SOAP）规范：
3）被传送的XML数据必须使用XMLSchema进行描述，并遵从XMLSchemaversion1.0（XSD）规范：4）信息模型中的命名窄间必须遵守URI定义的标注格式：5）采用WSDL定义的信息模型可以来用如下的模块化的方式：a）消息模块采用Messagcs,wsdl命名方式：b）portlypc模块采川PortType.wsdl命名方式c）服务模块采HTTP.wsdl或JMS.wsdl命名方式：6）在使川XMLSchema述信息模型时，建议尽量不使XMLSchema的高级特性，比如复杂类型中的ali、union等类型：
7）对于XM.Schema的版本管理，如果一个XMLSchema定义的类型或实体的属性被废弃或变更了就应该更新主版本号，如果是增加了新的属性，就应该更新辅版本号：8）版本信息要求能够在WSDL文件中体现，推荐使朋如下方式：wsdl:definitions name=\Version>将版本号做为命名空间中的一部分：9）版本的信息分成王版本号和辅版本号两个部分；10）用XMLSchema描述服务请求消息/响应消息时，请求消息的命名方式必须是Requesl，应答消息的命名方式必须是Response，异常的命名方式必须是Exception：11）如果-个服务请求错要传递多个in参数，必须将这些in参数包装成一个复杂类型的参数来传递；如一个参数可选，需要使用minOccurs=\0\属性来标定：12）如果：个操作可能抛山多个异常，则需要使用复杂类型中的cloicc子项米描述。8MEP层技术要求
使刃基于Webservice技术的网络管理接口需要支持以下四种消息交互模式（MEP）：1）简单请求喇应模式（包括one-way模式）：：次请求对应一次响应或者没有响应：2）一次请求多个响应模式：一次请求对应次或是多次响应，主要是用了处理大数据量的交互；3
HTYKANIKa-
YD/T2145-2010
3）文件批响应模式：一次请求后，响应信息被以文件的方式存放在指定的地方，由请求方白己然取，这种方式生娶用处理超大数据交互；4）定购通知模我。
表1给出了两种通信模式和四种MEP交互模式组合所产生的具体化的交互场景。表1两种通信样式和四种通信模型相互组合形成的7种交互场景通信样式
国步调用模式
兵步交互模式
8.1.1简单响应模式
简单响应
向步请求/应
异步请求/响应
次请求多次响应
向步送代
异步批最响应
文作批响应
同步文件批响应
异非文件批响应
定购通知
异步通知
简单响应模式尼最常用的消息交互模式，呈现为一次请求对应一次响应或尤响应。同步调用和异步交互唯一的区别是异步交互需要一种匹配机制来关联请求消息和响应消息。8.1.2多次批响应模式
这种模式一般适用下大数据量的查询操作，查询出的最终结果不能通过一次简单的响应返向给请求方。响应方需要提供如下机制用了帮助请求方获取后续的查询结果：1）问步选代机制：第一次请求的响应除了返回一部分响应数据外，还返回一个选代服务引用，请求方可以利用这个选代服务引用获取后续的响应数据。请求方负责控制整个调用流程，而谢应方负维护这个送代服务引用和和关的中间状态。响应方必须提供选代了服务引用的自动回收机制，用丁释放相关资源。兵体交互过程如图3所示。语求坊
发送请求
草批明应纳果+送代服务引用
请求,后续结果
终止请求后续的响应
图3同步送代过程
向晓方
送代服务
2）异步批响应机制：第一次请求的响应仪仪是一个通知信息，通知请求方已经接受了这个请求并正在处理，随后响应方将处理的结果分批次推送给请求方。请求方要在第一次请求的消息中提供自己接受响应结果的回调端口。请求方可以使用Ws-Addressing的标准方式将这个回调端口发布给响应方，也可以直接将底层消息服务的消息队列标识（如JMS的消息接受队列的名字）发布给响应方。详细交互过程如图4所示。响应接收
8.1.3文件批响应模式
请求方
发送请求+后续结果接受服务引用确虚DK
发送后续结果
发递后续结果
发诺后续结果
图4异步批响应过程
YD/T2145-2010
响应片
针对超大数据量的交互，响应方将响应消息以文件方式存储在指定的存储位置，然后通知请求方来提取结果文件：请求方在请求消息中要携带存储服务的URL（避遵从RFC3986，格式应该是scheme://usernanme:password@hos/workdirectory/ileNane.xml）信息，这个信息将被响应方用于标定结果文件存放的位置，文件的传输利提取可以使用FTP/SFTP或是其他协议；除此之外，请求方还应提供结果文件是否打包、打包的类型（ZIP/TAR）、是否压缩（GZIP）等信息用于指定结果文件格式。响应方需要提供如下机制帮助请求方获取最终的结果文件：1）步褥用机制：请求方在发送请求后进入等待状态，响应方在文件被正确无误的生成并存储到指定位置后，向请求方发送通知：请求方在收到通知后自行获取结果文件。具体交互过程如图5所示。请求方
发送请求
没送响应
获职结果文件
响应方
图5同步文件批响应
将结果存被到存储服务器上
服务器
2）异步交互机制：请求方提供接收状态通知的回调服务。在处理的整个过程中，响应方将定时通过这通知服务发送通知消息给请求方，告知操作正在进行中，并提供响应的进度信息，直到文件被正确无误的生成并存储到指定的存储器工后，才发送完成消息给请求方，通知其可以去取结果文件。具体交互过程如图6所示。
HTYKAONIKAa-
YD/T2145-2010
遥知服务
请求方
8.1.4定购通知模式
发送请求
状态信
状态信息
发送结束响应
获职结果文件
图6异步文件批响应
响应方
格结果存改到存估服务器
服务器
定购通知模式遵从Ws-Notification标准，它制定了在Webservice环境中创建事件驱动系统的标准流程。响应方首先发布自已的主题，主题的类型出具体的业务来定义，每个士题都跟特定的非件绑定。请求方向响应方订购希望的主题，当和这个主题相关的事件发牛时，响应方就要通知请求方。通知消息也是由业务指定的，并且根据主题来进行分类，通知消息的订阅者根据主题来选择其想订阅的消息。通知消息要包含可以被通知过滤系统识别的信息，可以被过滤系统用于实现通知过滤机制。过滤器包括两个部分的信息：
1）查询方言，用于指定询表达式的类型，如XPATH/XQUERY或是JMS过滤器：2）查询表达式。
8.2MEP对网络管理业务的适用情况MEP对网络管理业务的适用情况如表2所示。MEP
故障管理
配置管理
业务发展
性能管理
安全管理
表2MEP对网络管理业务的适用情况简单的请求响应免费标准下载网bzxz
图例：●代表表示MEP适用于该类管理业务9传输层的技术要求
多次批响应
当使用HTTP传输SOAP消息时，必须遵循下述条件：1）HTIP头中的media类型必须依据RFC2376设置成\texxml\；2）只能使用HTTP的POST方法来传送SOAP消息；文件数响
3）HTTP头中的SoapAction头必须存在：如果不用，必须填写空字符串；定购通知
4）HTTP本身的返回码必须能够正确指示SOAP响应的状态，当出现SOAP异常的时候，HTTP服务器必须返回状态码500用于指定服务器内部错误：6
5）必须使用HTTP协议的1.1版本。YD/T2145-2010
当使用HTTPS进行传输SOAP消息时，啦应方和请求方必须独立提共自已的公钥和证书，对接过程要实现双方认证，尽量避免出现单向认证情况。如某便用界步交互方式，请参考相应中问件的月体规定，在附录A中给出了使用JMS间仆作为传输层的技术要求参考。
10安全要求
基下WS技术的网管接口必须具备如下安全能力：：1）认证能力，实现请求方和响应方之间的信任认证，如X.509数字证书或是Kerberos证书：2）授权能力，控制动监控访问特定资源的能力；3）审计能力和可追踪能力，用于避免各种嵌骗、攻玫未等行为：4数据的究整和机密性，确保交互的数据不摄窃听和串改。为确保达到上述安全能力，在传输层面，可以使用SSL/TSL来实现双方的认证和消息的加密：在消息层面工叫以使用XML签名和XML加密等枝术来提高数韬的完整性和机密性；使用Ws-Secuirty规范定义的SecurityToken和SAML来实现认证和授权功能。HYYKAONiKAa-
YD/T2145-2010
附录A
（资料性附录）
使用JMS作为传输协议的技术要求JMS作为J2EE架构中的一部分为多个运行在不同环境下的Java应用提供了灵活可靠的通讯机制。最新的JMS版本是1.1版本，发布于2002年4月，科关的规范可以参考http:/fjava.sun.com/products/jms/。如果网管接几A使用JMS作为通讯底层，对JMS消息的其体要求：1）头部分，JMS定义的标准头信息，JMS标准定义了很多头属性，其中很多是有JMS服务器在发送消息的时候自动填写，只有如下头信息以过程序设定：a）deliveryMode（xsd:int）指定传送的消息是否需要持久化：b）timeToLive（xsd:long）毫秒级别，指定消息的存活时间：c）priority（xsd:int）指定消息的优先级别：d）replyToName（xsd:string）指定一个JNDI的名学，通过这个名字可以找到一个接受响应消息的QUEUETOPIC.
2）屑性部分，有JMS指定的标推励性，应用程序也可以添加白已的性；这些属性是可以被用来作为消息过滤：下面这些是标准励性，可以被用下过滤消息：a）targetService（xsd:slring）用指定最终处理消息的服务的名；b）bindingVersion（xsd:string）指定传送的SOAP的消息的版本：c）soapAction(xsd:anyURI）指定soapAction；d）isFault（xsd:boolcan）指定消息体部分的SOAP消息是否是一个fault消息c）soapMEP(xsd:string）指定消息是否器要响应（rcq-resp或one-way）。3）消息体部分，使川TEXT样式的消息格式。无论是响应方还是请求方在使旧MS作为道证层的时候，都需要事先指定如下竭性用了和IMS服务中事先定义好的QUEUE/TOPIC建立连接：1）destinationName（xsd:string）指定一个JNDI的名字，于查找将被连接的TOPIC或是QUEUE；2）connectionFactoryName（xsd:string）指定一个JNDI的名字，用于查找建立连接所需要连接器工厂：3）initialContextFactory（xsd:string）指定一个上下文工厂的Java类名字，川丁初始化本地JNDI上下文
4）jndiURL（xsd:anyURJ.）指定JNDI服务器监听连接请求的URL。当请求方通过JMS发送消息时，露要按想上述婴求设置MS消息。表A.1和A.2做了概括和总结，表A.1请求方在构建请求消息时需要完成的工作域
JMS消息头
JMSDeliveryMode
JMSExpiration
JMSPriority
JMSDestination
JMSReplyTo
持久、非持久
弦秒，默认为0（永久消息）
优先级（如果不指定，将由JMS服务自行决定）JNDI名字
除了one-Way模式，这个属性必须指定，JNDI名字标定的QUEUE/TOPIC，丁接受响应消息域
JMS消息属性
targetService
soapAclian
bindingVersion
soapMEP
3MS消息体
JMS消息头
MSDelivtryMode
JMSExpiration
IMSPriority
JMSDestinatian
JMSCorrelationiD
JMS消息属性
isFauit
bindingVersion
soapMEP
JMS消息体
建议足文本消息格式
表A.1（续）
表A2响应方在构建响应消息时需要完成的工作：值
从请求消息中拷贝
旁秒，默认为（永久消息)
从请求消息中拷贝
从请求消息中拷贝
从请求消息中拷贝（JMS自动生成）指定是否是fault消息
从请求消息中拷贝
从请求消息中拷贝
建议延文本消息格式
服务和消息队列的对应关系：
YD/T2145-2010
在定义队列和服务的时候，有两种策略，一种是一个服务对应一个消息队列对（请求队列、应答队列），也可以是多个服务共享个队列对，在这种情况下，消息的接受方就需要通过targetService属性来对请求的消息进行过滤，从而实现消息到服务的匹配。9
HTYKANIKa-
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。