【YD通讯标准】 云运维管理接口技术要求

ICS33.020
中华人民共和国通信行业标准
YD/T2717-2014
云运维管理接口技术要求
Thetechnicalrequirementsfor
management interface of cloud computing2014-10-14发布
2014-10-14实施
中华人民共和国工业和信息化部发布前言·
1范围·
2规范性引用文件
3术语、定义和缩略语·
3.1术语和定义…
3.2缩略语·
4接口位置
5接口功能
配置管理·
5.2告警管理·
5.3性能管理…
6接口信息模型
接口信息模型描述表格说明·
配置管理信息模型
告警管理信息模型
性能管理信息模型.
通知管理信息模型·
附录A（资料性附录）状态编码对照表参考文献
YD/T2717-2014
YD/T2717-2014
本标准是云运维管理系列标准之一，该系列标准预计包括下列标准：云资源运维管理功能技术要求：云运维管理接口技术要求（本标准）。本标准按照GB/T1.1-2009给出的规则起草。本标准由中国通信标准化协会提出并归口。本标准起草单位：北京邮电大学、北京市天元网络技术股份有限公司、大唐电信科技产业集团。本标准主要起草人：邱雪松、王颖、李文璟、陈兴渝、王亚鹏、李强强、王志强。HiiKAoNiKAca
1范围
云运维管理接口技术要求
YD/T2717-2014
本标准规定了云运营支撑系统与云资源管理平台、云服务支撑系统之间的接口，包括接口功能、协议和信息模型，以支持云运营支撑系统实现云资源运维管理、云服务开通管理、云服务保障管理、特定云服务运维管理及云合作运维管理等功能。本标准适用于云运营支撑系统与云资源管理平台、云服务支撑系统之间的接口。2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。云资源运维管理功能技术要求
3术语、定义和缩略语
3.1术语和定义
下列术语和定义适用于本文件。3.1.1
资源池ResourcePool
一组物理资源或一组虚拟资源的集合，可以从池中获取资源，也可将资源回收到池中。3.1.2
虚拟机VirtualMachine
通过各种虚拟化技术，为用户提供的与原有物理服务器相同的操作系统和应用程序运行环境的统称。虚拟机通常使用物理服务器的部分资源，在用户看来它与物理服务器的使用完全相同。3.1.3
镜像Image
以虚拟机为颗粒度将各虚拟硬件设备等封装成的一个文件。3.1.4
快照Snapshot
对某一时刻某状态下虚拟机的实时描述（包含所有的硬盘信息、内存信息和CPU信息等），可用于创建新的虚拟机或恢复虚拟机到某一状态。3.2缩略语
下列缩略语适用于本文件。
Business Support System
Configuration Management Data BaseCentral Processing Unit
业务支撑系统
配置管理数据库
中央处理器
HiiKAoNiKAca
YD/T2717-2014
4接口位置
HyperTextTransferProtocol
Identifier
InternetEngineeringTaskForceInternet Protocol
Media Access Control
Operation Support System
Representational State TransferService-Level Agreement
Simple Network Management ProtocolSimple Object Access ProtocolVirtual Machine
超文本传输协议
互联网工程任务组
互联网协议
媒质访问控制
运营支撑系统
描述性状态转移
服务等级协议
简单网络管理协议
简单对象访问协议
虚拟机
云运维管理体系结构如图1所示。云运维管理对象包括云资源、各类云服务支撑系统（如BSS等）和云服务系统（如云桌面、云呼叫中心等）、云接入能力及云用户。云运营支撑系统（OSS）包括云资源运维管理、云服务开通管理、云服务保障管理、特定云服务运维管理及云合作运维管理等功能。用户层
接入层
云服务系统
服务层
云服务支撑系统
云资源
云资源管理平台
特定云服务运维管理
（云桌面、云呼叫中心等）
云服务开通管理
（服务部署、策略、自动化）
云服务保障管理
（监控、问题和事故、SLA）
云资源运维管理
云合作运维管理
图1云运维管理体系结构
OSS与被管理的云对象之间分别通过接口I1、I2、I3、I4及I5进行管理信息的交互。接口I1支持OSS对物理资源、虚拟资源及云资源管理平台的管理：接口I2支持OSS对云服务支撑系统的管理；接口I3支持OSS对云服务系统的管理：接口I4支持OSS对云接入能力的管理：接口I5支持OSS对云用户的管理本标准规定的云运维管理接口位置为接口I1、I2，实现OSS对云资源运维管理的支撑功能，对云服务开通管理、云服务保障管理、特定云服务运维管理及云合作运维管理等的支撑功能待研究。云运维管理体系结构中相关模块的含义见《云资源运维管理功能技术要求》第5章。接口协议应支持云资源数据的获取和上报以及云资源管理策略的下发，目前的主流协议包括REST、SNMP、SOAP等。
HiiKAoNiKAca
5接口功能
5.1配置管理下载标准就来标准下载网
5.1.1物理资源管理
5.1.1.1查询物理资源
物理资源主要指物理主机。
OSS向云资源管理平台发送查询物理资源请求，请求参数包括：物理资源标识（可选）：
YD/T2717-2014
查询过滤条件（条件必选、不指定物理资源标识时此项必填，指定物理资源标识时此项选填。填写内容为物理资源配置属性或属性的组合）。云资源管理平台收到请求后查询物理资源配置信息返回给OSS，响应参数包括：物理资源配置信息（操作成功时填写，包括物理资源标识、操作系统、CPU、内存、磁盘、网络、创建时间等）：
一物理资源状态信息（操作成功时填写，取值包括已停止、正在停止、正在启动、已启动、已暂停、正在暂停、正在恢复、正在重启等）：失败原因（操作失败时返回异常情况代码，异常情况代码表参见附录A）。查询结果有多个物理资源满足过滤条件时，应返回以上响应参数的列表。5.1.1.2查询物理资源与虚拟资源间关系OSS向云资源管理平台发送查询物理资源与虚拟资源间关系请求，请求参数包括：一资源标识（物理资源标识或虚拟资源标识）。应参数包：
关联的资源标识列表（物理资源关联的虚拟资源标识列表、虚拟资源关联的物理资源标识列表或物理资源间的关联标识列表）：查询结果没有关联资源时应给出无关联资源提示信息。5.1.1.3物理资源监控
当有新增物理资源或存在的物理资源被删除时，云资源管理平台应能通过接口主动向OSS发送物理资源创建或删除通知，通知中应包含所创建对象完整信息或删除的对象标识。当物理资源的配置信息或资源状态发生改变时，云资源管理平台应能通过接口主动向OSS发送物理资源属性改变通知，通知中应包含发生改变的对象标识以及新的属性值。5.1.2虚拟资源管理
5.1.2.1计算资源
5.1.2.1.1虚拟机管理
5.1.2.1.1.1查询虚拟机
OSS向云资源管理平台发送查询虚拟机请求，请求参数包括：虚拟机标识（可选）：
一查询过滤条件（条件必选、不指定虚拟机标识时此项必填，指定虚拟机标识时此项选填。填写内容为虚拟机配置属性或属性的组合）。云资源管理平台收到请求后查询虚拟机配置及当前状态信息返回给OSS，响应参数包括：3
HiiKAoNiKAca
YD/T2717-2014
一虚拟机当前资源状态（操作成功时填写，取值可包括已初始化、正在创建、已创建、正在损坏、已损坏、准备等）：
一虚拟机当前服务状态（操作成功时填写，取值可包括已停止、正在停止、正在启动、已启动、已暂停、正在暂停、正在恢复、正在重启）；虚拟机配置信息（操作成功时填写，包括虚拟机标识、操作系统、CPU、内存，磁盘、网络、创建时间等）：
失败原因（操作失败时返回异常情况代码，异常情况代码表参见附录A）。查询结果有多个虚拟机满足过滤条件时，应返回以上响应参数的列表。5.1.2.1.2虚拟机镜像管理
5.1.2.1.2.1查询虚拟机镜像
OSS向云资源管理平台发送查询虚拟机镜像请求，查询过滤条件为虚拟机镜像属性或属性的组合，云资源管理平台收到请求后查询并返回该虚拟机镜像信息给OSS。当查询结果为多个时以列表的方式返回。虚拟机镜像信息包括：
镜像文件标识：
一镜像文件名称：
镜像操作系统：
一创建时间等。
5.1.2.1.2.2上传虚拟机镜像
OSS向云资源管理平台发送上传虚拟机镜像请求，请求参数包括：镜像文件标识：
镜像文件名称：
镜像文件本地路径：
一服务器路径等。
云资源管理平台收到请求后上传该虚拟机镜像，并返回操作结果（成功或失败）给OSS.5.1.2.1.2.3下载虚拟机镜像
OSS向云资源管理平台发送下载虚拟机镜像请求，下载相应的虚拟机镜像文件。请求参数包括：一镜像文件本地路径：
一服务器路径：
镜像文件标识：
镜像名称等。
云资源管理平台收到请求后下载指定的虚拟机镜像文件。5.1.2.1.3计算资源监控
计算资源主要包括虚拟机、虚拟机镜像、快照。当有新增计算资源或存在的计算资源被删除时，云资源管理平台应能通过接口主动向OSS发送计算资源创建或删除通知，通知中应包含所创建对象完整信息或删除的对象标识。当计算资源的配置信息或资源状态发生改变时，云资源管理平台应能通过接口主动向OSS发送计算资源属性改变通知，通知中应包含发生改变的对象标识以及新的属性值。4
HiiKAoNiKAca
5.1.2.2存储资源
5.1.2.2.1查询存储空间
OSS向云资源管理平台发送查询存储空间请求。请求参数包括：一存储空间标识（可选）：
YD/T2717-2014
一查询过滤条件（条件必选、存储空间标识为空时此项必填，过滤条件可为存储空间属性或属性的组合）。
云资源管理平台收到请求后查询指定存储空间的配置信息及状态信息并返回给OSS。响应参数包括：存储空间当前状态（取值包括已初始化、正在创建、已创建、正在损坏、已损坏、准备等）：存储空间配置参数（包括存储空间标识、存储空间类型、存储空间大小、创建时间等）。当查询结果为多个存储空间时，返回结果为以上信息的列表。5.1.2.2.2存储资源监控
当有新增存储空间或存在的存储空间被删除时，云资源管理平台应能通过接口主动向OSS发送存储空间创建或别除通知，通知中应包含所创建对象完整信息或删除的对象标识。当存储空间的配置信息或资源状态发生改变时，云资源管理平台应能通过接口主动向OSS发送存储资源属性改变通知，通知中应包含发生改变的对象标识，以及新的属性值。5.1.2.3网络资源
5.1.2.3.1查询网络接口
OSS向云资源管理平台发送查询虚拟机网络接口请求，查询指定虚拟机的网络接口信息。请求参数包括虚拟机标识。
云资源管理平台收到请求后查询该虚拟机网络接口，并返回操作结果给OSS。响应参数包括：——网络接口标识：
一接口连接网络标识：
一接口所属网络链路标识：
一接口MAC地址：
—接口IP地址：
创建时间：
一一网络接口当前状态（如已初始化、正在创建、已创建、正在损坏、已损坏、准备、激活、未激活等）。
5.1.2.3.2网络资源监控
网络资源主要指虚拟机配置的网络接口。当有新增网络资源或存在的网络资源被删除时，云资源管理平台应能通过接口主动向OSS发送网络资源创建或删除通知，通知中应包含所创建对象完整信息或删除的对象标识。当网络资源的配置信息或资源状态发生改变时，云资源管理平台应能通过接口主动向OSS发送网络资源属性改变通知，通知中应包含发生改变的对象标识以及新的属性值，5.1.3资源池管理
5.1.3.1查询系统包含的资源池
OSS向云资源管理平台发送查询包含的资源池请求，查询管理的资源池信息。请求参数包括：5
HiiKAoNiKAca
YD/T2717-2014
云资源管理平台标识。
云资源管理平台收到请求后查询该云资源管理平台下包含的资源池，并返回查询结果给OSS。响应参数包括：
包含的资源池数量
一包含的资源池标识列表。
5.1.3.2查询资源池及其包含的资源OSS向云资源管理平台发送查询资源池及其包含的资源请求，查询资源池本身的配置信息及该资源池包含的资源信息，包含的资源包括计算、存储和网络的物理资源和虚拟资源等。请求参数包括：一云资源管理平台标识：
一资源池标识。
云资源管理平台收到请求后查询指定资源池的配置信息及其包含的资源，并返回查询结果给OSS。响应参数包括：
一资源池配置信息（如资源池标识、名称、包含的子资源池标识列表、最大容量、最小容量、所属系统标识、创建时间、状态等）：一一资源池包含的资源标识列表。5.1.4资源分配策略管理
5.1.4.1查询资源分配策略
OSS向云资源管理平台发送查询资源分配策略信息。请求参数包括：策略类型（如负载平衡策略，高可用策略，节能策略等，各策略的定义见《云资源运维管理功能技术要求》中9.1资源分配策略制定）。云资源管理平台收到请求后查询该类型的分配策略，并将查询结果反馈给OSS。响应参数包括：一资源分配策略信息描述：
资源分配策略执行情况。
5.1.4.2下发资源分配策略
OSS向云资源管理平台下发资源分配策略。请求参数包括：云资源管理平台：
一策略类型（如负载平衡策略、高可用策略、节能策略等）：资源分配策略信息描述。
云资源管理平台接收该类型的分配策略，并将接收结果（成功或失败）反馈给OSS。5.1.5云平台系统管理
5.1.5.1查询云平台系统
OSS向云资源管理平台或云服务支撑系统发送查询云平台系统请求，查询管理的云平台系统信息。云平台系统指云资源管理平台或云服务支撑系统。请求参数包括：—云平台系统标识。
云平台系统收到请求后查询该云平台系统，并返回查询结果给OSS。响应参数包括：云平台系统标识（指云资源管理平台或云服务支撑系统的唯一标识）；名称；
TiiKAoNiKAca
一系统类型：
软件版本：
一一运行状态（可用、不可用）：创建时间；
创建者。
5.1.5.2查询云平台系统当前告警YD/T2717-2014
云平台系统当前告警包括云平台系统本身产生的告警和云平台系统所管理资源产生的告警。OSS向云平台系统发送查询云平台系统当前告警请求，查询云平台系统下满足查询过滤条件的当前告警信息。请求参数包括：
云平台系统标识（指云资源管理平台或云服务支撑系统的唯一标识）：—告警原因（可选）：
—告警级别（可选）。
云平台系统收到请求后查询该云平台系统当前告警信息，当告警原因、告警级别为空时，返回该云平台系统下的所有当前告奢。响应参数包括：一当前告警信息列表，告警详细信息见5.2.1告警上报。5.1.5.3查询云平台系统下所有管理对象标识OSS向云资源管理平台发送查询云资源管理平台下所有管理对象标识。管理对象包括：物理机、虚拟机、虚拟机镜像、存储空间、网络接口等。请求参数包括：云平台系统标识（指云资源管理平台的唯一标识）。云资源管理平台收到请求后查询该云资源管理平台下所有管理对象标识。响应参数包括：管理对象标识列表。
5.1.5.4查询云平台系统下所有管理对象OSS向云资源管理平台发送查询云资源管理平台下所有管理对象信息。管理对象包括：物理机、虚拟机、虚拟机镜像、存储空间、网络接口等。请求参数包括一云平台系统标识（指云资源管理平台的唯一标识）云平台系统收到请求后查询该云平台系统下所有管理对象信息。响应参数包括：一管理对象信息列表。
5.1.5.5云平台系统监控
当有新增云平台系统或存在的云平台系统被删除时，云平台系统应能通过接口主动向OSS发送云平台系统创建或删除通知，通知中应包含所创建对象完整信息或删除的对象标识。当云平台系统的配置信息或资源状态发生改变时，云平台系统应能通过接口主动向OSS发送云平台系统属性改变通知，通知中应包含发生改变的对象标识，以及新的属性值。5.2告警管理
5.2.1告警上报
云资源管理平台或云服务支撑系统应支持以告警日志或告警通知的形式实时向OSS上报所有的告警事件。具体的告警信息包括：
告警标识；
YD/T2717-2014
告警源：
告警类型：
告警级别：
告警状态：
告警原因：
告警发生时间：
相关告警等。
5.2.2告警过滤
OSS可设置告警上报过滤条件，进而控制云资源管理平台或云服务支撑系统上报的告警。具体的过滤条件可为以下参数的组合：
告警源：
告警类型：
—告警级别：
告警状态：
告警原因：
告警发生时间等。
接口应支持设置多个告警过滤条件，只有符合条件的告警才上报给OSS。同时，接口应支持取消告警过滤的功能，取消指定的告警上报过滤条件。5.2.3告警同步
OSS可同步云资源管理平台或云服务支撑系统中某时间段内的告警数据。同步过滤条件包括：起始时间：
-终止时间；
—同步范围等。
5.2.4告警数据
云环境下管理的物理资源、虚拟资源可产生告警的告警原因见表1。表1告警原因
告警原因
CPU利用率越限告警
内存利用率越限告警
存储空间利用率越限告警
5.3性能管理
5.3.1性能采集任务管理
CPU利用率越限告警
内存利用率越限告警
存储空间利用率越限告警
OSS向云资源管理平台创建性能采集任务，实现性能数据的采集。创建性能采集任务的请求参数包括：性能监测点：
性能参数列表：
采集开始时间（可选，若不指定表示立即开始采集）：采集结束时间（可选，若不指定表示一直采集）：8
上报时间间隔（时间粒度的整数倍）：一性能采集周期（时间粒度）。创建成功则返回性能采集任务标识，创建失败则返回失败原因。YD/T2717-2014
对于性能采集任务，接口上还应支持通过指定性能采集任务标识暂停、恢复、删除性能采集任务以及查询、修改性能采集任务参数的功能。5.3.2性能数据上报
云资源管理平台周期性采集性能数据并通过接口上报性能数据到OSS，上报周期（上报时间间隔）应为性能采集周期（时间粒度）的整数倍。5.3.3性能数据同步
OSS可通过接口向云资源管理平台同步性能数据。同步请求参数包括：性能监测点；
性能参数列表（为空时，则同步监视对象的所有性能参数的采集数据）：一采集开始时间：
一采集结束时间。
云资源管理平台返回满足同步请求条件的性能数据，5.3.4性能数据要求
云资源管理平台应支持采集其管理的云资源相关的性能数据指标，主要包括：物理资源的性能数据指标：
CPU利用率：
一内存利用率：
一磁盘利用率等。
虚拟机的性能数据指标：
CPU利用率：
一内存利用率：
一磁盘利用率等。
存储资源的性能指标：
一IO流量（如随机读写流量、顺序读写流量，单位MB/s）：一存储空间利用率等。
网络资源的性能指标：
网络端口的网络流量：
一带宽；
一丢包率：
时延等。
6接口信息模型
6.1接口信息模型描述表格说明
接口信息模型描述表格主要包括数据结构定义描述表格和接口定义描述表格，表格模板见表2和表3。9
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。