SecureBootDatabases
更新时间： 2026/10/28
在AtomGit上查看源码ResourceDefinition
uris
/redfish/v1/Systems/system_id/SecureBoot/SecureBootDatabases/database_id
properties
| 名称 | 类型 | 是否只读 | 取值范围/枚举值 | 说明 |
|---|---|---|---|---|
| @odata.context | string | true | - | 安全启动数据库资源的OData描述 |
| @odata.id | string | true | - | 安全启动数据库资源资源的访问路径 |
| @odata.type | string | true | - | 安全启动数据库资源的类型 |
| Id | string | true | - | 安全启动数据库资源的ID |
| Name | string | true | - | 安全启动数据库资源的名称 |
| Description | string | true | - | 安全启动数据库资源的描述 |
| Actions { | object | true | - | Redfish允许的安全启动数据库资源可执行操作 |
| Actions.#SecureBootDatabase.ResetKeys { | object | true | - | 重置密钥操作 |
Actions.#SecureBootDatabase.ResetKeys.ResetKeysType@Redfish.AllowableValues[ ] | array | true | - | 重置密钥操作支持的类型 |
| Actions.#SecureBootDatabase.ResetKeys.target | string | true | - | 操作路径 |
| } | ||||
| } | ||||
| Certificates { | object | true | - | 安全启动数据库中包含的证书集合的链接 |
Certificates.@odata.id | string | true | - | Certificates资源资源的访问路径 |
| } | ||||
| DatabaseId | string | true | - | 安全启动数据库的名称 |
supported_methods
- GET
- POST
HTTP methods
GET
命令功能
查询安全启动数据库资源信息
命令格式
URL: https://device_ip/redfish/v1/Systems/system_id/SecureBoot/SecureBootDatabases/database_id
请求头:
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/SecureBootDatabases/database_id>X-Auth-Token: 123456789***********************
请求消息体：无
响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#SecureBootDatabase.SecureBootDatabase",
"@odata.id": "/redfish/v1/Systems/1/SecureBoot/SecureBootDatabases/db",
"@odata.type": "#SecureBootDatabase.v1_0_3.SecureBootDatabase",
"Id": "db",
"Name": "SecureBootDatabase",
"Actions": {
"#SecureBootDatabase.ResetKeys": {
"target": "/redfish/v1/Systems/1/SecureBoot/SecureBootDatabases/db/Actions/SecureBootDatabase.ResetKeys",
"ResetKeysType@Redfish.AllowableValues": [
"ResetAllKeysToDefault",
"DeleteAllKeys"
]
}
},
"DatabaseId": "db",
"Description": "SecureBootDatabase",
"Certificates": {
"@odata.id": "/redfish/v1/Systems/1/SecureBoot/SecureBootDatabases/db/Certificates"
}
}响应码：200
POST (ACTION)
ResetKeys
命令功能
管理安全启动数据库中的安全启动证书资源
说明
重置BIOS安全启动证书表示已下发的配置，但当前还未生效，下次系统重启时生 效；系统启动过程中无法重置证书。
命令格式
请求头:
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” |
| database_id | 安全启动数据库类型 | 可取值db、dbx |
| resetkeys_type | 重置类型 | 支持的类型包括： ● DeleteAllKeys：删除对应类型所有证书吊销列表 ● ResetAllKeysToDefault：恢复对应类型的证书吊销列表到默认值 说明：当参数为ResetAllKeysToDefault 时，如果没有相关初始证书，则该操作等同于DeleteAllKeys。初始证书的支持情况请参考对应机型的《BIOS参数参考》 |
使用指南
无
使用实例
请求样例：
http
POST <https://device_ip/redfish/v1/Systems/system_id/SecureBoot/SecureBootDatabases/database_id/Actions/SecureBootDatabase.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