【YD通讯标准】 云资源管理技术要求 第4部分:接口

ICS33.030
中华人民共和国通信行业标准
YD/T2807.4-2015
云资源管理技术要求
第4部分：接口
Technical requirementsofcloudresourcemanagementPart4:Interface
2015-04-30发布
2015-07-01实施
中华人民共和国工业和信息化部发布前言·
1范围-
2规范性引用文件·
3术语和定义·
4缩略语
云资源管理平台的系统架构
资源管理接口·
接口概述
虚拟机管理
物理机管理·
存储管理
网络管理
镜像管理
资源模板管理接口
资源监控类接口.
运维监控接口
平台接口要求
7.1接口协议.
接口原则-
YD/T2807.4-2015
YD/T2807.4-2015
《云资源管理技术要求》分为五个部分：一第1部分：总体要求：
第2部分：综合管理平台：
一第3部分：分平台：
第4部分：接口：
第5部分：存储系统。
本部分是《云资源管理技术要求》第4部分。本部分按照GB/T1.1-2009给出的规则起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本部分由中国通信标准化协会提出并归口。本部分起草单位：中国联合网络通信集团有限公司、华为技术有限公司、工业和信息化部电信研究院、中国电信集团公司、中国科学院计算技术研究所。本部分主要起草人：徐雷、房秉毅、李素粉、陈娜、陈东楠、王煜炜。
HiiKAoNiKAca
1范围
云资源管理技术要求
第4部分：接口
YD/T2807.4-2015
本部分规定了云资源管理系统中综合管理平台和分平台间的接口技术要求，包括接口概述、虚拟机管理、物理机管理、存储管理、网络管理、镜像管理、资源模板管理接口、资源监控类接口、运维监控接口。还规定了平台接口要求。本部分适用于基于基础设施即服务（IaaS）的云计算资源管理系统。2规范性引用文件
本文件对于下列文件的引用是必不可少的。凡是标注日期的引用文件，仅所注日期的版本适用于本文件。凡是不标注日期的引用文件，其最新版本（包括所有的修改版本）适用于本文件。YD/T2807.2《云资源管理技术要求第2部分：综合管理平台》YD/T2807.3《云资源管理技术要求第3部分：分平台》3术语和定义
下列术语和定义适用于本文件。3.1
资源池ResourcesPool
一组物理资源或一组虚拟资源的集合，可以从池中获取资源，也可将资源回收到池中。资源包括物理机、虚拟机、物理存储资源、虚拟存储资源、虚拟网络资源和物理网络资源等。3.2
公网IPInternetIP
云计算平台对外提供用于用户访问互联网的P地址。3.3
用户User
云资源管理平台系统用户，包括运维管理用户和IaaS业务用户。4缩略语
下列缩略语适用于本文件。
Access Control List
Infrastructure as a Service
Input/Output
NetworkAttachedStorage
ServiceLevel Agreement
Representational State TransferStorageAreaNetwork
SimpleNetworkManagementProtocolSimple Object Access Protocol访问控制列表
基础设施及服务
输入/输出
网络接入存储
服务等级协议
表述性状态传递
存储区域网络
简单网络管理协议
简单对象访问协议
HiiKAoNiKAca
YD/T2807.4-2015
Socket
Socket
WLANWirelessLocalAreaNetworks5云资源管理平台的系统架构
套接字
无线局域网
云资源管理平台系统架构如图1所示，由综合管理平台和一个或多个分平台组成。综合管理平台与分平台之间通过资源管理接口连接。云资源管理平台系统对客户提供服务，并为运维管理人员提供维护管理功能。
综合管理平台的内容请见YD/T2807.2《云资源管理技术要求第2部分：综合管理平台》，分平台的内容请见YD/T2807.3《云资源管理技术要求第3部分：分平台》。用户
综合管理平台www.bzxz.net
资源管理接口
图1云资源管理平台系统构图
6资源管理接口
6.1接口概述
资源管理接口主要描述综合管理平台与分平台的接口，如图2所示。根据云业务的多个分平台系统要求，综合管理平台统一管理多个资源系统，本部分主要定义综合管理平台与所有分平台系统的资源管理接口。
根据接口用途不同，综合管理平台与分平台的接口分为两类：业务管理接口和资源操作接口：a）业务管理接口：提供创建、修改、删除资源模板接口、上报分平台资源状况信息接口、资源计量信息上报接口等功能：
b）资源操作接口：提供虚拟机操作接口、物理机操作接口、分布式文件存储服务接口、块存储服务接口、防火墙服务接口、IP地址服务接口、带宽服务接口、负载均衡服务接口、数据备份服务接口等。6.1.1业务管理接口
分为以下两类：
a）资源模板管理接口，包含资源模版管理功能的以下接口：1）创建资源模板：
2）上报资源模板：
3）修改资源模板；
4）同步资源模板：
5）删除资源模板。
HiiKAoiKAca
b）资源状况监控接口，包含实现资源监控功能的以下接口：1）上报分平台资源状况信息；
2）上报计量信息。
综合管理平台
接口层
资源管理平台
接口层
其他系统接口适配模块
资源管理平台接口适配模块
资源管理平台接口适配模块
计算资源
物理机
虚拟机
6.1.2资源类接口
包含以下三类：
a）计算资源类服务
网络资源
网络配置
公网IP
虚拟防火墙
负载均衡
资源池
2资源管理接口
存储资源
分布式文件存储
块存储
对象存储
●物理机操作接口，包含实现x86物理机操作功能的以下接口：1）申请物理机；
2）操作物理机：
3）控制物理机：
4）取消物理机：
5）变更物理机：
6）查询物理机状态。
●虚拟机服务接口，包含实现虚拟机租赁功能的以下接口：1）创建虚拟机：
2）操作虚拟机：
3）删除虚拟机：
4）更改虚拟机配置：
5）查询虚拟机状态：
YD/T2807.4-2015
HiiKAoNiKAca
YD/T2807.4-2015
6）备份虚拟机。
b）存储资源类服务
·分布式文件存储服务接口，包含实现分布式文件存储功能的以下接口：1）创建分布式文件存储：
2）删除分布式文件存储：
3）查询分布式文件存储；
4）设定分布式存储访问范围：
5）更改分布式存储配额。
·块存储服务接口，包含实现块存储功能的以下接口：1）创建块存储：
2）删除块存储；
3）查询块存储：
4）修改块存储：
5）加载块存储：
6）卸载块存储。
c）网络资源类服务
包含实现网络资源类功能的以下接口：1）启动网络端口；
2）关闭网络端口：
3）恢复网络端口：
4）重启网络端口：
5）增加VLAN：
6）关闭VLAN：
7）恢复VLAN：
8）增加ACL
9）关闭ACL：
10）恢复ACL：
11）增加IP地址；
12）删除IP地址；
13）增加路由；
14）删除路由；
15）访问网络设备：
16）申请网络端口：
17）变更网络端口；
18）取消网络端口。
虚拟机管理
虚拟机管理实现对虚拟机的启动、暂停和重启等操作，具体操作列表和说明见表1。4
HiiKAoNiKAca
表1虚拟机资源管理操作对应表
操作请求
启动虚拟机
暂停虚拟机
恢复虚拟机
停止虚拟机
重启虚拟机
访间虚拟机
申请虚拟机
变更虚拟机
原子操作
启动虚拟机
暂停虚拟机
恢复虚拟机
停止虚拟机
重启虚拟机
重定向
创建虚拟机
变更虚拟机
卸载块存储(与虚拟机相关)
取消虚拟机
1）操作虚拟机
解绑定IP地址(与虚拟机相关)
删除虚拟机
YD/T2807.4-2015
与资源池的互动
发送启动虚拟机指令
发送暂停虚拟机指令
发送恢复虚拟机指令
发送停止虚拟机指令
发送重启虚拟机指令
无，重定向到资源池
发送创建虚拟机指令
发送变更虚拟机指令
发送卸载块存储指令
发送解绑定IP地址指令
发送删除虚拟机指令
接收综合管理平台的启动、暂停、恢复、停止、重启虚拟机操作请求，其参数包括虚拟机唯一标识。
下发虚拟机操作请求到资源池。需要的原子操作包括：启动虚拟机，暂停虚拟机，恢复虚拟机，停止虚拟机、重启虚拟机。
收到资源池响应后，更新虚拟机状态信息并返回结果给综合管理平台。2）查询虚拟机状态
接收综合管理平台的查询虚拟机状态请求，参数包括虚拟机唯一标识。下发虚拟机状态查询请求到资源池，收到资源池的状态查询响应后返回给综合管理平台。3）访问虚拟机
用户通过门户访问虚拟机，综合管理平台的资源管理模块重定向用户请求到资源池，由资源池负责为用户提供访问界面。重定向请求的URL需要使用Token来保证访问的合法性。URL的格式：https://[资源池站点地址]/vmaccess/[用户ID]/[虚拟机资源ID]/[时间戳]/Token，其中Token=MD5([用户ID][虚拟机资源ID][时间戳[客户端IPJ[共享密钥J)，共享密钥是综合管理平台与资源池系统共享的密钥，客户端IP地址是访问用户的IP地址。4）创建虚拟机
接收综合管理平台的申请虚拟机请求，其参数包括虚拟机资源模板编号或者虚拟机的资源配置信息、资源池系统编号、分区编号和虚拟机数量信息。检查资源池系统及相应分区空闲资源是否满足用户申请的数量。如果不满足返回失败。下发创建虚拟机请求到资源池。需要的原子操作包括：创建虚拟机。收到资源池响应后，保存虚拟机信息并返回结果给综合管理平台。5）变更虚拟机
接收综合管理平台的变更虚拟机请求，其参数包括虚拟机唯一标识、虚拟机变更内容如CPU、内存、硬盘等。
下发变更虚拟机请求到资源池。收到资源池响应后，变更虚拟机信息并返回结果给综合管理平台。6）取消虚拟机资源
HiiKAoNiKAca
YD/T2807.4-2015
接收综合管理平台的取消虚拟机请求，其参数包括虚拟机唯一标识。先卸载块存储、解绑定公网P地址，再下发册删除虚拟机请求到资源池。需要的原子操作包括：卸载块存储、解绑定公网IP地址、删除虚拟机。收到资源池响应后，删除虚拟机信息并返回结果给综合管理平台。6.3物理机管理
物理机管理实现对物理机的控制、启动和关闭等管理操作，具体操作列表和说明见表2。表2物理机资源管理操作对应表
操作请求
物理机控制
启动物理机
关闭物理机
重启物理机
申请物理机
变更物理机
取消物理机
1）物理机控制
原子操作
物理机上电、下电
启动物理机
关闭物理机
重启物理机
申请物理机
变更物理机
卸载块存储(与物理机相关)
解绑定公网IP地址(与物理机相关)删除物理机
接收综合管理平台的物理机控制请求，其参数包括物理机编号信息。与资源池的互动
发送对物理机上下电指令
发送启动物理机指令
发送关闭物理机指令
发送重启物理机指令
发送申请物理机指令
发送变更物理机指令
发送卸载块存储指令
发送解绑定公网IP地址指令
发送删除物理机指令
下发物理机控制请求到资源池。收到资源池响应后，保存物理机信息并返回结果给综合管理平台。2）启动物理机
接收综合管理平台的物理机启动请求，其参数包括物理机编号信息，下发物理机启动请求到资源池。收到资源池响应后，保存物理机信息并返回结果给综合管理平台。3）关闭物理机
接收综合管理平台的物理机关闭请求，其参数包括物理机编号信息。下发物理机关闭请求到资源池。收到资源池响应后，保存物理机信息并返回结果给综合管理平台。4）申请物理机
接收综合管理平台的申请物理机请求，其参数包括物理机资源模板编号或者物理机资源配置信息、资源池系统编号、分区编号和物理机数量信息。检查资源池系统及相应分区空闲资源是否满足用户申请的数量。如果不满足则返回失败收，下发申请物理机请求到资源池。收到资源池响应后，保存物理机信息并返回结果给综合管理平台。5）变更物理机
接收综合管理平台的变更物理机请求，其参数包括物理机编号信息，物理机变更配件变化要求。下发变更物理机请求到资源池。收到资源池响应后，保存变更物理机信息并返回结果给综合管理平台。
6）取消物理机
接收综合管理平台的取消物理机请求，其参数包括物理机编号。先卸载块存储、解绑定公网P地址，再下发册删除物理机请求到资源池。6
HiiKAoNiKAca
需要的原子操作包括：卸载块存储、解绑定公网IP地址、删除物理机。收到资源池响应后，删除物理机信息并返回结果给综合管理平台。6.4存储管理
YD/T2807.4-2015
块存储和文件存储是存储管理的两个主要部分。块存储实现对块存储的申请、取消和查询等管理，具体操作列表和说明见表3。
表3存储资源管理操作对应表
操作请求
申请块存储
取消块存储
查询块存储
加载块存储
卸载块存储
1）创建块存储
原子操作
创建块存储
创建云监控（与块存储相关）
删除块存储
查询块存储
加载块存储
卸载块存储
与资源池的互动
发送创建块存储指令
发送创建云监控指令
发送删除块存储指令
发送查询块存储指令
发送加载块存储指令
发送卸载块存储指令
接收综合管理平台的申请块存储请求，其参数包括块存储资源模板编号、块存储大小、资源池系统编号。
下发创建块存储请求到资源池。需要的原子操作包括：创建块存储。收到资源池响应后，返回结果给综合管理平台。返回信息包括：块存储所属资源池、分区、块存储编号、块存储大小、块存储使用情况、块存储状态、块存储设备信息。2）删除块存储
接收综合管理平台的取消块存储请求，其参数包括块存储编号。下发删除块存储请求到资源池。需要的原子操作包括：删除块存储！收到资源池响应后，返回结果给综合管理平台。3）查询块存储
接收综合管理平台的查询块存储请求，其参数包括块存储编号。下发查询块存储请求到资源池。需要的原子操作包括：查询块存储。收到资源池响应后，返回结果给综合管理平台。块存储信息包括块存储编号、块存储大小，块存储使用情况，块存储状态，块存储设备信息，加载关联虚拟机唯一标识以及其它必要信息，4）加载块存储
接收综合管理平台的加载块存储请求，其参数包括虚拟机唯一标识和块存储编号。下发加载块存储请求到资源池。需要的原子操作包括：加载块存储。收到资源池响应后，返回结果给综合管理平台。5）卸载块存储
接收综合管理平台的卸载块存储请求，其参数包括虚拟机唯一标识和块存储编号。下发卸载块存储请求到资源池。需要的原子操作包括：卸载块存储。收到资源池响应后，返回结果给综合管理平台。文件存储包括申请、取消、变更和查询等操作，具体操作说明见表4。7
YD/T2807.4-2015
操作请求
申请文件存储
取消文件存储
变更文件存储
查询文件存储
1）创建文件存储
表4分布式文件系统管理操作对应表原子操作
创建文件存储
删除文件存储
变更文件存储
查询文件存储
与资源池的互动
发送创建文件存储指令
发送删除文件存储指令
发送变更文件存储指令
发送查询文件存储指令
接收综合管理平台的申请文件存储请求，其参数包括文件存储资源模板编号、文件存储大小、资源池系统编号。
下发创建文件存储请求到资源池。收到资源池响应后，返回结果给综合管理平台。返回信息包括：文件存储所属资源池、文件存储编号、文件存储大小、文件存储使用情况、文件存储状态、文件存储设备信息。
2）删除文件存储
接收综合管理平台的取消文件存储请求，其参数包括文件存储编号。下发删除文件存储请求到资源池。需要的原子操作包括：删除文件存储。收到资源池响应后，返回结果给综合管理平台。
3）变更文件存储
接收综合管理平台的变更文件存储请求，其参数包括文件存储编号。下发变更文件存储请求到资源池。收到资源池响应后，返回结果给综合管理平台。4）查询文件存储
接收综合管理平台的查询文件存储请求，其参数包括文件存储编号。下发查询文件存储请求到资源池。需要的原子操作包括：查询文件存储。收到资源池响应后，返回结果给综合管理平台。文件存储信息包括文件存储编号、文件存储大小、文件存储使用情况、文件存储状态、文件存储设备信息及其它必要信息。6.5网络管理
网络管理实现对网络端口、WLAN、ACL、IP地址、路由等软硬件网络资源的管理，具体操作列表和说明见表5。
表5网络资源管理操作对应表
操作请求
启动网络端口
关闭网络端口
恢复网络端口
重启网络端口
增加VLAN
关闭VLAN
恢复VLAN
增加ACL
关闭ACL
恢复ACL
原子操作
启动网络端口
暂停网络端口
恢复网络端口
重启网络端口
增加VLAN
暂停网络端口
恢复网络端口
增加ACL
暂停ACL
恢复ACL
与资源池的互动
发送启动网络端口指令
发送暂停网络端口指令
发送恢复网络端口指令
发送重启网络端口指令
发送增加VLAN指令
发送暂停网络端口指令
发送恢复网络端口指令
发送增加ACL指令
发送暂停ACL指令
发送恢复ACL指令
操作请求
增加IP地址
删除IP地址
增加路由
删除路由
访问网络设备
申请网络端口
变更网络端口
取消网络端口
1）操作网络端口
表5（续）
原子操作
增加IP地址
删除IP地址
增加路由
删除路由
重定向
创建网络端口
变更网络端口
解绑定网络IP地址(与虚拟机相关)YD/T2807.4-2015
与资源池的互动
发送增加IP地址指令
发送删除IP地址指令
发送增加路由指令
发送删除路由指令
无，重定向到资源池
发送创建网络端口指令
发送变更网络端口指令
发送解绑定网络IP地址指令
接收综合管理平台的启动、暂停、恢复、停止、重启网络端口操作请求，其参数包括虚拟机唯一标下发网络端口操作请求到资源池。需要的原子操作包括：启动网络端口、暂停网络端口、恢复网络端口、停止网络端口、重启网络端口。收到资源池响应后，更新端口状态信息并返回结果给综合管理平台。2）查询网络状态
接收综合管理平台的查询网络状态请求，参数包括网络唯一标识。下发网络状态查询请求到资源池，收到资源池的状态查询响应后返回给综合管理平台。3）访问网络设备
用户通过门户访问网络设备（路由器、交换机、防火墙、负载均衡等），综合管理平台的资源管理模块重定向用户请求到资源池，由资源池负责为用户提供访问界面。重定向请求的URL需要使用Token来保证访问的合法性。
URL的格式：https://[资源池站点地址J/networkaccess/[用户ID]/[时间截]/Token，其中Token=MD5([时间戳[客户端IPI[共享密钥J)，共享密钥是综合管理平台与资源池系统共享的密钥，客户端IP地址是访问用户的IP地址。3）创建网络服务
接收综合管理平台的申请网络服务请求，其参数包括网络资源模板编号或者网络的资源配置信息，资源池系统编号、分区编号和网络资源数量信息。检查资源池系统及相应分区空闲资源是否满足用户申请的数量。如果不满足则返回失败。下发创建网络服务请求到资源池。需要的原子操作包括：创建网络服务。收到资源池响应后，保存网络服务信息并返回结果给综合管理平台。4）变更网络服务
接收综合管理平台的变更网络服务请求，其参数包括网络服务唯一标识、网络服务变更内容如IP、VLAN等。
下发变更网络服务请求到资源池。收到资源池响应后，变更网络服务信息并返回结果给综合管理平台。
5）取消网络服务资源
接收综合管理平台的取消网络服务请求，其参数包括网络服务唯一标识。9
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。