YD∕T 3991-2021 云计算业务数据报送接口规范(通信).pdf
《YD∕T 3991-2021 云计算业务数据报送接口规范(通信).pdf》由会员分享,可在线阅读,更多相关《YD∕T 3991-2021 云计算业务数据报送接口规范(通信).pdf(24页珍藏版)》请在咨信网上搜索。
1、 ICS 35.210 L78 YD 中 华 人 民 共 和 国 通 信 行 业 标 准 YD/T 代替 YD/T 云计算业务数据报送接口规范 Cloud computing business data reporting interface specification 点击此处添加与国际标准一致性程度的标识 (报批稿) 点击此处添加本稿完成日期 -发布 -实施 中华人民共和国工业和信息化部 发 布 YD/T I 目 次 1 范围 . 1 2 规范性引用文件 . 1 3 术语和定义 . 1 4 缩略语 . 1 5 概述 . 2 6 接口功能要求 . 2 6.1 基础数据管理 . 2 6.2 基
2、础运营数据管理 . 3 6.3 业务运营数据管理 . 4 6.4 重大事项数据管理 . 4 7 接口流程 . 5 7.1 通信方式 . 5 7.2 查询指令处理流程 . 5 7.3 数据上报流程 . 5 8 编码说明 . 7 8.1 互联网 IP 地址编码 . 7 8.2 备案号 . 7 9 数据代码表 . 7 9.1 接入方式代码表 . 7 9.2 客户行业代码表 . 7 9.3 证件类型代码表 . 8 9.4 机房性质代码表 . 8 9.5 企业性质代码表 . 8 10 数据交换内容 . 9 10.1 数据格式及匹配要求 . 9 10.2 基础数据内容 . 9 10.3 基础运营数据内容
3、. 13 10.4 业务运营数据内容 . 17 10.5 重大临时事项内容 . 20 YD/T II 前 言 本文件按照GB/T 1.12020给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本文件由中国通信标准化协会提出并归口。 本文件起草单位:中国信息通信研究院、中国电信集团有限公司、中国联合网络通信集团有限公司、中国移动通信集团有限公司、京东云计算(北京)有限公司、北京金山云网络技术有限公司、北京百度网讯科技有限公司、浪潮云信息技术股份公司、曙光云计算集团有限公司、上海蓝云网络科技有限公司、网宿科技股份有限公司等。 本文件主要起草人:栗蔚
4、、徐恩庆、罗欧、董恩然、张琳琳、孙宗哲、车昕、何川、李昂、杨洋、王英奎、郭广乾、赵万成、李萍、辛小玲、李国杰、陈鑫、周健、刘会师、张晓辉、姜辉、王刚、蔡祎、张君子、宋国江、郝立华、陈晓、王建、高守镇、王京华、缪安娜、刘莉莉等。 YD/T 1 1 范围 本文件规定了信息通信行业中,经营互联网资源协作服务业务(简称“云服务”)、内容分发网络业务(简称“CDN”)的企业相关市场信息管理系统与电信管理部门依照国家法律法规授权建设的信息通信市场监测管理平台间接口的功能要求、接口流程、编码说明、数据代码表及数据交换内容等。 本文件适用于提供包括但不限于弹性计算、数据存储、互联网应用开发环境、互联网应用部署
5、和运行管理等服务的云计算业务经营单位以及为互联网信息服务提供者提供包括但不限于网页加速、下载加速、流媒体加速等服务的CDN业务经营者所建设的市场信息管理系统。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。 GB/T 2260-2007 中华人民共和国行政区划代码 3 术语和定义 下列术语和定义适用于本文件。 3.1 云计算市场监测管理平台 cloud market monitoring and management platform 电信管理部门依照国家法律法规建
6、设的信息通信市场监测管理平台,本标准中特指针对云服务和CDN相关业务建设的管理平台。 3.2 市场信息管理系统 market information management system 云服务和CDN相关业务经营者建设的汇集企业内部相关数据并与电信管理部门建设的云计算市场监测管理平台进行对接的内部管理系统。 4 缩略语 下列缩略语适用于本文件。 CMMP 云计算市场监测管理平台 Cloud Market Monitoring and Management 云计算业务数据报送接口规范云计算业务数据报送接口规范 YD/T 2 Platform ICP 互联网内容提供商 Internet Conte
7、nt Provider IP 互联网协议 Internet Protocol MIMI 市场信息管理接口 Market Information Management Interface MIMS 市场信息管理系统 Market Information Management System XML 可扩展标记语言 Extensible Mark-up Language 5 概述 云计算市场信息管理接口(MIMI)是云计算企业侧(包含经营云服务和CDN服务的电信业务经营企业)市场信息管理系统(MIMS)与电信管理部门侧云计算市场监测管理平台(CMMP)之间的接口,主要功能包括基础数据管理、基础运营数
8、据管理、运营数据管理等。 MIMI包括命令通道和数据通道。CMMP通过命令通道下发指令给MIMS,MIMS通过数据通道上传数据给CMMP。 MIMI与CMMP、MIMS之间的关系如图1所示。 云计算企业侧 电信管理部门侧 图 1 MIMS 和 CMMP 关系示意图 每个云计算业务经营者应建设一个统一的MIMS,并通过一个MIMI与CMMP对接,以实现对其所管辖范围内所有业务节点的管理。本标准中所有未指明的机房均泛指支撑经营云服务和CDN服务的机房。本标准仅规定了MIMI的功能要求、接口流程、接口方法及数据交换格式定义,本标准中未明确的技术细节由MIMS根据CMMP的要求实现。MIMS的技术要求
9、不在本标准中规定。 6 接口功能要求 6.1 基础数据管理 市场信息管理系统(MIMS) 市场信息管理系统(MIMS) 云计算市场监测管理平台(CMMP) 市场信息管理接口(MIMI) YD/T 3 基础数据管理包括基础数据全量同步与响应,基础数据增量同步与响应,基础数据查询与相应,如图2所示。 图 2 基础数据管理 基础数据记录包括云计算经营者、云计算业务客户有关主体信息记录以及云计算经营者业务机房有关的资源信息记录。 基础数据全量同步与响应 CMMP可以根据需要发送基础数据全量同步请求指令给MIMS。MIMS收到请求后,将数据上报给CMMP。 基础数据增量同步与响应 CMMP可以根据需要发
10、送基础数据增量同步请求指令给MIMS。MIMS收到请求后,将相应时间范围内的增量数据上报给CMMP。 基础数据实时查询与响应 CMMP可以根据需要发送基础数据实时查询请求指令给MIMS。MIMS收到请求后,将查询时间范围内的数据上报给CMMP。 基础数据涉及的数据范围详见10.2节。 6.2 基础运营数据管理 MIMS应提供云计算业务的基础运营数据管理功能,接收 CMMP的查询指令并通过接口向CMMP 返回相关数据。如图 3所示。 MIMS CMMP 基础数据全量同步请求响应基础数据全量同步请求响应 基础数据增量同步请求基础数据增量同步请求 基础数据增量同步请求响应基础数据增量同步请求响应 基
11、础数据实时查询请求基础数据实时查询请求 基础数据实时查询请求响应基础数据实时查询请求响应 基础数据全量同步请求基础数据全量同步请求 YD/T 4 图 3 基础运营数据管理 CMMP 可以根据需要发送基础运营数据查询请求指令给 MIMS。MIMS收到请求后,将查询时间范围内的基础运营数据上报给 CMMP,数据范围详见 10.3 节。 6.3 业务运营数据管理 MIMS应提供云计算的业务运营数据管理功能,接收 CMMP的查询指令并通过接口向 CMMP 返回相关数据。运营数据包括企业资源及运行数据等。接口方式如图 4所示。 图 4 业务运营数据管理 CMMP 可以根据需要发送运营数据查询请求指令给
12、MIMS。MIMS收到请求后,将查询时间范围内的运营数据上报给 CMMP,数据范围详见 10.4节。 6.4 重大事项数据管理 MIMS应提供重大事项数据管理功能,通过接口主动上报日常经营活动中出现了重大临时事项。接口方式如图 5 所示。 图 5 重大临时事项数据管理 MIMS CMMP 基础运营数据查询基础运营数据查询 基础运营数据响应基础运营数据响应 MIMS CMMP 业务运营数据查询业务运营数据查询 业务运营数据响应业务运营数据响应 MIMS CMMP 重大临时事项上报重大临时事项上报 YD/T 5 CMMP 可以根据需要发送运营数据查询请求指令给 MIMS。MIMS收到请求后,将查询
13、时间范围内的运营数据上报给 CMMP,数据范围详见 10.5节。 7 接口流程 7.1 通信方式 MIMI包括指令通道和数据通道。 指令通道采用 WebService 方式,CMMP通过调用 MIMI接口方法将指令下发给 MIMS,指令流程见 7.2 节; 数据通道采用 SFTP方式,MIMS 使用 SFTP 协议将数据文件上报给 CMMP,数据上报流程见 7.3 节。 7.2 查询指令处理流程 CMMP 通过查询指令查询 MIMS的各类数据,包括云计算业务基础数据、基础运营数据、运营数据以及重大临时事项数据。MIMS 收到指令后,将符合查询条件的数据记录通过数据上报流程异步上报到 CMMP。
14、MIMS 按查询指令流程实现 CMMP上报基础数据记录核验结果的反馈。 查询指令处理流程如图 6所示。 a) CMMP系统调用 cloud_command()方法,将查询指令下发至 MIMS。指令以 XML 文件的格式封装。 b) MIMS 接收 CMMP 下发的查询指令,对指令进行信息校验。完成校验后保存查询指令,并在同一连接内及时反馈指令接收情况;如 MIMS没有成功接收到下发命令,CMMP 则需要重新下发。 c) 查询的结果信息通过调用数据上报流程返回查询结果。 d) 图上,1和 2 使用的是指令通道,3使用的是文件通道。 图 6 查询流程示意图 7.3 数据上报流程 MIMS CMMP
15、 1. cloud_command() 指令通道指令通道 2. cloud_command()返回返回 指令通道指令通道 3. cloud_file_load 数据通道数据通道 YD/T 6 数据查询上报中上报的数据包括云计算业务基础数据、基础运营数据、运营数据等。CMMP 为每个 MIMS 创建一个根目录,为便于描述,下文用 cloud_home 表示该目录,MIMS 负责维护自己的根目录。 上报数据文件的存放路径规则为:/cloud_home/上报数据类型代码/上报日期/。其中,上报数据类型共计 6种,对应的代码表见表 1,日期采用 YYYY-MM-DD 的格式编写。文件以生成时间命名且应
16、带有.xml后缀名,生成时间用 1970 年 1 月 1日到文件生成时的秒数表示(如,“生成时间.xml”形式)。 MIMS通过数据通道,将上传的数据放到 CMMP的相应目录下。数据上报文件大小的要求为单个上报数据文件应小于 12M字节,如上报数据量较大,可分拆为多个文件。 表 1 数据上报类型代码表 代码 上报数据类型 1 基础数据 2 基础运营数据 3 业务运营数据 4 重大事项数据 每个 MIMS在数据上报目录下有新建和写入权限,无删除权限;而在上报文件处理结果目录下有删除权限,无新建和写入权限。 数据上报的具体流程如下(如图 7所示)。 a) MIMS产生上报数据并以 XML 文件的格
17、式封装, MIMS调用 cloud_file_load方法,将原始的上报数据经过压缩加密封装后仍以 XML格式传送至 CMMP; b) CMMP 对上报的数据信息进行信息认证,如果认证成功则对上报的信息进行解密、解压等过程,得到原始上报数据,并进行相应处理; c) 处理结束后,CMMP 应生成相应的处理结果文件; d) MIMS 应在完成上报数据文件传送后及时获取 CMMP 对相应上报数据的处理结果,解决文件处理过程中产生的错误和异常,并重新进行数据上报流程。通常情况下,CMMP 对上报数据处理的时长不超过 10分钟(如遇极端情况,CMMP 应在 10分钟内通过代码“999”的处理结果文件告知
18、 MIMS相应上报数据仍在处理过程中)。 MIMS CMMP 1. cloud_file_load 2. 处理结果文件下载处理结果文件下载 YD/T 7 图 7 数据上报流程示意图 8 编码说明 8.1 互联网 IP 地址编码 IP地址编码使用方法如下: a) 对于 IPv4的地址,使用点分十进制表示法,字符串最大长度为 15 字节,例如地址10.2.0.100; b) 对于 IPv6的地址,使用冒号分开的十六进制表示法,字符串最大长度为 39 字节,例如地址2CDA:12:3FC0:567A:8ADE:130:10:94BF。 8.2 备案号 ICP备案号编码使用格式如下: a) 对于非经营
19、性 ICP 备案号编码,使用格式为ICP 备号的方式表示,例如:京 ICP备 05087018号; b) 对于经营性 ICP 备案号编码,使用格式为ICP 证号的格式表示,例如:京 ICP证 030173号。 9 数据代码表 9.1 接入方式代码表 接入方式代码见表 2。 表 2 接入方式代码 代代 码码 接入方式接入方式 1 专线 2 虚拟主机 3 虚拟存储 4 应用托管容器 999 其他 9.2 客户行业代码表 客户行业代码见表 3。 YD/T 8 表 3 行业代码 代代 码码 行业行业名称名称 1 军队 2 政府 3 金融 4 工业 5 能源 6 交通 7 教育 8 医疗 9 互联网 1
20、0 文娱 999 其他 9.3 证件类型代码表 证件类型代码见表 4。 表 4 证件类型代码 代代 码码 证件类型证件类型 1 工商营业执照号码 2 身份证 3 组织机构代码证书 4 事业法人证书 5 军队代号 6 社团法人证书 7 护照 8 军官证 9 台胞证 999 其他 9.4 机房性质代码表 机房性质代码见表 5。 表 5 机房性质代码 代代 码码 机房性质机房性质 1 租用 2 自建 999 其他 9.5 企业性质代码表 企业性质类型见表 6。 YD/T 9 表 6 企业性质代码 代代 码码 企业性质类型企业性质类型 1 国有企业 2 民营企业 3 个体企业 4 中外合资企业 5 外
21、商独资企业 999 其他 10 数据交换内容 10.1 数据格式及匹配要求 所有指令文件、上报记录、消息的数据内容均采用 UTF-8编码格式。 没有数据类型说明的数据节点/子节点均为字符串类型,其长度属性表示最大长度,实际数据不足最大长度的不应进行补位处理。各节点/子节点长度单位为字节。 所有 timeStamp节点描述的时间均采用 YYYY-MM-DD hh:mm:ss格式。 CMMP 和 MIMS对数据内容采用精确匹配的方式进行校验。 10.2 基础数据内容 云计算业务经营者 MIMS主动或根据监管侧 CMMP的查询指令将基础数据通过文件方式进行上报。云计算业务基础数据内容包括云计算业务经
22、营者企业信息、机房基础数据等,具体参见表 7。 表 7 基础信息 编号 节点 节点名称 必填 数据类型 长度 描述 1 spName 云计算经营者名称 必填 字符串 128 云计算业务经营者名称,与许可证上名称一致 2 spAddr 云计算业务经营者地址 必填 字符串 512 云计算业务经营者通信地址 3 corp 企业法人 必填 字符串 128 企业法人信息 4 spOfficer 联系人信息 必填 / / 单位的联系人信息与联系方式,具体信息见表 9 5 emergencyContact 应急联系人信息 必填 / / 单位应急联系人信息与联系方式,具体信息见表 9 6 houseCount
23、 云计算业务经营者的机房数量 必填 整型 / 涉及云/CDN 相关业务的机房数量 7 userCount 云计算业务经营者的用户总量 必填 整型 / 涉及云/CDN 相关业务的用户总数 8 houseInfo 云计算业务经营者的机房信息 必填 / / 涉及云/CDN相关业务机房数据,每个机房对应一条记录,记录的具体数据内容见表 8。 YD/T 10 (可重复多次) 9 smInfo 高级管理人员 选填 / / 总经理、副总经理、财务总监等公司高管人员信息,具体内容见表 10。 (可重复多次) 10 licenseInfo 许可证 必填 / / 许可证数据,记录的具体内容见表 11。 (可重复多
24、次) 11 spType 企业性质 必填 整型 / 企业性质对应代码值见表 6。 12 stockInfo 上市情况 选填 / / 若已上市则需要上报相关数据,记录的具体内容见表 12。 (可重复多次) 13 mainStockholderInfo 主要股东情况 必填 / / 主要股东数据,每个股东对应一个记录,记录的具体内容见表 13。 (可重复多次) 14 staffInfo 从业人员数量 必填 整型 / 员工数量 15 branchInfo 子公司信息 必填 / / 与云/CDN相关业务的子公司数据,每个子公司对应一个记录,记录的具体内容见表 14。 (可重复多次) 16 marketV
25、alue 市值 选填 整型 / 如上市,填写上市的市值 17 valuation 估值 选填 整型 / 如未上市,填写公司当前的估值 表 8 机房数据 编号 节点 节点名称 子节点 子节点名称 必填 数据类型 长度 描述 1 houseID 机房编号 / / 必填 字符串 32 机房唯一编号,企业自定义 2 houseName 机房名称 / / 必填 字符串 512 机房的名称 3 houseType 机房性质 / / 必填 整型 / 机房性质,见表 5。 4 houseProvince 机房所在省或直辖市 / / 必填 长整型 / 机房所在省或直辖市的行政区划数字代码GB/T 2260-20
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- YDT 3991-2021 云计算业务数据报送接口规范通信 YD 3991 2021 计算 业务 数据 报送 接口 规范 通信
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【曲****】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【曲****】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。