标准搜索结果: 'GB/T 31915-2015'
| 标准编号 | GB/T 31915-2015 (GB/T31915-2015) | | 中文名称 | 信息技术 弹性计算应用接口 | | 英文名称 | Information technology -- Elastic computing application interface | | 行业 | 国家标准 (推荐) | | 中标分类 | L79 | | 国际标准分类 | 35.100.05 | | 字数估计 | 37,344 | | 发布日期 | 2015-09-11 | | 实施日期 | 2016-05-01 | | 引用标准 | GB/T 7408-2005; RFC 2616 | | 起草单位 | 中国移动通信有限公司研究院 | | 归口单位 | 全国信息技术标准化技术委员会 | | 标准依据 | 国家标准公告2015年第25号 | | 提出机构 | 全国信息技术标准化技术委员会(SAC/TC 28) | | 发布机构 | 中华人民共和国国家质量监督检验检疫总局、中国国家标准化管理委员会 | | 范围 | 本标准给出了弹性计算体系结构, 规定了弹性计算应用接口通用要求和接口定义。本标准适用于弹性计算应用接口的设计、开发和服务提供。 | GB/T 31915-2015
Information technology - Elastic computing application interface
ICS 35.100.05
L79
中华人民共和国国家标准
信息技术 弹性计算应用接口
2015-09-11发布
2016-05-01实施
中华人民共和国国家质量监督检验检疫总局
中国国家标准化管理委员会发布
目次
前言 Ⅰ
1 范围 1
2 规范性引用文件 1
3 术语、定义和缩略语 1
3.1 术语和定义 1
3.2 缩略语 1
4 弹性计算体系结构 2
5 弹性计算应用接口通用要求 2
5.1 概述 2
5.2 数据类型 2
5.3 HTTP协议 3
6 弹性计算应用接口定义 4
6.1 概述 4
6.2 出错处理方式 4
6.3 虚拟机租赁接口 5
6.4 虚拟机镜像管理接口 16
6.5 卷管理接口 19
6.6 公网IP地址管理接口 22
6.7 负载均衡器管理接口 25
6.8 安全组管理接口 28
6.9 密钥管理接口 32
前言
本标准按照GB/T 1.1-2009给出的规则起草。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。
本标准由全国信息技术标准化技术委员会(SAC/TC28)提出并归口。
本标准起草单位:中国移动通信有限公司研究院、华为技术有限公司、中国电子技术标准化研究
院、浪潮(北京)电子信息产业有限公司、东软集团股份有限公司、上海计算机软件技术开发中心、深圳市
金蝶中间件有限公司、阿里云计算有限公司、中兴通讯股份有限公司、中标软件有限公司、用友软件股份
有限公司、北京华胜天成科技股份有限公司、北京航空航天大学。
本标准主要起草人:段翔、李海波、寇欣、余祥、王洁萍、唐廷芳、陈岭、颜秉珩、何光宇、蔡立志、
林琳、李战园、楚俊生、安宁、胡捷、白占来、田忠、秦习庆、王国伟、赵江、梁钢、赵海、陈志峰、杨丽蕴、
王卫国、丛培勇。
信息技术 弹性计算应用接口
1 范围
本标准给出了弹性计算体系结构,规定了弹性计算应用接口通用要求和接口定义。
本标准适用于弹性计算应用接口的设计、开发和服务提供。
2 规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文
件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。
GB/T 7408-2005 数据元和交换格式 信息交换 日期和时间表示法
3 术语、定义和缩略语
3.1 术语和定义
下列术语和定义适用于本文件。
3.1.1
虚拟机 virtualmachine
一种虚拟的数据处理系统,它看起来是在某个特定用户的独占使用下,但其功能是通过共享真实数
据处理系统的各种资源得以实现的。
[GB/T 5271.1-2000,定义01.01.50]
3.1.2
虚拟机镜像 virtualmachineimage
虚拟机对应的文件系统镜像,包括操作系统及虚拟机运行需要的软件。
3.1.3
配置虚拟机所需的元数据集合,包括CPU数量、内存大小和磁盘大小等。
注:虚拟机模板用于方便地生成虚拟机。
3.1.4
安全组 securitygroup
防火墙规则的集合。
3.2 缩略语
下列缩略语适用于本文件。
ID 标识符(Identifier)
LB 负载均衡(LoadBalance)
SSH 安全外壳协议(SecureShel)
VM 虚拟机(VirtualMachine)
4 弹性计算体系结构
弹性计算体系结构如图1所示。
图1 弹性计算体系结构
弹性计算是指以按需、动态可伸缩、多租户的方式为用户提供虚拟主机及其空间等相关资源的租赁
服务的计算模式。弹性计算体系结构包括3个部分:服务层、接口层和应用层。服务层是由弹性计算服
务提供商提供的用于虚拟机及相关资源管理的各类服务的总称。接口层定义了不同弹性计算服务均应
遵循的统一接口。应用层包括各类信息系统。
5 弹性计算应用接口通用要求
5.1 概述
弹性计算应用接口通用要求规定了弹性计算服务所使用的数据类型、接口协议。
5.2 数据类型
5.2.1 日期与时间表示
日期和时间表示包括以下两个部分:
a) 日期与时间
日期与时间的表示应遵循GB/T 7408-2005,具体见表1。
表1 日期与时间的表示
日期/时间 表示
年 yyyy
月 mm
日 Dd
表1(续)
日期/时间 表示
时 hh(24小时制)
分 nn
秒 ss
b) 日期与时间分隔符
日期与时间分隔符的表示应遵循GB/T 7408-2005,具体见表2。
表2 日期与时间分隔符的表示
分隔符类别 表示
日期分隔符 -
时间分隔符:
日期与时间分隔符 一个半角空格
示例:
2005年12月9日21时01分39秒表示为:2005-12-0921:01:39。
5.2.2 参数类型表示
三类参数类型的表示如下:
a) Int:十进制的整数型;
b) String:由字符组成的字符串;
c) List< >:包含一个或多个参数的列表。
5.3 HTTP协议
5.3.1 概述
弹性计算应用平台向用户提供的应用接口可采用HTTP(见RFC2616)中规定的GET方法传输。
通信双方采用一问一答的通讯机制,即一次应答对应于一次请求。
注:GET方法是 HTTP协议中规定的获取信息的命令。
HTTP协议的请求接口URL由三部分组成:
a) 目的服务器;
b) 公共参数:每条查询请求都应包含的参数;
c) 特有参数:各接口的特有参数。该参数由弹性计算平台提供者规定并实现。
5.3.2 公共参数
公共参数包含弹性计算应用接口中所有查询接口的公共参数,详见表3。
表3 公共参数
参数名 数据类型 约束 说明
Action String 必选 动作名称,如创建虚拟机为CreatVM
Version String 必选 接口版本
Timestamp String 必选 请求发起时间,格式为yyyy-mm-ddhh:mm:ss
AccessKeyId String 可选
用户访问密钥ID,用户注册后平台分配给用户的安全访问密钥对应的
唯一标识
SignatureMethod String 可选 签名算法名称,关于签名算法的使用应参考国家相关规定和标准
Signature String 可选 根据签名算法生成的签名
5.3.3 用户身份鉴别和消息完整性验证
至少应选用HTTP协议的以下机制:
a) 用户身份鉴别机制,保证使用弹性计算应用平台的用户身份的合法性;
b) 消息完整性验证,保证用户和弹性计算平台之间传输的HTTP消息的完整性。
6 弹性计算应用接口定义
6.1 概述
弹性计算应用接口包括以下7类功能接口:
a) 虚拟机租赁接口
包括虚拟机的创建、启动、停止、重启、挂起、恢复、删除、查询和修改的功能接口;
b) 虚拟机镜像管理接口
包括虚拟机镜像的创建、删除、导入、导出和查询;
c) 卷管理接口
包括卷的创建、删除、查询、加载和卸载;
d) 公网IP地址管理接口
包括公网IP地址的申请、释放、查询、绑定和解绑定;
e) 负载均衡器管理接口
包括负载均衡器的创建、删除、查询、挂载、删除和修改;
f) 安全组管理接口
包括安全组的创建、删除和查询,以及安全规则的添加和删除;
g) 密钥管理接口
包括密钥的创建、删除和查询。
6.2 出错处理方式
弹性计算应用接口在返回操作执行结果时,宜采用统一的出错处理方式:如果操作执行失败,弹性
计算应用接口应返回出错信息。出错信息描述见表4。
表4 出错信息描述
字段名 类型 约束 说明
Faultstring String 必选 操作失败后的出错信息
6.3 虚拟机租赁接口
6.3.1 虚拟机状态
虚拟机租赁包括对虚拟机全生命周期的管理。虚拟机的全生命周期从虚拟机创建动作发起开始,
到完成该虚拟机的删除命令结束。在虚拟机的全生命周期内均可查询状态。虚拟机全生命周期内包括
10个状态,分别为:创建中、创建完成、删除中、停止、启动中、运行、挂起中、挂起、恢复中、停止中。这10
个状态之间的转换如图2所示。
图2 虚拟机状态转换
图2中虚拟机创建完成后,虚拟机可能的状态迁移通过虚线以下的部分表示。虚拟机状态包括两
类:稳定状态和中间状态。
6.3.1.1 稳定状态
虚拟机稳定状态包括4类,具体如下:
a) 创建完成状态:用户具备使用所申请资源的使用权限的状态;
b) 运行状态:用户所申请的虚拟机处于可提供正常服务的状态;
c) 停止状态:用户所申请的虚拟机处于停止服务的状态;
d) 挂起状态:用户所申请的虚拟机处于暂停服务的状态并保证当前运行状态下的数据不丢失。
6.3.1.2 中间状态
虚拟机中间状态包括6类,具体如下:
a) 创建中:虚拟机从无到创建完成状态转换的中间状态;
b) 删除中:虚拟机从创建完成状态到结束转换的中间状态;
c) 启动中:虚拟机从停止状态向运行状态转换的中间状态;
d) 挂起中:虚拟机从运行状态向挂起状态转换的中间状态;
e) 停止中:虚拟机从运行状态向停止状态转换的中间状态;
f) 恢复中:虚拟机从挂起状态向运行状态转换的中间状态。
6.3.1.3 虚拟机状态迁移操作
虚拟机不同状态之间的迁移通过以下7类操作实现:
a) 创建操作:该操作完成虚拟机的硬件、软件等资源的申请,操作完成之后弹性计算平台赋予用
户相应资源的使用权限;
b) 删除操作:该操作完成释放用户已申请虚拟机的硬件、软件等资源;
c) 启动操作:该操作完成将用户所申请的虚拟机从停止服务状态转换到运行状态;
d) 停止操作:该操作完成将用户所申请的虚拟机从运行状态转换到停止服务状态;
e) 挂起操作:该操作完成将用户所申请的虚拟机从运行状态转换到挂起状态;
f) 恢复操作:该操作完成将用户所申请的虚拟机从挂起状态转换到运行状态;
g) 重启操作:该操作完成将用户所申请的虚拟机从运行状态经过再次启动回到运行状态。
6.3.2 创建虚拟机(CreateVM)
6.3.2.1 接口功能
该接口根据用户指定的参数完成虚拟机的创建。
如果操作成功,应返回已创建的虚拟机信息列表;如果操作失败,应返回出错信息(见表4)。
6.3.2.2 接口消息
请求消息和应答消息如下:
a) 请求消息:CreateVMReq
请求消息见表5。
表5 请求消息
字段名 类型 约束 说明
VMTemplateID String 必选 虚拟机模板唯一标识
CoreCount Int 必选
CPU核数,单位为核(与 VMTemplateID不能同时出现在创建
虚拟机的请求中,否则返回出错信息)
MemorySize Int 必选
内存大小,单位为 MB(与VMTemplateID不能同时出现在创建
虚拟机的请求中,否则返回出错信息)
DiskSize Int 必选
磁盘大小,单位为 MB(与VMTemplateID不能同时出现在创建
虚拟机的请求中,否则返回出错信息)
表5(续)
字段名 类型 约束 说明
ImageID String 必选 虚拟机镜像唯一编码
Count Int 必选 创建虚拟机的个数
VMPasswords List< VMPassword > 可选 虚拟机管理员的随机口令,由用户指定。长度为1或者Count
BSIDs List< BSID > 可选 块存储编码。长度为1或者Count
UserParas List< UserPara > 可选 用户自定义数据。长度为1或者Count
VLanIDs List< VLanID > 可选 虚拟网络唯一标识。长度为1或Count
VMNames List< VMName > 可选 虚拟机名称,长度为1或者Count
PrivateIPs List< PrivateIP > 可选 虚拟机私网IP列表,长度为Count
KeyNames List< KeyName > 可选 密钥名称,长度为1或者Count
SGIDs List< SGID > 可选 安全组唯一标识,长度为1或者Count
表5中,PrivateIP见表6。
表6 PrivateIP
字段名 类型 约束 说明
PrivateIP String 可选
虚拟机私网IP,用于标识虚拟机在弹性计算平台内的网络地
址,便于弹性计算平台进行管理和平台内部虚拟机之间的通
信,主要包括如下三个地址段:10.0.0.0~10.255.255.255,
b) 应答消息:CreateVMResp
应答消息见表7。
表7 应答消息
字段名 类型 约束 说明
VMInfoSet List< VMInfo > 必选 虚拟机信息集合
表7中,VMInfo见表8。
表8 VMInfo
字段名 类型 约束 说明
VMID String 必选 虚拟机唯一标识,由弹性计算平台分配
VMPassword String 可选
虚拟机管理员的随机口令,由弹性计算服务平台生成并返回给
用户
VlanID String 可选 虚拟网络唯一标识
PrivateIP String 可选 虚拟机私网IP
表8(续)
字段名 类型 约束 说明
AcceptTime String 可选 虚拟机受理时间:yyyy-mm-ddhh:nn:ss
VMName String 可选 用户自定义或者系统分配的虚拟机名称
VMState String 必选 虚拟机当前状态
6.3.3 启动虚拟机(StartVM)
6.3.3.1 接口功能
该接口启动处于创建完成或停止状态的一个或多个虚拟机。
如果操作成功,返回虚拟机状态信息列表;如果操作失败,应返回信息见表4。
6.3.3.2 接口消息
请求消息和应答消息如下:
a) 请求消息:StartVMReq
请求消息见表9。
表9 请求消息
字段名 类型 约束 说明
VMIDs List< VMID > 必选 虚拟机唯一标识列表
b) 应答消息:StartVMResp
应答消息见表10。
表10 应答消息
字段名 类型 约束 说明
VMStates List< VMStateChange > 必选 虚拟机当前状态
表10中,VMStateChange见表11。
表11 VMStateChange
字段名 类型 约束 说明
VMID String 必选 虚拟机唯一标识
VMState String 必选 虚拟机当前状态
6.3.4 停止虚拟机(StopVM)
6.3.4.1 接口功能
该接口停止处于运行状态的一个或多个虚拟机。
如果操作成功,返回虚拟机状态信息列表;如果操作失败,应返回信息见表4。
6.3.4.2 接口消息
请求消息和应答消息如下:
a) 请求消息:StopVMReq
请求消息见表12。
表12 请求消息
字段名 类型 约束 说明
VMIDs List< VMID > 必选 虚拟机唯一标识列表
b) 应答消息:StopVMResp
应答消息见表13。
表13 应答消息
字段名 类型 约束 说明
VMStates List< VMStateChange > 必选 虚拟机当前状态列表
表13中,VMStateChange见表14。
表14 VMStateChange
字段名 类型 约束 说明
VMID String 必选 虚拟机唯一标识
VMState String 必选 虚拟机当前状态
6.3.5 重启虚拟机(RestartVM)
6.3.5.1 接口功能
该接口重启处于运行状态的一个或多个虚拟机。
如果操作成功,返回虚拟机状态信息列表;如果操作失败,应返回信息见表4。
6.3.5.2 接口消息
请求消息和应答消息如下:
a) 请求消息:RestartVMReq
请求消息见表15。
表15 请求消息
字段名 类型 约束 说明
VMIDs List< VMID > 必选 虚拟机唯一标识列表
b) 应答消息:RestartVMResp
应答消息见表16。
表16 应答消息
字段名 类型 约束 说明
VMStates List< VMStateChange > 必选 虚拟机当前状态列表
表16中,VMStateChange见表17。
表17 VMStateChange
字段名 类型 约束 说明
VMID String 必选 虚拟机唯一标识
VMState String 必选 虚拟机当前状态
6.3.6 挂起虚拟机(SuspendVM)
6.3.6.1 接口功能
该接口挂起处于运行状态的一个或多个虚拟机。
如果操作成功,返回虚拟机状态信息列表;如果操作失败,应返回信息见表4。
本接口在公有云部署场景中可选。
6.3.6.2 接口消息
请求消息和应答消息如下:
a) 请求消息:SuspendVMReq
请求消息见表18。
表18 请求消息
字段名 类型 约束 说明
VMIDs List< VMID > 必选 虚拟机唯一标识列表
b) 应答消息:SuspendVMResp
应答消息见表19。
表19 应答消息
字段名 类型 约束 说明
VMStates List< VMStateChange > 必选 虚拟机当前状态列表
表19中,VMStateChange见表20。
表20 VMStateChange
字段名 类型 约束 说明
VMID String 必选 虚拟机唯一标识
VMState String 必选 虚拟机当前状态
6.3.7 恢复虚拟机(RestoreVM)
6.3.7.1 接口功能
该接口恢复处于挂起状态的一个或多个虚拟机。
如果操作成功,返回虚拟机状态信息列表;如果操作失败,应返回信息见表4。
本接口在公有云部署场景中可选。
6.3.7.2 接口消息
请求消息和应答消息如下:
a) 请求消息:RestoreVMReq
请求消息见表21。
表21 请求消息
字段名 类型 约束 说明
VMIDs List< VMID > 必选 虚拟机唯一标识列表
b) 应答消息:RestoreVMResp
应答消息见表22。
表22 应答消息
字段名 类型 约束 说明
VMStates List< VMStateChange > 必选 虚拟机当前状态列表
表22中,VMStateChange见表23。
表23 VMStateChange
字段名 类型 约束 说明
VMID String 必选 虚拟机唯一标识
VMState String 必选 虚拟机当前状态
6.3.8 删除虚拟机(DeleteVM)
6.3.8.1 接口功能
该接口删除一个或多个虚拟机。
如果操作成功,不返回任何信息;如果操作失败,应返回信息见表4。
6.3.8.2 接口消息
请求消息和应答消息如下:
a) 请求消息:DeleteVMReq
请求消息见表24。
表24 请求消息
字段名 类型 约束 说明
VMIDs List< VMID > 必选 虚拟机唯一标识列表
b) 应答消息:DeleteVMRes......
|