SecureBoot
更新时间： 2026/10/28
在AtomGit上查看源码ResourceDefinition
uris
/redfish/v1/Systems/system_id/SecureBoot
properties
| 名称 | 类型 | 是否只读 | 取值范围/枚举值 | 说明 |
|---|---|---|---|---|
| @odata.context | string | true | - | 安全启动资源的OData描述 |
| @odata.id | string | true | - | 安全启动资源的访问路径 |
| @odata.type | string | true | - | 安全启动资源的类型 |
| Id | string | true | - | 安全启动资源的ID |
| Name | string | true | - | 安全启动资源的名称 |
| Actions { | object | true | - | Redfish允许的安全启动资源可执行操作 |
| Actions.#SecureBoot.ResetKeys { | object | true | - | 重置密钥操作 |
Actions.#SecureBoot.ResetKeys.ResetKeysType@Redfish.AllowableValues[ ] | array | true | - | 重置密钥操作支持的类型 |
| Actions.#SecureBoot.ResetKeys.target | string | true | - | 操作路径 |
| } | ||||
| } | ||||
| Description | string | true | - | 安全启动资源的描述 |
| SecureBootDatabases { | object | true | - | 安全启动数据库集合的链接 |
SecureBootDatabases.@odata.id | string | true | - | SecureBootDatabases资源的访问路径 |
| } |
supported_methods
- GET
- POST
HTTP methods
GET
命令功能
查询安全启动资源信息
命令格式
URL: https://device_ip/redfish/v1/Systems/system_id/SecureBoot
请求头:
text
X-Auth-Token: 123456789***********************请求消息体: 无
参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| device_ip | 登录设备的IP地址 | IPv4或IPv6地址 |
| system_id | 系统资源的ID | 参见源文件参数说明 |
| auth_value | 请求消息的鉴权参数 | 可通过/redfish/v1/SessionService/Sessions创建会话时获得 |
使用指南
无
使用实例
请求样例：
http
GET <https://device_ip/redfish/v1/Systems/system_id/SecureBoot>X-Auth-Token: 123456789***********************
请求消息体：无
响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#SecureBoot.SecureBoot",
"@odata.id": "/redfish/v1/Systems/1/SecureBoot",
"@odata.type": "#SecureBoot.v1_1_2.SecureBoot",
"Id": "SecureBoot",
"Name": "Secure Boot",
"Description": "Secure Boot",
"Actions": {
"#SecureBoot.ResetKeys": {
"ResetKeysType@Redfish.AllowableValues": [
"ResetAllKeysToDefault",
"DeleteAllKeys"
],
"target": "/redfish/v1/Systems/1/SecureBoot/Actions/SecureBoot.ResetKeys"
}
},
"SecureBootDatabases": {
"@odata.id": "/redfish/v1/Systems/1/SecureBoot/SecureBootDatabases"
}
}响应码：200
POST (ACTION)
ResetKeys
命令功能
管理安全启动证书资源
说明
重置BIOS安全启动证书表示配置已下发，但尚未生效，将在下次系统重启时生 效；系统启动过程中无法重置证书。
命令格式
URL: https://device_ip/redfish/v1/Systems/system_id/SecureBoot/Actions/SecureBoot.ResetKeys
请求头:
text
X-Auth-Token: 123456789***********************
Content-Type: header_type请求消息体:
json
{
"ResetKeysType": "resetkeys_type"
}请求头参数说明
参见 请求头参数说明
请求体参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| system_id | 管理资源ID | ● 针对机架服务器，取值为1 ● 针对高密服务器，取值为 BladeN（N表示节点槽位号），例如“Blade1” ● 针对刀片服务器，取值可以为 BladeN（N表示计算节点槽位号）或SwiN（N表示交换模块槽位号），例如“Swi1” |
| resetkeys_type | 重置类型 | 支持的类型包括： ● DeleteAllKeys：删除对应类型所有证书吊销列表 ● ResetAllKeysToDefault：恢复对应类型的证书吊销列表到默认值 说明：当参数为ResetAllKeysToDefault 时，如果没有相关初始证书，则该操作等同于DeleteAllKeys。初始证书的支持情况请参考对应机型的《BIOS参数参考》 |
使用指南
无
使用实例
请求样例：
http
POST <https://device_ip/redfish/v1/Systems/system_id/SecureBoot/Actions/SecureBoot.ResetKeys>X-Auth-Token: 123456789*********************** Content-Type: header_type
请求消息体：
json
{
"ResetKeysType": "resetkeys_type"
}响应样例：
json
{
"error ": {
"code ": "Base.1.0.GeneralError",
"message ": "A general error has occurred. See ExtendedInfo for more information.",
"@Message.ExtendedInfo ": [
{
"@odata.type ": "#Message.v1_0_0.Message",
"MessageId ": "Base.1.0.Success",
"RelatedProperties ": [],
"Message ": "Successfully Completed Request",
"MessageArgs ": [],
"Severity ": "OK",
"Resolution ": "None"
}
]
}
}响应码：200