用Postman玩转服务器管理：Redfish接口实战12个场景（含BMC用户、BIOS设置）-二趣网

用Postman玩转服务器管理：Redfish接口实战12个场景（含BMC用户、BIOS设置）

当你面对一台需要紧急配置的服务器，或是深夜突然告警的硬件故障，是否曾希望有个像瑞士军刀般趁手的工具？Redfish协议正是这样一把钥匙——而Postman则是转动它的最佳手柄。本文将彻底改变你对Redfish的认知：它不仅是测试工程师的专属协议，更是运维人员日常管理的利器。通过12个真实场景，我们将把复杂的API调用转化为可复用的管理动作，让你用最熟悉的工具完成最棘手的服务器操作。

1. 从零搭建Redfish管理环境

1.1 Postman基础配置优化

在开始Redfish探险前，需要调整Postman的"武器参数"。关闭SSL验证只是第一步，更关键的是建立环境变量体系：

# 创建初始环境模板 { "deviceip": "BMC_IP", "X-Auth-Token": "", "ETag": "" }

建议：将常用请求保存到Postman的Collection时，采用[动作]_[对象]的命名规范，例如：

GET_SystemInfo
POST_CreateUser
PATCH_UpdateBIOS

1.2 认证机制深度解析

Redfish的会话管理比普通API更严谨。登录时注意这些细节：

POST /redfish/v1/SessionService/Sessions HTTP/1.1 Content-Type: application/json { "UserName": "admin", "Password": "YourComplexPassword" }

关键点：成功的响应会返回X-Auth-Token和Location头，前者用于后续认证，后者指向新建的会话资源。务必在Tests脚本中添加：

// 保存认证令牌 pm.globals.set("X-Auth-Token", pm.response.headers.get("X-Auth-Token"));

2. 服务器生命周期管理实战

2.1 智能电源控制矩阵

不同电源操作对应着不同的业务场景：

操作类型	ResetType值	适用场景	风险等级
正常关机	GracefulShutdown	计划维护	★☆☆☆☆
强制重启	ForceRestart	系统僵死	★★★☆☆
上电	On	首次部署	★☆☆☆☆
强制关机	ForceOff	紧急情况	★★★★☆

POST /redfish/v1/Systems/1/Actions/ComputerSystem.Reset HTTP/1.1 X-Auth-Token: {{X-Auth-Token}} { "ResetType": "ForceRestart" }

2.2 资产信息深度挖掘

获取系统信息不仅是查看SN号，更是硬件健康检查的第一步：

GET /redfish/v1/Systems/1 HTTP/1.1 X-Auth-Token: {{X-Auth-Token}}

重点关注响应中的这些字段：

ProcessorSummary/Count：物理CPU数量
MemorySummary/TotalSystemMemoryGiB：内存总量
PowerState：当前电源状态
Status/Health：整体健康状态

3. BMC用户管理体系精讲

3.1 用户增删改查全流程

创建用户时需要理解Redfish的权限模型：

POST /redfish/v1/AccountService/Accounts HTTP/1.1 X-Auth-Token: {{X-Auth-Token}} { "Id": "3", "UserName": "AuditAdmin", "Password": "SecureP@ssw0rd!", "RoleId": "Operator" }

注意：不同厂商的RoleId可能不同，常见值包括：

Administrator：完全控制
Operator：基础运维
ReadOnly：只读访问

3.2 用户信息更新陷阱

修改用户属性时必须遵循"先读后写"原则：

先获取用户当前ETag：

GET /redfish/v1/AccountService/Accounts/3 HTTP/1.1

使用返回的ETag进行条件更新：

PATCH /redfish/v1/AccountService/Accounts/3 HTTP/1.1 If-Match: {{ETag}} { "Password": "NewSecureP@ssw0rd!" }

踩坑提醒：部分厂商实现中，修改用户名可能需要先删除再创建，直接PATCH可能报错。

4. 网络配置与BIOS调优

4.1 BMC网络接口管理

获取网口信息时注意分页问题：

GET /redfish/v1/Managers/1/EthernetInterfaces HTTP/1.1

典型响应结构：

{ "Members": [ { "@odata.id": "/redfish/v1/Managers/1/EthernetInterfaces/1" } ], "Members@odata.count": 1 }

修改IP地址的原子操作：

PATCH /redfish/v1/Managers/1/EthernetInterfaces/1 HTTP/1.1 X-Auth-Token: {{X-Auth-Token}} { "IPv4Addresses": [ { "Address": "192.168.1.100", "SubnetMask": "255.255.255.0", "Gateway": "192.168.1.1" } ] }

4.2 BIOS设置高阶技巧

获取当前BIOS配置时注意：

GET /redfish/v1/Systems/1/Bios HTTP/1.1

修改启动顺序的典型payload：

{ "Attributes": { "BootMode": "Uefi", "BootOrder": ["HardDisk", "PXE", "CDROM"], "SecureBoot": true } }

实战经验：某些服务器需要先进入"BIOS配置模式"才能修改参数，这需要额外发送：

POST /redfish/v1/Systems/1/Bios/Settings HTTP/1.1 { "@Redfish.OperationApplyTime": "OnReset" }

5. 异常处理与调试技巧

当API返回4xx/5xx错误时，建议检查清单：

确认X-Auth-Token未过期（通常20-30分钟有效期）
验证请求URL是否包含正确的资源ID（如Systems/1 vs Systems/2）
检查ETag是否最新（针对修改操作）
查看响应体中的@Message.ExtendedInfo获取详细错误

// 在Postman Tests中添加错误诊断 pm.test("Status code is 200", function() { if (pm.response.code !== 200) { console.log("Error details: ", JSON.stringify(pm.response.json(), null, 2)); } pm.response.to.have.status(200); });

6. 自动化运维集成方案

将Postman集合转换为可执行脚本：

# 使用Newman运行集合 newman run Redfish_Operations.postman_collection.json \ --env-var deviceip=192.168.1.100 \ --env-var username=admin \ --env-var password=initialP@ss

进阶技巧：结合Jenkins实现定时健康检查：

pipeline { agent any stages { stage('硬件检查') { steps { script { def result = sh(script: 'newman run HardwareCheck.json', returnStatus: true) if (result != 0) { slackSend channel: '#alerts', message: '硬件健康检查失败！' } } } } } }

在真实运维中，我曾用这套方法在30分钟内完成了50台服务器的BIOS固件批量升级。关键是把每个Redfish操作封装成独立请求，然后通过环境变量控制目标设备。当需要批量操作时，只需写个简单循环调用这些请求即可。

企业官网建设流程全解析