QGDW-11419-2015-信息系统软硬件资源池资源调度接口规范

ICS29.240

Q/GDW

国家电网公司企业标准

Q/GDW11419—2015

信息系统软硬件资源池资源调度

接口规范

SpecificationofResourceSchedulingInterfaceforInformationSystem

SoftwareandHardwareResourcePool

2016-03-31发布2016-03-31实施

国家电网公司发布

1

Q/GDW11419—2015

信息系统软硬件资源池资源调度接口规范

1范围

本标准规定了国家电网公司信息系统软硬件资源池资源调度的参考模型，界定了不同资源的接入接

口，并规定了资源的服务接口。

本标准适用于国家电网公司信息系统软硬件资源池的IT基础设施软硬件资源及云计算资源管理平

台的规划、设计、建设、开发、使用和维护等相关过程。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。

凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GB/T5271.1信息技术词汇第1部分：基本术语

Q/GDW1932基于云计算的资源描述和交换管理规范

Q/GDW11418信息系统软硬件资源池硬件资源准入规范

ISO/IEC17788—2014信息技术云计算概述和词汇（Informationtechnology--Cloudcomputing--

Overviewandvocabulary）

3术语和定义

GB/T5271.1、Q/GDW1932、Q/GDW11418和ISO/IEC17788—2014界定的以及下列术语和定义适

用于本文件。

3.1

资源接入接口resourceaccessinterface

资源与资源调度模块之间的接口。

3.2

资源服务接口resourceserviceinterface

资源调度模块发布的、供用户层和访问层调用的接口。

3.3

X86宿主机X86hostmachine

安装了虚拟化软件的X86架构服务器，用于承载多台X86虚拟机。

3.4

X86物理机X86physicalmachine

X86架构服务器。本标准中特指未安装虚拟化软件的X86架构服务器。

3.5

集群cluster

一组连接起来的计算机，它们共同工作，对外界来说就像一台计算机一样。集群一般由局域网连接，

用于单台计算机无法完成的高性能或高可靠计算。

3.6

节点node

集群中的单台计算机。

1

Q/GDW11419—2015

3.7

虚拟交换机virtualswitch

虚拟化宿主机内部实现的软件交换机，用于桥接宿主机内部虚拟机和外部物理网络的流量。

3.8

分布式虚拟交换机distributedvirtualswitch

虚拟化宿主机内部实现的软件交换机，可以跨一组宿主机实现桥接内部虚拟机和外部物理网络的流

量。

3.9

端口组portgroup

一组虚拟机如何通过虚拟交换机连接外部网络，例如每个虚拟机端口的带宽限制、VLAN标签策略。

一般一个虚拟交换机可以关联多个端口组。

4缩略语

下列缩略语适用于本文件。

ASN.1：抽象语法标记（AbstractSyntaxNotationOne）

CLI：命令行接口（Command-LineInterface）

CPU：中央处理器（CentralProcessingUnit）

DNS：域名系统（DomainNameSystem）

ID：唯一编码（Identifier）

JSON：一种轻量级的数据交换格式（JavaScriptObjectNotation）

LUN：逻辑单元号（LogicalUnitNumber）

MAC：介质访问控制（MediaAccessControl）

MEM：内存（Memory）

NAS：网络附加存储（NetworkAttachedStorage）

NAT：网络地址翻译（NetworkAddressTranslation）

RAID：独立冗余磁盘阵列（RedundantArraysofInexpensiveDisks）

REST：表述性状态传递（RepresentationalStateTransfer）

SAN：存储区域网络（StorageAreaNetwork）

SMI-S：存储管理接口标准（StorageManagementInitiativeSpecification）

SNMP：简单网络管理协议（SimpleNetworkManagementProtocol）

SNMPOID：用一种层次化格式组织的、以树状结构中的唯一地址来表示的寻址方式（SimpleNetwork

ManagementProtocolObjectIdentifiers）

Tools：虚拟化平台的增强工具

UUID：通用唯一识别码（UniversallyUniqueIdentifier）

VCPU：虚拟中央处理器（VirtualCentralProcessingUnit）

VLAN：虚拟局域网（VirtualLocalAreaNetwork）

VLANID：虚拟局域网标识（VirtualLocalAreaNetworkIdentity）

VM：虚拟机（VirtualMachine）

VMEM：虚拟内存（VirtualMemory）

WWN：全球唯一名字（WorldWideName）

XML：可扩展标记语言（ExtensibleMarkupLanguage）

ZONE：将连接在SAN网络中的设备（主机和存储），逻辑上划分到不同的区域内，使得不同区域

中的设备相互间不能通过网络直接访问，从而实现网络中设备之间的相互隔离。

2

Q/GDW11419—2015

5资源调度参考模型

5.1参考模型

本标准提出信息系统软硬件资源池的资源调度参考模型，如图1所示。该模型描述不用来表示任何

特定的技术实现。

用户层

访问层

②②②

服务层资源调度模块

①①①

资源层资源1资源2…….资源N

注1：①资源接入接口。

注2：②资源服务接口。

图1资源调度参考模型

本模型参考ISO/IEC17789—20147.3中对云计算的分层方式，将资源调度模型分为4层，分别为资

源层、服务层、访问层、用户层，对每个层次的描述如下：

资源层由多个不同种类的资源设备组成。资源设备需满足Q/GDW11418中对资源准入的要求，并

按照一定的架构设计要求构成一个资源池。

服务层由资源调度模块组成，对资源调度模块功能的描述见5.2。

访问层和用户层的定义参见ISO/IEC17789—20147.3中对访问层（AccessLayer）和用户层（User

Layer）的定义。

本标准中所规定的接口包括以下两部分：

a）资源接入接口：指的是资源发布的，供资源调度模块调用的接口。对资源接入接口的具体要求

见第7章；

b）资源服务接口：指的是资源调度模块发布的、供用户层和访问层调用的接口。对资源服务接口

具体要求见第8章。

5.2资源调度模块

资源调度模块的基本功能如图2所示，该功能描述不用来表示任何特定的技术实现。

3

Q/GDW11419—2015

资源调度模块

服务接口发布

服务目录

服务定义策略定义

服务编排策略计算

任务调度

资源适配器与驱动

接口适配器接口适配器接口适配器

图2资源调度模块基本功能

资源调度模块实现软硬件资源池环境中异构IT基础设施资源调度，并通过服务编排和策略计算的

能力，将资源封装成服务进行供应。资源调度模块的基本功能包括以下几个方面：

a）服务目录：服务目录以业务语言描述软硬件资源池可以提供的资源服务内容，以统一的形式发

布给最终用户使用，向用户展现可申请的服务产品；

b）服务定义：服务定义实现对服务目录具体构成的描述，包括资源的种类、规格、连接关系、配

置等，以及服务的非功能性需求，如可靠性、服务级别等；

c）服务编排：根据服务定义，将服务需求解析成对资源的一系列操作指令，并将操作指令发送给

资源适配与驱动功能处理，操作指令执行的过程由任务调度功能进行控制。服务编排的过程中，

可能需要调用策略计算的结果；

d）策略定义：策略用来描述资源的选择偏好，如能耗最低策略、均匀分布策略等；

e）策略计算：根据策略定义，在响应具体的服务需求时，从资源集合中定位到具体的资源位置。

策略计算的算法通常由服务编排功能来调用，并将计算结果返回给服务编排功能；

f）任务调度：对资源操作指令的执行过程进行管理；

g）资源适配与驱动：本功能由一系列的接口适配器组成，每个接口适配器对应一类资源。接口适

配器模型见5.3；

h）服务接口发布：对外发布经过编排后的资源服务接口，供用户层、访问层或第三方平台调用。

5.3接口适配器

在软硬件资源池环境中，资源通常呈现出异构性特征，同一类资源可能因为品牌和型号的不同而导

致接口协议和格式上的差异。接口适配器负责将同一类资源的接入接口转换为统一的格式。

本标准提出接口适配器的模型，如图3所示，模型定义了接口适配器的基本组成结构，但并不用来

表示任何特定的技术实现。

每个接口适配器由声明和驱动两部分组成。其中，声明部分对接口的业务语义、调用路径和输出格

式进行定义，驱动部分实现资源接入接口的调用动作，并将资源接入接口返回的输出信息按照声明中要

求的格式进行转义。

4

Q/GDW11419—2015

接口适配器

声明

驱动

输入输入

资源接入接口提供方

图3接口适配器模型

6接口概述

6.1接口通用要求

本标准对信息系统软硬件资源池资源调度所需要的资源接入接口和资源服务接口进行规范。第7章

对资源接入接口的接口功能、参数和返回值进行了详细描述；第8章对资源服务接口的接口功能、参数

和返回值进行了详细描述；附录A给出了接口中所使用到的数据类型定义；附录B给出了接口调用和

执行过程中的错误码定义；附录C给出了接口调用示例。

本标准中对接口的通用要求如下：

a）资源接入接口可由资源设备配套的管理软件提供，也可由资源设备本身提供，资源发布的接口

应满足本标准定义的资源接入接口的功能要求；

b）由资源设备配套管理软件提供的资源接入接口应基于REST格式或SOAP协议，由资源设备本

身提供的资源接口接入可基于REST格式、SOAP协议或CLI方式；

c）本标准对资源接入接口的功能、输入/输出参数的内容进行了要求，但不限定接口的具体命名、

参数的具体命名和排列顺序；

d）当资源发布的接口与本标准中所定义的资源接入接口在接口名称、参数个数、参数数据类型、

参数选项等方面不一致时，应提供专门的文档，说明所提供的接口与本标准中所定义接口的映

射关系或扩展关系；

e）资源服务接口应基于REST格式；

f）接口的输出应是自解析格式，例如JSON格式或XML格式；

g）对于“是否必选”选项是“否”的参数，表示接口不必支持该参数；

h）在执行本标准时，错误码可根据实际需求进行扩展；

i）如果资源接入接口提供方给出的错误码编码方式与本标准定义的错误码不同，需提供专门的文

档说明错误码之间的对应关系；

j）在执行本标准时，如需对接口功能进行扩展，应提供说明文档。

6.2接口调用过程

在调用其他接口前应调用认证接口获取认证信息。图4给出了调用接口的一般过程。

7资源接入接口

7.1资源接入接口分类

根据接入的资源种类的不同，将资源接入接口分为以下三类：

a）计算资源接入接口：计算类资源的接入接口，例如X86虚拟机、X86物理机等；

5

Q/GDW11419—2015

开始

调用认证接口

失败

认证接口调用返回接口调用失败

是否成功错误码，见附录B.1

成功

认证失败

返回认证失败错误

是否成功码，见附录B.2

成功

获取认证信息供

后续接口使用

调用具体功能

对应的接口

失败

接口调用返回接口调用失败

是否成功错误码，见附录B.1

成功

成功接口执行失败返回接口执行失败

输出信息

是否成功错误码，见附录B.3

结束结束

图4接口调用过程

b）存储资源接入接口：存储类资源的接入接口，例如LUN、光纤交换机等；

c）网络资源接入接口：网络类资源的接入接口，例如交换机、负载均衡设备等。

7.2计算资源接入接口

7.2.1X86宿主机

查询指定X86宿主机信息

接口功能：查询指定X86宿主机的信息，包括状态、CPU、内存、存储、与集群和X86虚拟机的

关联关系等。

参数说明见表1。

表1查询指定X86宿主机信息接口参数说明

参数名称数据类型传递是否必选描述

X86宿主机在虚拟化平台的唯一标识。

X86宿主机IDSTRING输入是在使用该接口时，本参数和“X86宿主机名称”

至少有一个。

X86宿主机挂载在虚拟化平台中的名字。

X86宿主机名称STRING输入是在使用该接口时，本参数和“X86宿主机ID”

至少有一个。

6

Q/GDW11419—2015

表1（续）

参数名称数据类型传递是否必选描述

本参数为指定含义的字符串，字符串选项及对

应的解释如下：

rebooting：重启中

normal：正常

SELECTED_STRfault：故障

X86宿主机状态输出是

INGinitial：初始化

unknown：未知

poweroff：关机

booting：启动中

shutdowning：关闭中

X86宿主机厂商STRING输出否服务器的厂商。

X86宿主机型号STRING输出否服务器的型号。

X86宿主机总内存容量NUMBER输出是X86宿主机内存总容量（单位：MB）。

X86宿主机VCPU数量INTEGER输出是X86宿主机VCPU数量（单位：核）。

X86宿主机物理CPU

INTEGER输出是X86宿主机物理CPU数量（单位：核）。

数量

X86宿主机CPU主频NUMBER输出是X86宿主机的CPU主频（单位：MHz）。

X86宿主机存储挂载名X86宿主机中已经挂载存储名称，若无挂载存

STRING[]输出是

称储则此字段为NULL。

X86宿主机中已经挂载存储总容量，若无挂载

X86宿主机存储总容量NUMBER输出是

存储则此字段为NULL。

X86宿主机所属集群名称，可选字段。若X86

X86宿主机所属集群信

STRING输出是宿主机直接位于虚拟化平台下则此字段为

息

NULL。

X86宿主机下运行的虚

STRING[]输出是列出X86宿主机下运行的虚拟机名称。

拟机信息

接口执行成功，返回INTERFACE_

EXCUTION_SUCESS

返回值STRING返回—接口执行失败，返回错误码，包括：

111001：X86宿主机ID不存在

111002：X86宿主机名称不存在

查询X86宿主机资源使用情况

接口功能：查询X86宿主机的CPU、内存、存储等资源的使用情况。

参数说明见表2。

表2查询X86宿主机资源使用情况接口参数说明

参数名称数据类型传递是否必选描述

X86宿主机在虚拟化平台的唯一标识。

X86宿主机IDSTRING输入是在使用该接口时，本参数和“X86宿主机名称”

至少有一个。

7

Q/GDW11419—2015

表2（续）

参数名称数据类型传递是否必选描述

X86宿主机挂载在虚拟化平台中的名字。

X86宿主机名称STRING输入是在使用该接口时，本参数和“X86宿主机ID”

至少有一个。

X86宿主机总内存

NUMBER输出是X86宿主机总内存数量（单位：MB）。

容量

X86宿主机已分配内

NUMBER输出是X86宿主机已分配内存数量（单位：MB）。

存容量

X86宿主机总CPU主

NUMBER输出是X86宿主机总CPU主频（单位：MHz）。

频

X86宿主机已分配

NUMBER输出是X86宿主机已分配CPU主频（单位：MHz）。

CPU主频

X86宿主机挂载总存X86宿主机中已挂载的总存储数量（单位：

NUMBER输出是

储容量GB），若无挂载存储则此字段为NULL。

X86宿主机挂载存储已挂载存储中的已经分配存储数量（单位：

NUMBER输出是

已分配容量GB），若无挂载存储则此字段为NULL。

接口执行成功，返回INTERFACE_

EXCUTION_SUCESS

返回值STRING返回—接口执行失败，返回错误码，包括：

111001：X86宿主机ID不存在

111002：X86宿主机名称不存在

添加共享存储

接口功能：给指定的X86宿主机添加共享存储。

参数说明见表3。

表3添加共享存储接口参数说明

参数名称数据类型传递是否必选描述

X86宿主机在虚拟化平台的唯一标识。

X86宿主机IDSTRING输入是在使用该接口时，本参数和“X86宿主机名称”

至少有一个。

X86宿主机挂载在虚拟化平台中的名字。

X86宿主机名称STRING输入是在使用该接口时，本参数和“X86宿主机ID”

至少有一个。

本参数为指定含义的字符串，字符串选项及对

应的解释如下：

存储器类型SELECTED_STRING输入是

san：SAN存储类型

nas：NAS存储类型

存储资源管理IPSTRING输入是存储资源设备管理IP地址。

存储文件的磁盘或分区类型，本参数为指定含

义的字符串，字符串选项及对应的解释如下：

文件系统类型SELECTED_STRING输入否FAT：FileAllocationTable文件配置表

NTFS：NewTechnologyFileSystem新技术文

件系统

8

Q/GDW11419—2015

表3（续）

参数名称数据类型传递是否必选描述

CDFS：光盘文件系统

exFAT：扩展文件分配表

RAW：未格式化的磁盘

Ext2：第二代扩展文件系统

Ext3：第三代扩展文件系统

Ext4：第四代扩展文件系统

Btrfs：ButterFS

ZFS：ZettabyteFileSystem动态文件系统

HFS：HierarchicalFileSystem分层文件系统

文件系统类型SELECTED_STRING输入否

HFS+：HierarchicalFileSystemExtended扩展

分层文件系统

ReiserFS：新型linux文件系统

JFS:JournalFileSystem字节级日志文件系统

VMFS：VMwareVirtualMachineFileSystem

高性能的群集文件系统

XFS：高性能的日志文件系统

UFS：UNIX文件系统

VXFS：Veritas文件系统

ReFS：ResilientFileSystem弹性文件系统

本参数为指定含义的字符串，字符串选项及对

应的解释如下：

是否需要格式化

SELECTED_STRING输入否1：格式化磁盘

磁盘

0：不格式化磁盘

默认为0

磁盘名称STRING输入是指定该存储在文件系统中显示的磁盘名称。

存储容量NUMBER输入是添加的存储容量（单位GB）。

接口执行成功，返回INTERFACE_

EXCUTION_SUCESS

接口执行失败，返回错误码，包括：

111001：X86宿主机ID不存在

返回值STRING返回—111002：X86宿主机名称不存在

112001：存储资源已存在

112002：存储资源管理IP不可达

112003：容量分配超过可分配空间最大值

112004：存储类型错误

删除共享存储

接口功能：删除指定X86宿主机的共享存储。

参数说明见表4。

9

Q/GDW11419—2015

表4删除共享存储接口参数说明

参数名称数据类型传递是否必选描述

X86宿主机在虚拟化平台的唯一标识。

X86宿主机IDSTRING输入是在使用该接口时，本参数和“X86宿主机名称”

至少有一个。

X86宿主机挂载在虚拟化平台中的名字。

X86宿主机名称STRING输入是在使用该接口时，本参数和“X86宿主机ID”

至少有一个。

存储名称STRING输入是待删除的共享存储名称。

接口执行成功，返回INTERFACE_

EXCUTION_SUCESS

接口执行失败，返回错误码，包括：

111001：X86宿主机ID不存在

返回值STRING返回—

111002：X86宿主机名称不存在

112005：存储资源正在使用中，无法删除

112006：输入参数非法

153011：存储名称不存在

创建虚拟交换机

接口功能：给指定的X86宿主机创建虚拟交换机。

参数说明见表5。

表5创建虚拟交换机参数说明

参数名称数据类型传递是否必选描述

X86宿主机在虚拟化平台的唯一标识。

X86宿主机IDSTRING输入是在使用该接口时，本参数和“X86宿主机名称”

至少有一个。

X86宿主机挂载在虚拟化平台中的名字。

X86宿主机名称STRING输入是在使用该接口时，本参数和“X86宿主机ID”

至少有一个。

待创建的虚拟交换机或分布式虚拟交换机的

虚拟交换机名称STRING输入是

名称。

指定虚拟交换机的类型，本参数为指定含义的

字符串，字符串选项及对应的解释如下：

虚拟交换机类型SELECTED_STRING输入是

1：标准虚拟交换机

2：分布式虚拟交换机

端口组名称STRING输入否虚拟交换机中端口组名称。

虚拟交换机中端口组对应的VLANID，范围

VLANIDINTEGER输入否

是1—4094。

绑定宿主机网络适

STRING输入是指定交换机中使用的物理上联网卡。

配器

接口执行成功，返回INTERFACE_

EXCUTION_SUCESS

返回值STRING返回—

接口执行失败，返回错误码，包括：

111001：X86宿主机ID不存在

10

Q/GDW11419—2015

表5（续）

参数名称数据类型传递是否必选描述

111002：X86宿主机名称不存在

113002：虚拟交换机名称已存在

返回值STRING返回—

113003：输入VLAN参数不合法，应为1-4094

113004：重复的端口组名称

删除虚拟交换机