文档中心
SecureBootDatabases
更新时间： 2026/06/26
在Gitcode上查看源码

ResourceDefinition ​

uris ​

  • /redfish/v1/Systems/system_id/SecureBoot/SecureBootDatabases/database_id

properties ​

名称类型是否只读取值范围/枚举值说明
@odata.contextstringtrue-安全启动数据库资源的OData描述
@odata.idstringtrue-安全启动数据库资源资源的访问路径
@odata.typestringtrue-安全启动数据库资源的类型
Idstringtrue-安全启动数据库资源的ID
Namestringtrue-安全启动数据库资源的名称
Descriptionstringtrue-安全启动数据库资源的描述
Certificatesobjecttrue-安全启动数据库中包含的证书集合的链接
DatabaseIdstringtrue-安全启动数据库的名称

supported_methods ​

  • GET
  • POST

HTTP methods ​

GET ​

命令功能

查询安全启动数据库资源信息

命令格式

URL: https://device_ip/redfish/v1/Systems/system_id/SecureBoot/SecureBootDatabases/database_id

请求头:


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安全启动证书表示已下发的配置，但当前还未生效，下次系统重启时生 效；系统启动过程中无法重置证书。

命令格式

URL: 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"
}

请求头参数说明

参见 请求头参数说明

请求体参数说明

参数参数说明取值
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