ICS35.100.05 L79 中华人民共和国国家标准 GB/T31915—2015 信息技术 弹性计算应用接口 Informationtechnology—Elasticcomputingapplicationinterface 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/T31915—2015 前 言 本标准按照GB/T1.1—2009给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本标准由全国信息技术标准化技术委员会(SAC/TC28)提出并归口。 本标准起草单位:中国移动通信有限公司研究院、华为技术有限公司、中国电子技术标准化研究 院、浪潮(北京)电子信息产业有限公司、东软集团股份有限公司、上海计算机软件技术开发中心、深圳市 金蝶中间件有限公司、阿里云计算有限公司、中兴通讯股份有限公司、中标软件有限公司、用友软件股份 有限公司、北京华胜天成科技股份有限公司、北京航空航天大学。 本标准主要起草人:段翔、李海波、寇欣、余祥、王洁萍、唐廷芳、陈岭、颜秉珩、何光宇、蔡立志、 林琳、李战园、楚俊生、安宁、胡捷、白占来、田忠、秦习庆、王国伟、赵江、梁钢、赵海、陈志峰、杨丽蕴、 王卫国、丛培勇。 ⅠGB/T31915—2015 信息技术 弹性计算应用接口 1 范围 本标准给出了弹性计算体系结构,规定了弹性计算应用接口通用要求和接口定义。 本标准适用于弹性计算应用接口的设计、开发和服务提供。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文 件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。 GB/T7408—2005 数据元和交换格式 信息交换 日期和时间表示法 RFC2616 超文本传输协议[HypertextTransferProtocol(HTTP)1.1Specification] 3 术语、定义和缩略语 3.1 术语和定义 下列术语和定义适用于本文件。 3.1.1 虚拟机 virtualmachine 一种虚拟的数据处理系统,它看起来是在某个特定用户的独占使用下,但其功能是通过共享真实数 据处理系统的各种资源得以实现的。 [GB/T5271.1—2000,定义01.01.50] 3.1.2 虚拟机镜像 virtualmachineimage 虚拟机对应的文件系统镜像,包括操作系统及虚拟机运行需要的软件。 3.1.3 虚拟机模板 virtualmachinetemplate 配置虚拟机所需的元数据集合,包括CPU数量、内存大小和磁盘大小等。 注:虚拟机模板用于方便地生成虚拟机。 3.1.4 安全组 securitygroup 防火墙规则的集合。 3.2 缩略语 下列缩略语适用于本文件。 HTTP 超文本传输协议(HyperTextTransferProtocol) ID 标识符(Identifier) LB 负载均衡(LoadBalance) SSH 安全外壳协议(SecureShell) 1GB/T31915—2015 URL 统一资源定位符(UniversalResourceLocator) VM 虚拟机(VirtualMachine) 4 弹性计算体系结构 弹性计算体系结构如图1所示。 图1 弹性计算体系结构 弹性计算是指以按需、动态可伸缩、多租户的方式为用户提供虚拟主机及其空间等相关资源的租赁 服务的计算模式。弹性计算体系结构包括3个部分:服务层、接口层和应用层。服务层是由弹性计算服 务提供商提供的用于虚拟机及相关资源管理的各类服务的总称。接口层定义了不同弹性计算服务均应 遵循的统一接口。应用层包括各类信息系统。 5 弹性计算应用接口通用要求 5.1 概述 弹性计算应用接口通用要求规定了弹性计算服务所使用的数据类型、接口协议。 5.2 数据类型 5.2.1 日期与时间表示 日期和时间表示包括以下两个部分: a) 日期与时间 日期与时间的表示应遵循GB/T7408—2005,具体见表1。 表1 日期与时间的表示 日期/时间 表示 年 yyyy 月 mm 日 Dd 2GB/T31915—2015 表1(续) 日期/时间 表示 时 hh(24小时制) 分 nn 秒 ss b) 日期与时间分隔符 日期与时间分隔符的表示应遵循GB/T7408—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。 3GB/T31915—2015 表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)安全组管理接口 包括安全组的创建、删除和查询,