ResourceDefinition

uris

/redfish/v1/Systems/system_id/Bios

properties

名称	类型	是否只读	取值范围/枚举值	说明
@odata.context	string	true	-	BIOS资源模型的OData描述信息
@odata.id	string	true	-	BIOS资源的访问路径
@odata.type	string	true	-	BIOS资源的类型
Id	string	true	-	BIOS资源的ID
Name	string	true	-	BIOS资源的名称
AttributeRegistry	string	true	-	BIOS属性注册资源ID
Attributes {	object	true	-	BIOS属性列表，具体属性参考表3-488
Attributes.ATS	string	true	-	是否使能Intel VT-d地址转换服务（ATS）
Attributes.BMCWDTAction	string	true	-	BMC看门狗超时后的动作
Attributes.BMCWDTEnable	string	true	-	是否使能BMC看门狗
Attributes.BMCWDTTimeout	number	true	-	BMC看门狗超时时间
Attributes.BootPState	string	true	-	启动时的P状态
Attributes.BootTypeOrder0	string	true	-	启动类型顺序0
Attributes.BootTypeOrder1	string	true	-	启动类型顺序1
Attributes.BootTypeOrder2	string	true	-	启动类型顺序2
Attributes.BootTypeOrder3	string	true	-	启动类型顺序3
Attributes.C6Enable	string	true	-	是否使能C6状态
Attributes.CREnable	string	true	-	是否使能串口重定向
Attributes.CoherencySupport	string	true	-	是否支持缓存一致性
Attributes.CustomPowerPolicy	string	true	-	自定义电源策略
Attributes.DCUIPPrefetcherEnable	string	true	-	是否使能DCU IP预取器
Attributes.DCUStreamerPrefetcherEnable	string	true	-	是否使能DCU流预取器
Attributes.DDRFreqLimit	string	true	-	DDR频率限制
Attributes.EnableXE	string	true	-	是否使能XE功能
Attributes.FPKPortConfig0	string	true	-	是否使能FPK端口0
Attributes.FPKPortConfig1	string	true	-	是否使能FPK端口1
Attributes.FPKPortConfig2	string	true	-	是否使能FPK端口2
Attributes.FPKPortConfig3	string	true	-	是否使能FPK端口3
Attributes.GlobalBaudRate	string	true	-	串口全局波特率
Attributes.InterruptRemap	string	true	-	是否使能中断重映射
Attributes.KtiLinkL0pEn	string	true	-	是否使能KTI链路L0p电源状态
Attributes.KtiLinkL1En	string	true	-	是否使能KTI链路L1电源状态
Attributes.MLCSpatialPrefetcherEnable	string	true	-	是否使能MLC空间预取器
Attributes.MLCStreamerPrefetcherEnable	string	true	-	是否使能MLC流预取器
Attributes.MonitorMwaitEnable	string	true	-	是否使能MONITOR/MWAIT指令
Attributes.NumaEn	string	true	-	是否使能NUMA
Attributes.OSWDTAction	string	true	-	OS看门狗超时后的动作
Attributes.OSWDTEnable	string	true	-	是否使能OS看门狗
Attributes.OSWDTTimeout	number	true	-	OS看门狗超时时间
Attributes.PCIeARISupport	string	true	-	是否支持PCIe ARI
Attributes.PCIePortDisable1	string	true	-	是否禁用PCIe端口1
Attributes.PCIePortDisable8	string	true	-	是否禁用PCIe端口8
Attributes.PCIePortDisable85	string	true	-	是否禁用PCIe端口85
Attributes.PCIeSRIOVSupport	string	true	-	是否支持PCIe SR-IOV
Attributes.PStateDomain	string	true	-	P状态域
Attributes.PXEBootToLanLegacy	string	true	-	是否使能Legacy模式PXE网络启动
Attributes.PXEBootToLanUEFI	string	true	-	是否使能UEFI模式PXE网络启动
Attributes.PassThroughDMA	string	true	-	是否使能DMA直通
Attributes.PatrolScrub	string	true	-	是否使能内存巡检
Attributes.PowerSaving	string	true	-	省电模式
Attributes.ProcessorAutonomousCStateEnable	string	true	-	是否使能处理器自主C状态
Attributes.ProcessorAutonomousCstateEnable	string	true	-	是否使能处理器自主C状态
Attributes.ProcessorC1eEnable	string	true	-	是否使能处理器C1e状态
Attributes.ProcessorEISTEnable	string	true	-	是否使能处理器EIST
Attributes.ProcessorFlexibleRatio	number	true	-	处理器灵活倍频
Attributes.ProcessorFlexibleRatioOverrideEnable	string	true	-	是否使能处理器灵活倍频覆盖
Attributes.ProcessorHWPMEnable	string	true	-	是否使能处理器硬件电源管理
Attributes.ProcessorHyperThreadingDisable	string	true	-	是否禁用处理器超线程
Attributes.ProcessorX2APIC	string	true	-	是否使能处理器x2APIC
Attributes.PxeTimeoutRetryControl	string	true	-	PXE超时重试控制
Attributes.QpiLinkSpeed	string	true	-	QPI链路速度
Attributes.QuickBoot	string	true	-	是否使能快速启动
Attributes.QuietBoot	string	true	-	是否使能静默启动
Attributes.SystemCpuUsage	number	true	-	系统CPU使用率
Attributes.TStateEnable	string	true	-	是否使能T状态
Attributes.TurboMode	string	true	-	是否使能Turbo模式
Attributes.VTdSupport	string	true	-	是否支持VT-d
}
SoftwareImages [ {	array	true	-	BIOS固件镜像列表
SoftwareImages[].@odata.id	string	true	-	固件信息资源节点的访问路径
} ]
ActiveSoftwareImage {	object	true	-	有效的BIOS固件镜像
ActiveSoftwareImage.@odata.id	string	true	-	固件信息资源节点的访问路径
}
ResetBiosToDefaultsPending	boolean	true	true/false	是否存在重设BIOS属性的待处理请求
@Redfish.Settings {	object	true	-	BIOS设置资源信息
@Redfish.Settings.@odata.type	string	true	-	BIOS设置资源的类型
@Redfish.Settings.ETag	string	true	-	BIOS设置资源的ETag值
@Redfish.Settings.Messages[ ]	array	true	-	BIOS设置任务相关联的数组，记录BIOS侧返回的未生效的设置项及对应的错误码
@Redfish.Settings.Time	string	true	-	BIOS设置生效的时间
@Redfish.Settings.SettingsObject {	object	true	-	BIOS设置资源的访问路径
@Redfish.Settings.SettingsObject.@odata.id	string	true	-	SettingsObject资源的访问路径
}
}
Actions {	object	true	-	Redfish允许的指定BIOS资源可执行操作
Actions.#Bios.ResetBios {	object	true	-	恢复BIOS项默认值
Actions.#Bios.ResetBios.target	string	true	-	恢复BIOS属性默认值的路径
Actions.#Bios.ResetBios.@Redfish.ActionInfo	string	true	-	恢复BIOS属性默认值的查询路径
}
Actions.#Bios.ChangePassword {	object	true	-	修改BIOS密码
Actions.#Bios.ChangePassword.target	string	true	-	修改BIOS密码的路径
Actions.#Bios.ChangePassword.@Redfish.ActionInfo	string	true	-	修改BIOS密码的查询路径
}
}
Oem {	object	true	-	自定义属性
Oem.Public {	object	true	-	自定义属性
Oem.Public.BootCertificates {	object	true	-	BIOS证书资源的访问路径说明BMC300 3.8.0.1及以上版本支持
Oem.Public.BootCertificates.@odata.id	string	true	-	BootCertificates资源的访问路径
}
}
}
PolicyConfig {	object	true	-	BIOS策略重配资源的访问路径
PolicyConfig.@odata.id	string	true	-	PolicyConfig资源的访问路径
}

supported_methods

GET
POST

HTTP methods

GET

命令功能

查询 BIOS 资源信息

说明

查询BIOS配置信息时，查询的是BIOS持久化生效的配置项信息。BIOS实际支持的资源信息受BIOS版本限制。

命令格式

URL: https://device_ip/redfish/v1/Systems/system_id/Bios

请求头:


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/Bios

X-Auth-Token: 123456789***********************

请求消息体：无

响应样例：

json

{
  "@odata.context": "/redfish/v1/$metadata#Bios.Bios",
  "@odata.id": "/redfish/v1/Systems/1/Bios",
  "@odata.type": "#Bios.v1_2_3.Bios",
  "Id": "Bios",
  "Name": "BIOS Configuration Current Settings",
  "AttributeRegistry": "BiosAttributeRegistry.1.0.1",
  "Attributes": {
    "QuickBoot": "Enabled",
    "QuietBoot": "Disabled",
    "PXEBootToLanUEFI": "Enabled",
    "PXEBootToLanLegacy": "Enabled",
    "PxeTimeoutRetryControl": "Disabled",
    "BootTypeOrder0": "HardDiskDrive",
    "BootTypeOrder1": "DVDROMDrive",
    "BootTypeOrder2": "PXE",
    "BootTypeOrder3": "Others",
    "CustomPowerPolicy": "Efficiency",
    "TurboMode": "Disabled",
    "ProcessorHyperThreadingDisable": "Enabled",
    "ProcessorEISTEnable": "Enabled",
    "PowerSaving": "Enabled",
    "SystemCpuUsage": 95,
    "PStateDomain": "All",
    "ProcessorAutonomousCstateEnable": "Enabled",
    "ProcessorAutonomousCStateEnable": "Enabled",
    "ProcessorC1eEnable": "Enabled",
    "C6Enable": "Enabled",
    "NumaEn": "Enabled",
    "PCIeSRIOVSupport": "Disabled",
    "PCIeARISupport": "Disabled",
    "VTdSupport": "Enabled",
    "InterruptRemap": "Enabled",
    "CoherencySupport": "Enabled",
    "ATS": "Enabled",
    "PassThroughDMA": "Enabled",
    "BMCWDTEnable": "Disabled",
    "BMCWDTAction": "HardReset",
    "BMCWDTTimeout": 20,
    "OSWDTEnable": "Disabled",
    "OSWDTAction": "HardReset",
    "OSWDTTimeout": 5,
    "CREnable": "Enabled",
    "GlobalBaudRate": "Rate115200",
    "ProcessorFlexibleRatioOverrideEnable": "Disabled",
    "ProcessorFlexibleRatio": 23,
    "ProcessorHWPMEnable": "Disabled",
    "TStateEnable": "Disabled",
    "EnableXE": "Disabled",
    "MLCStreamerPrefetcherEnable": "Disabled",
    "MLCSpatialPrefetcherEnable": "Disabled",
    "MonitorMwaitEnable": "Enabled",
    "DCUStreamerPrefetcherEnable": "Disabled",
    "DCUIPPrefetcherEnable": "Enabled",
    "ProcessorX2APIC": "Disabled",
    "BootPState": "MaxPerformance",
    "QpiLinkSpeed": "Auto",
    "KtiLinkL0pEn": "Enabled",
    "KtiLinkL1En": "Enabled",
    "DDRFreqLimit": "Auto",
    "PatrolScrub": "Enabled",
    "FPKPortConfig0": "Enabled",
    "FPKPortConfig1": "Enabled",
    "FPKPortConfig2": "Enabled",
    "FPKPortConfig3": "Enabled",
    "PCIePortDisable1": "Auto",
    "PCIePortDisable8": "Auto",
    "PCIePortDisable85": "Auto"
  },
  "SoftwareImages": [
    {
      "@odata.id": "/redfish/v1/UpdateService/FirmwareInventory/Bios"
    }
  ],
  "ActiveSoftwareImage": {
    "@odata.id": "/redfish/v1/UpdateService/FirmwareInventory/Bios"
  },
  "ResetBiosToDefaultsPending": false,
  "@Redfish.Settings": {
    "@odata.type": "#Settings.v1_0_0.Settings",
    "ETag": "2484f287",
    "Messages": [],
    "Time": "2016-02-29T16:14:44+00:00",
    "SettingsObject": {
      "@odata.id": "/redfish/v1/Systems/1/Bios/Settings"
    }
  },
  "Actions": {
    "#Bios.ResetBios": {
      "target": "/redfish/v1/Systems/1/Bios/Actions/Bios.ResetBios",
      "@Redfish.ActionInfo": "/redfish/v1/Systems/1/Bios/ResetBiosActionInfo"
    },
    "#Bios.ChangePassword": {
      "target": "/redfish/v1/Systems/1/Bios/Actions/Bios.ChangePassword",
      "@Redfish.ActionInfo": "/redfish/v1/Systems/1/Bios/ChangePasswordActionInfo"
    }
  },
  "Oem": {
    "Public": {
      "BootCertificates": {
        "@odata.id": "/redfish/v1/Systems/1/Bios/Oem/Public/BootCertificates"
      }
    }
  },
  "PolicyConfig": {
    "@odata.id": "/redfish/v1/Systems/1/Bios/PolicyConfig"
  }
}

响应码：200

POST (ACTION)

ResetBios

命令功能

恢复 BIOS 属性默认值

说明

恢复BIOS默认资源表示已下发BIOS默认值，但当前还未生效，下次系统重启时生效。

命令格式

URL: https://device_ip/redfish/v1/Systems/system_id/Bios/Actions/Bios.ResetBios

请求头:


X-Auth-Token: 123456789***********************
Content-Type: header_type

请求消息体:

json

{}

请求头参数说明

参见请求头参数说明

请求体参数说明

参数	参数说明	取值
system_id	系统资源的ID	● 针对机架服务器，取值为1 ● 针对高密服务器，取值为BladeN（N表示节点槽位号），例如 "Blade1" ● 针对刀片服务器，取值可以为BladeN（N表示计算节点槽位号）或 SwiN（N表示交换模块槽位号），例如 "Swi1" ● 针对X6800 V5，X6000 V5，G5500，XA320 V2服务器，取值还可以为Enc，表示计算节点所在的机框资源 ● 针对设备U位信息，取值可以为UN(N表示设备U位号)，例如"U1" ● 针对机柜资源，取值为 Rack

使用指南

无

使用实例

请求样例：

http

POST https://device_ip/redfish/v1/Systems/system_id/Bios/Actions/Bios.ResetBios

X-Auth-Token: 123456789*********************** Content-Type: header_type

请求消息体：

json

{}

响应样例：

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

POST (ACTION)

ChangePassword

命令功能

修改 BIOS 密码

说明

BMC只是修改BIOS密码，BIOS密码生效需重启OS，且如果OS重启前有多次设置，以最后一次的设置请求为准1。

命令格式

URL: https://device_ip/redfish/v1/Systems/system_id/Bios/Actions/Bios.ChangePassword

请求头:


X-Auth-Token: 123456789***********************
Content-Type: header_type

请求消息体:

json

{
  "OldPassword": oldpwd_value,
  "NewPassword": newpwd_value,
  "PasswordName": pwd_name
}

请求头参数说明

参见请求头参数说明

请求体参数说明

参数	参数说明	取值
system_id	系统资源的ID	● 针对机架服务器，取值为1 ● 针对高密服务器，取值为BladeN（N表示节点槽位号），例如 “Blade1” ● 针对刀片服务器，取值可以为BladeN（N表示计算节点槽位号）或 SwiN（N表示交换模块槽位号），例如 “Swi1”
oldpwd_value	字符串	BIOS已存在密码，长度以 BIOS侧实际情况为准
newpwd_value	字符串	BIOS的新密码，长度以 BIOS侧实际情况为准
pwd_name	字符串	● Supervisor：修改BIOS 管理员密码 ● UserPassword：修改 BIOS普通用户密码说明 UserPassword只在BMC300 5.1.0及以上版本支持

使用指南

无

使用实例

请求样例：

http

POST https://device_ip/redfish/v1/Systems/system_id/Bios/Actions/Bios.ChangePassword

X-Auth-Token: 123456789*********************** Content-Type: header_type

请求消息体：

json

{
  "OldPassword": oldpwd_value,
  "NewPassword": newpwd_value,
  "PasswordName": pwd_name
}

响应样例：

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

ResourceDefinition ​

uris ​

properties ​

supported_methods ​

HTTP methods ​

GET ​

POST (ACTION) ​

ResetBios ​

POST (ACTION) ​

ChangePassword ​

ResourceDefinition

uris

properties

supported_methods

HTTP methods

GET

POST (ACTION)

ResetBios

POST (ACTION)

ChangePassword