GBT 33780.3-2017 基于云计算的电子政务公共平台技术规范 第3部分系统和数据接口

数据库版本转换接口要求如下： a）接口名称：pt3。 b）接口协议：SOAP/Webservice。 C） 调用参数：输入（源数据库类型，源数据库版本，源数据库IP地址，源数据库服务端口，源数据 库名称，源数据库待迁移数据表列表，源数据库访问用户名，源数据库访问用户的密码，目标数 据库类型，目标数据库版本，目标数据库IP地址，目标数据库服务端口，目标数据库名称，目标 数据库数据迁移表列表，目标数据库访问用户名，目标数据库访问用户的密码，待适配和转换 SQL语句）。 d）返回值：（逻辑值true/false，适配和转换后的SQL语句）。 接口功能：提供应用系统在异构数据库和相同数据库不同版本之间的数据部署和迁移接口。 1) 应提供在关系数据库管理系统、大数据系统等异构系统之间，实现API级的数据迁移和 数据转换； 应提供在相同数据库管理系统不同版本之间，实现SQL语言的适配和转换； 3) 应提供在异构数据库管理系统之间，实现不同数据类型的适配和转换； 4) 应提供在相同数据库管理系统不同版本之间，实现不同数据类型的适配和转换； 5) 应以XML/JSON等格式文件为中间媒介，实现在异构数据库管理系统和相同数据库管 理系统不同版本之间的数据转换。

数据库版本转换接口要求如下： a）接口名称：pt3。 6）# 接口协议：SOAP/Webservice。 ） 调用参数：输入（源数据库类型，源数据库版本，源数据库IP地址，源数据库服务端口，源数据 库名称，源数据库待迁移数据表列表，源数据库访问用户名，源数据库访问用户的密码，目标数 据库类型，目标数据库版本，目标数据库IP地址，目标数据库服务端口，目标数据库名称，目标 数据库数据迁移表列表，目标数据库访问用户名，目标数据库访问用户的密码，待适配和转换 SQL语句】。 d): 返回值：（逻辑值true/false，适配和转换后的SQL语句）。 接口功能：提供应用系统在异构数据库和相同数据库不同版本之间的数据部署和迁移接口。 1) 应提供在关系数据库管理系统、大数据系统等异构系统之间，实现API级的数据迁移和 数据转换； 应提供在相同数据库管理系统不同版本之间，实现SQL语言的适配和转换； 3) 应提供在异构数据库管理系统之间，实现不同数据类型的适配和转换； 4) 应提供在相同数据库管理系统不同版本之间，实现不同数据类型的适配和转换； 5) 应以XML/JSON等格式文件为中间媒介，实现在异构数据库管理系统和相同数据库管 理系统不同版本之间的数据转换。

圆钢标准）接口方法：参见B.3。

接口方法：参见B.3

GB/T33780.3—2017

数据共享接口要求如下： a）接口名称：pt4。 b）接口协议：JMS/SOAP/Webservice。 c) 调用参数：输人目录编号，目录元数据和值，目录名称，目录分类编号，目录内容，数据交换发 送方路由编号，待交换的数据，数据交换接收方路由编号，认证信息）。 d）返回值：（逻辑值true/false)。 e) 接口功能：应提供数据资源目录服务接口、数据交换接口、数据转换接口和数据服务接口，实现 不同应用系统之间的数据共享。 1) 目录服务接口应提供数据资源的发现、注册、编目、发布和检索的功能，接口技术要求参考 GB/T21062—2007。 2 数据交换接口应提供结构化、半结构化和非结构化数据的交换功能，接口技术要求参考 GB/T210632007。 3） 数据转换接口应提供将非标准格式数据转换为标准格式数据的功能。 4）数据服务接口应提供将数据资源封装为数据服务，并实现数据服务的调度和管理的功能。 f)接口方法，参见B.4

数据共享接口要求如下： a）接口名称：pt4。 b）接口协议：JMS/SOAP/Webservice。 C) 调用参数：输人《目录编号，目录元数据和值，目录名称，目录分类编号，目录内容，数据交换发 送方路由编号，待交换的数据，数据交换接收方路由编号，认证信息）。 d）返回值：（逻辑值true/false)。 e) 接口功能：应提供数据资源目录服务接口、数据交换接口、数据转换接口和数据服务接口，实现 不同应用系统之间的数据共享。 1) 目录服务接口应提供数据资源的发现、注册、编目、发布和检索的功能，接口技术要求参考 GB/T21062—2007。 2 数据交换接口应提供结构化、半结构化和非结构化数据的交换功能，接口技术要求参考 GB/T210632007。 3） 数据转换接口应提供将非标准格式数据转换为标准格式数据的功能。 4）数据服务接口应提供将数据资源封装为数据服务，并实现数据服务的调度和管理的功能。 f)接口方法：参见B.4

9应用系统与应用服务器中间件接口

应用系统与应用服务器中间件接口要求如下： a）接口名称：pt5。 b）接口协议：http/Soap/RESTful。 调用参数：输入《源系统描述数据体，目标系统描述数据体，转换等级，系统的目标部署环境描 述数据体，目标部署系统描述数据体，部署参数数据体，需要进行迁移的系统描述数据体，需 要转换的目标部署系统描述数据体，迁移参数数据体二二需要进行监控的系统描述数据体， 业务系统监控管理适配器，监控、管理参数数据体，源业务系统服务描述数据体，目标业务系 统服务描述数据体，接口转换参数描述数据体）。 返回值：《转换结果，部署结果，迁移结果，适配结果，服务接口转换结果）。 e) 接口功能：应提供应用系统与不同的应用服务器以及相同的应用服务器不同版本之间的打包、 部署、迁移和服务接口。 1）打包接口应提供应用系统基于不同应用服务器中间件及相同应用服务器中间件不同版本 之间的打包和转换功能； 2）音 部署接口应提供应用系统基于不同应用服务器中间件及相同应用服务器中间件不同版本 之间的部署功能； 3） 迁移接口应提供应用系统基于不同应用服务器中间件及相同应用服务器中间件不同版本 之间的迁移功能； 4）月 服务接口应提供应用系统基于不同应用服务器中间件及相同应用服务器中间件不同版本 之间运行的管理、监控等服务功能； 5）应为应用系统提供跨运行平台、跨开发语言的服务调用接口。 f）接口方法：参见B.5。

GB/T33780.32017

10应用服务器中间件互操作接口

应用服务器中间件互操作接口要求如下： a）接口名称：pt6。 b）协议：http/https/Soap/RESTful。 c）调用参数：无。 d）返回值：无。 接口功能：应提供异构应用服务器中间件之间的互操作与应用集群管理。 1）提供同构应用服务器中间件之间的互操作功能，跨异构应用服务器中间件的互操作具备 运行平台无关性和编程语言无关性； 2） 提供应用系统集群接口，同一应用系统的不同实例可跨同构应用服务器中间件实现集群 部署； 3）提供分布式部署接口，应用系统的不同构件可分布部署在异构的应用服务器中间件中。 f）接口方法,参见B.6.

11应用系统互操作调用接口

应用系统互操作调用接口如下： a）接口名称：pt7。 b）接口协议：http/Soap/RESTful/Socket。 调用参数：输人《远程网络地址，远程服务端口，通信内容，本地监听端口，用户唯一标识符，用 户口令，数字证书唯一识别码，数字证书PIN码）。 d) 返回值：（通信完成状态标识，身份认证结果标识）。 ) 接口功能：应提供应用系统与不同的中间件以及相同的中间件不同版本之间的打包、部署、迁 移和服务接口。 1）应提供应用系统之间互调用的方法和参数，支持跨平台、跨编程语言的访问方式； 2） 应支持同步、异步消息通讯的调用方式； 3）应支持应用系统之间互调用的身份认证和单点登录。 f)接口方法：参见B.7

12公共平台资源服务管理接口

公共平台资源服务管理接口要求如下： a）接口名称：pt8。 b）协议：http/https。 调用参数：输入（用户唯一识别身份编码，用户身份口令，数字证书识别码，资源域编码，模板 id，资源名称，内存和CPU，资源个数，服务时间，资源id，平台服务ip，系统报文)。 返回值：（认证成功或失败，用户授权可访问信息，资源id和名称）。 e 接口功能：公共平台应提供跨区域的主机、存储、支撑软件、运维监控、安全保障等服务资源共 享与调度访问接口。 1）应提供远程租户与用户访问的认证与授权功能，通过提供身份认证key，验证该调用方身 份和权限，并获用户账号下可用的服务资源授权清单：

GB/T 3378032017

2) 应提供虚拟主机资源远程管理与访问功能； 3) 应提供对存储远程管理与操作功能； 应提供支撑软件远程管理功能； 5) 应提供对应用系统的管理与监控功能； 6） 应提供监控信息项跨区域推送功能； 应提供安全支撑服务远程管理功能； 应提供公共平台计算资源地址、数据库资源地址、数据共享资源地址、中间件资源地址的 功能。 接口方法，参见B8

2) 应提供虚拟主机资源远程管理与访问功能； 3) 应提供对存储远程管理与操作功能； 4) 应提供支撑软件远程管理功能； 5) 应提供对应用系统的管理与监控功能； 6) 应提供监控信息项跨区域推送功能； 7) 应提供安全支撑服务远程管理功能； 8) 应提供公共平台计算资源地址、数据库资源地址、数据共享资源地址、中间件资源地址的 功能。 接口方法，参见B.8

D接口方法：参见B.8

A.1公共平台系统和数据接口关系

（资料性附录） 系统和数据接口关系图

图A.1公共平台系统和数据接口关系图

如图A.1所示，公共平台之间的接口是资源服务管理接口层（公共平台资源服务管理接口）。公共 平台内的资源和服务共享接口模型从底层到上层应用服务依次是网络接口层（网络系统互联互通接 日），存储接口层和虚拟主机接口层（主机系统接口）、应用服务器接口层（应用系统与应用服务器接口、 应用服务器互操作接口）和数据接口层（数据库版本转换接口、数据共享接口）以及应用系统接口层（应 用系统互操作接口）；每个接口层的接口按照业务系统部署、迁移和资源服务共享需求定义接口功能、访 问协议、访问方法，并遵循国家已发布的相关接口规范

A.2.1虚拟主机与网络功能接口的对照关系见表A.1~表A.5

A.2.1虚拟主机与网络功能接口的对照关系见表A.1~表A.5

表A.1基于L3层虚拟路由方法

GB/T33780.3—2017

表A.2基于L3层虚拟路由方法

GB/T33780.3—2017

表A.4基于iptable的NAT转发方法

2.2虚拟主机与应用服务器中间件接口对照关

表A.6虚拟主机与应用服务器中间件接口功能对照表

A.2.3虚拟主机与应用系统接口对照关系见表

.2.3虚拟主机与应用系统接口对照关系见表A.7

GB/T33780.3—2017

表A.7虚拟主机与应用系统接口功能对照表

A.2.4虚拟主机与存储设备接口对照关系

表A.8虚拟主机与存储设备接口功能对照表

A.3数据库版本转换功能接口对照关系

数据库版本转换功能接口对照关系见表A.9。

居库版本转换功能接口

GB/T33780.3—2017

A.4数据共享接口对照关系

数据共享接口对照关系见表A.10

10数据共享接口对照

A.5应用服务与应用服务器中间件接口对照关系

应用服务与应用服务器中间件接口功能对照

A.6应用系统互操作接口对照关系

操作接口对照关系参见表

GB/T33780.3—2017

表A.12应用系统互操作接口功能对照表

A.7公共平台资源服务管理接口对照关系

共平台资源服务管理接口对照关系参见表A.1

GB/T33780.32017

B.1网络系统互连互通接口

B.2.1虚拟主机与网络系统接口

GB/T33780.3—2017

GB/T 33780.32017

GB/T33780.3—2017

GB/T33780.3—2017

GB/T33780.32017

GB/T33780.3—2017

GB/T33780.3—2017

B.2.2虚拟主机与应用服务器中间件接口

虚拟主机与应用服务器中间件接口的详细要求如下： a) 软件包本地上传与下载方法： 1）登录虚拟主机方法： 【方法原型】webssh2（host，port，username，password)。 【方法功能】远程登录虚拟主机。 【参数说明】host：主机IP或域名； port：ssh端口； username：登录名称； password：登录密码。 【返回值】登录成功/失败。 【使用方法】接口运行在远程服务器上，发起者调用该接口，传递参数，登录虚拟主机。 【提示】Port：默认为21和22，防火墙要开放此端口。 2）上传文件方法： 【方法原型】upload（context，sourcefile，targetdiectory）。 【方法功能】上传文件到虚拟机指定目录。 【参数说明】context：登录信息上下文； sourcefile：上传源文件； targetdiectory：目的目录。 【返回值】上传成功/失败。 【使用方法】接口运行在远程服务器上，发起者调用该接口，传递参数，上传文件到虚拟主 机的指定目录。 【提示】源文件可以是任何单文件。 3）下载文件方法： 【方法原型】download（context，sourcefile）。 【方法功能】从远程虚拟主机上下载文件到本地。 【参数说明】context：登录信息上下文； sourcefile.要下载的文件名称

与应用系统接口的详细要求如下： 包提供本地上传与下载方法： 登录方法： 【方法原型】webssh2（host，port，username，password）。 【方法功能】远程登录虚拟主机。 【参数说明】host：主机IP或域名； port:ssh端口; username：登录名称； password.登录密码。

GB/T33780.3—2017

GB/T 33780.32017

B.2.4虚拟主机与存储设备接口

虚拟主机与存储设备接口的详细要求如下： a）存储设备的挂载与卸载方法：

GB/T 33780.32017

b）存储空间创建与销毁方法：

GB/T 3378032017

【参数说明】req：请求； id：云硬盘id； body：主体。 （返回值】包含更新成功后的云硬盘详细信息的字典对象。 【使用方法】接口运行在远程服务器上，发起者调用该接口，传递参数，更新云硬盘。 【提示】无。 4）列出方法： 【方法原型】index(self，req】。 【方法功能】列出云硬盘总表。 【参数说明】req：请求。 【返回值】包含云硬盘列表信息的字典对象。 【使用方法】接口运行在远程服务器上，发起者调用该接口，传递参数，列出云硬盘列表 息。 【提示】无。 5）详情方法： 【方法原型】detail（self，req】。 【方法功能】列出一个云硬盘列表详情。 【参数说明】req：请求。 【返回值】包含云硬盘详细信息的字典对象， 【使用方法】接口运行在远程服务器上，发起者调用该接口，传递参数，列出指定云硬盘的 抽信息。 【提示】无。 c）存储备份与恢复方法： 1）创建方法： 【方法原型】create（self，req，body）。 【方法功能】创建一个新备份。 【参数说明】req：请求； body：主体。 【返回值】备份成功后的备份对象的字典对象。 【使用方法】接口运行在远程服务器上天然气标准规范范本，发起者调用该接口，传递参数，创建存储备份。 【提示】无。 2）删除方法： 【方法原型】delete（self，req，id）。 【方法功能】删除一个备份。 【参数说明】req：请求； id：备份的id。 【返回值】删除成功/失败。 【使用方法】接口运行在远程服务器上，发起者调用该接口，传递参数，删除指定的备份。 【提示】无。 3）恢复方法： 【方法原型】]restore(self，req，id，body）。 【方法功能】恢复一个存在的备份云硬盘。 【参数说明】req：请求；

）存储备份与恢复方法！

GB/T 33780.32017

id：备份云硬盘的id； body：主体。 【返回值】恢复成功后的备份对象的字典对象。 【使用方法】接口运行在远程服务器上，发起者调用该接口，传递参数，恢复指定的备份 【提示】无。

B.3数据库版本转换接口

GB/T33780.32017

GB/T3378032017

屋面标准规范范本B.5应用系统与应用服务器中间件接口