RedfishWhitePaperRedfish白皮书

Redfish White Paper

Redfish 白皮书

1

目录

什么是Redfish API？4

1.为什么需要新的接口？4

2.为什么采用 REST、JSON 和 OData? 5

3.为什么采用超媒体 API? 6

入门7

4.访问实现7

5.根8

基本概念8

6.操作9

7.版本控制9

8.引用 10

9.主要的对象 10

10.集合 11

11.公共属性 11

12.常见注释 12

13.动作 13

14.模式 13

更多概念 13

15.会话 14

冗余 15

17.相关项目 16

18.服务 16

19.注册表 17

20.报文头 17

21.ETag 17

21.1 处理客户端竞态条件 18

22.更新资源 18

2

22.1 PUT vs PATCH 19

22.2 当前的配置vs 设置 19

22.3 确定可以被更新的属性 19

23.扩展的错误响应 20

24.事件 20

25.创建用户帐户和其他资源 21

26.消息对齐 21

27.Oem 21

28.幂等(Idempotency) 22

28.1 幂等修改：GET/PUT/PATCH 22

28.2 创建、使用、删除：POST/GET/DELETE (非幂等性) 22

28.3 做动作：用 “Action”属性(非幂等性) POST 23

结论 23

常见用例 23

29.查找系统的温度传感器 23

30.壳中壳 24

3

什么是Redfish API？

Redfish 是一种管理标准，它使用超媒体RESTful 接口的数据模型表示

法。此模型以标准的机器可读模式表示，其消息负载以JSON 来表示。协议本身

利用了OData v4 版本。Redfish API 是超媒体API，可通过统一的接口来表示

各种实现。Redfish API 提供数据中心资源管理、事件处理、长时间任务以及

发现等机制。

1.为什么需要新的接口？

各种影响导致需要新的标准管理接口。

首先，市场正在从传统的数据中心环境向可扩展的解决方案转变。可扩

展解决方案以及超大规模采取分布式方式(而非集中式)，即由大量简单的服务

器共同执行一组任务。在这样的环境中，可靠性是通过自有软件或开源软件来

实现的。因此，使用模型不同于传统的企业环境。一个形象的比喻就是把服务

器作为 “牲畜”，而不是 “宠物”对待。这种客户环境需要标准化的接口，以

便在异构的多供应商环境中实现一致性。

目前的扩展管理缺少功能性和同构接口。例如，IPMI 功能的使用仅限于

“最小公分母”命令(如 Power On/Off/Reboot、temperature value、text console)。

因此，需要带外功能的客户无法使用完整的功能，因为供应商扩展未实现跨平

台通用。此类新客户开始开发越来越多的自己的工具，以实现紧密集成，因为

具备开发公共可管理功能的能力，他们有时会通过带内软件来实现管理功能。

平台管理规范随着OEM 扩展增多逐渐变得零散，致使管理功能无法满足零散客

户的扩展性需求。另外，现有管理解决方案已无法通过引用特定的安全和加密

需求来满足客户的安全需求。

其他标准 (如SMASH)无法实现通用性要求。这是由其复杂性决定的。

CLP 最终得以在大多数硬件中实现，但由于不支持统一的输出格式，解析结果

数据要依赖于实现方式。WS 管理只能在有限的带外环境中实现。WS 管理是复杂

4

的分层协议，最适用于同构环境，而无法满足异构要求。另外，此接口的实现

非常复杂，涉及对协议的了解、通用操作、模式、概要文件本身等一系列问题，

历时多年开发、调整并添加了新功能的解决方案即体现了这一复杂性。客户需

要花几个月的时间来熟悉接口，了