跳到主要内容

GET – 服务器属性

使用 GET 方法检索 Redfish 服务的 System 资源中的属性。

请求 URL

GET https://<BMC_IPADDR>/redfish/v1/Systems/1

请求正文

响应正文

字段

类型

描述

Id

字符串

“1”

Name

字符串

“ComputerSystem”

Description

字符串

“This resource is used to represent a computing system for a Redfish implementation.”

SystemType

字符串

此资源表示的计算机系统的类型

AssetTag

字符串

系统的资产标记

Manufacturer

字符串

系统的制造商标记

Model

字符串

系统的型号

SubModel

字符串

系统的子型号

SKU

字符串

此系统的制造商 SKU。

SerialNumber

字符串

系统的序列号

PartNumber

字符串

null

UUID

字符串

此系统的通用唯一标识符(UUID)

HostName

字符串

此主机的全名:XCC2-SubModel-SerialNumber

IndicatorLED

字符串

与此系统关联的指示灯状态

Boot

对象

描述当前资源的引导信息。对此对象的更改不会改变 BIOS 持久引导顺序配置

 

BootOptions

链接

与此计算机系统关联的 UEFI 引导选项集合的链接。

 

BootOrder

数组

项:字符串

项数:N

  

BootOrder[N]

字符串

BootOptionReference 字符串,表示与此计算机系统相关的持久引导顺序。

 

BootOrderPropertySelection

字符串

“BootOrder”。

 

BootSourceOverrideEnabled

字符串

描述“引导源覆盖”功能的状态

 

BootSourceOverrideMode

字符串

从 BootSourceOverrideTarget 引导源进行引导时要使用的 BIOS 引导模式(Legacy 或 UEFI)

 

UefiTargetBootSourceOverride

字符串

当 BootSourceOverrideSupported 为 UefiTarget 时作为引导源的设备的 UEFI 设备路径。

 

AutomaticRetryConfig

字符串

只读。值为“RetryAlways”或“RetryAttempts”。

 

AutomaticRetryAttempts

数字

如果 AutomaticRetryConfig 为“RetryAlways”,则此属性不存在。如果 AutomaticRetryConfig 为“RetryAttempts”,则值为 50。

 

BootSourceOverrideTarget

字符串

BootSourceOverrideEnabled 为 true 的情况下,下次引导时要使用的当前引导源(取代正常引导设备)

 

BootSourceOverrideTarget @Redfish.AllowableValues

数组

项:字符串

项数:8

 

BootSourceOverrideTarget @Redfish.AllowableValues[0]

字符串

“None”

 

BootSourceOverrideTarget @Redfish.AllowableValues[1]

字符串

“Pxe”

 

BootSourceOverrideTarget @Redfish.AllowableValues[2]

字符串

“Cd”

 

BootSourceOverrideTarget @Redfish.AllowableValues[3]

字符串

“Usb”

 

BootSourceOverrideTarget @Redfish.AllowableValues[4]

字符串

“Hdd”

 

BootSourceOverrideTarget @Redfish.AllowableValues[5]

字符串

“BiosSetup”

 

BootSourceOverrideTarget @Redfish.AllowableValues[6]

字符串

“Diags”

 

BootSourceOverrideTarget @Redfish.AllowableValues[7]

字符串

“UefiTarget”

 

BootSourceOverrideEnabled @Redfish.AllowableValues

数组

项:字符串

项数:2

 

BootSourceOverrideEnabled @Redfish.AllowableValues[0]

字符串

“Once”

 

BootSourceOverrideEnabled @Redfish.AllowableValues[1]

字符串

“Disabled”

BiosVersion

字符串

系统 BIOS 的版本。

TrustedModules

对象

系统中的可信任模块的数组。
基于 AMD EPYC(第二代、第三代)的系统不支持此对象。
 

InterfaceType

字符串

可信模块的接口类型。

 

FirmwareVersion

字符串

此可信模块的固件版本。

 

InterfaceTypeSelection

字符串

此可信模块支持的接口类型选择。

 

Status

对象

此可信模块的状态。

  

State

字符串

此可信模块的状态。

  

Health

字符串

如果状态为“Absent”,则会被隐藏,否则为“OK”

ProcessorSummary

对象

此对象大致详细描述系统的中央处理器。

 

Count

数字

系统中的处理器数。

 

LogicalProcessorCount

整数

逻辑处理器计数。

 

Metrics

链接

与此系统中所有处理器关联的指标的链接。

 

Model

字符串

此系统中的主要或大部分处理器的处理器型号。

 

Status

对象

反映处理器摘要状态。

  

State

字符串

“Enabled”

  

HealthRollup

字符串

表示此资源的视图中的总体运行状况状态。

  

Health

字符串

表示此资源在没有依赖资源的情况下的运行状况状态。

MemorySummary

对象

此对象大致详细描述系统的内存。

 

Metrics

链接

与此系统中所有内存关联的指标的链接。

 

TotalSystemMemoryGiB

数字

操作系统可访问的已装内存总量(RAM),以 GiB 为单位。

 

Status

对象

反映内存摘要状态。

  

State

字符串

“Enabled”。

  

HealthRollup

字符串

表示此资源的视图中的总体运行状况状态。

  

Health

字符串

表示此资源在没有依赖资源的情况下的运行状况状态。

Processors

链接

此对象大致详细描述系统的处理器。

Status

对象

已展开

 

State

字符串

“Enabled”

 

HealthRollup

字符串

表示此资源的视图中的总体运行状况状态。

 

Health

字符串

表示此资源在没有依赖资源的情况下的运行状况状态。

Links

对象

引用链接的对象。

 

ManagedBy

数组

负责管理此系统的管理器的引用数组。

 

Chassis

数组

包含此系统的机箱的引用数组。

 

PoweredBy

数组

用于此系统的电源的引用数组。

 

CooledBy

数组

用于此系统的散热设备的引用数组。

EthernetInterfaces

链接

与此系统关联的以太网接口集合的引用。

NetworkInterfaces

链接

与此系统关联的网络接口集合的引用。

LogServices

链接

与此系统关联的日志服务集合的引用。

PowerState

字符串

系统的当前电源状态。

Bios

链接

与此系统关联的 BIOS 设置的引用。

Memory

链接

与此系统关联的内存设备集合的引用。

Storage

链接

与此系统关联的存储设备集合的引用。

SecureBoot

链接

与此系统关联的 SecureBoot 设置的引用。

HostWatchdogTimer

对象

此对象描述此系统的主机看守程序计时器功能。

 

FunctionEnabled

布尔

指示是否已启用主机看守程序计时器功能。激活计时器功能需要额外的基于主机的软件。

 

Status

对象

已展开

  

State

字符串

“Disabled”或“StandbyOffline”。

 

TimeoutAction

字符串

此属性指示当看守程序计时器达到其超时值时要执行的操作。

 

TimeoutAction@ Redfish.AllowableValues

数组

项类型:字符串

项数:1

项:“PowerCycle”

 

WarningAction

字符串

此属性指示在看守程序计时器接近(通常为 3-10 秒)达到其超时值时要执行的操作。

 

WarningAction@ Redfish.AllowableValues

数组

项类型:字符串

项数:1

项:“None”

PCIeDevices

数组

包含此系统的 PCI 设备的引用数组。

PCIeFunctions

数组

包含此系统的 PCI 功能的引用数组。

VirtualMedia

链接

此系统的虚拟介质服务的引用。

KeyManagement

对象

已展开

 

KMIPServers

数组

此计算机系统订阅的 KMIP 服务器的数组。

  

KMIPServers[N]

对象

已展开

   

Address

字符串

KMIP 服务器地址。

   

Port

整数

KMIP 服务器端口。

 

KMIPCertificates

链接

KMIPServers 属性引用的服务器证书集合的 URI 引用。

Actions

对象

此资源的可用操作。

 

#ComputerSystem.Reset

对象

此操作应执行 ComputerSystem 的重置。对于实现了 APCI 电源按钮功能的系统,PushPowerButton 值应执行或模拟 ACPI 电源按钮按下操作。ForceOff 值应断开系统电源或执行 ACPI 电源按钮覆盖(通常称为按住电源按钮 4 秒)。ForceRestart 值应先执行 ForceOff 操作,然后再执行 On 操作。

  

@Redfish.ActionInfo

链接

{SR}/Systems/1/ResetActionInfo

  

ResetType@Redfish.AllowableValues

数组

项:字符串

项数:7

  

ResetType@Redfish.AllowableValues[0]

字符串

“On”

  

ResetType@Redfish.AllowableValues[1]

字符串

“Nmi”

  

ResetType@Redfish.AllowableValues[2]

字符串

“GracefulShutdown”

  

ResetType@Redfish.AllowableValues[3]

字符串

“GracefulRestart”

  

ResetType@Redfish.AllowableValues[4]

字符串

“ForceOn”

  

ResetType@Redfish.AllowableValues[5]

字符串

“ForceOff”

  

ResetType@Redfish.AllowableValues[6]

字符串

“ForceRestart”

@Redfish.Settings

对象

已展开

 

Messages

数组

项:对象

项数:0 或 1

  

Messages[0]

对象

已展开

成功修改 Pending 资源的 Boot/BootOrder 时指示“RebootRequired”消息。

   

MessageId

字符串

“ExtendedError.1.2.

RebootRequired”

   

RelatedProperties

数组

项:字符串

项数:1

    

RelatedProperties[0]

字符串

“#/Boot/BootOrder”

   

Severity

字符串

“Warning”

   

Message

字符串

“Changes completed successfully, but these changes will not take effect until next reboot.”

   

Resolution

字符串

“Reboot the computer system for the changes to take effect.”

 

SettingsObject

链接

/redfish/v1/Systems/1/Pending

 

Time

字符串

指示上次应用 Settings 资源的时间,否则值为 null。

 

SupportedApplyTimes

数组

项:字符串

项数:1

  

SupportedApplyTimes[0]

字符串

“OnReset”

状态代码

HTTP 状态代码错误消息 ID
500InternalError

示例

返回以下示例 JSON 响应:

{
"TrustedModules": [
{
"FirmwareVersion": "7.51.6405.5136",
"Status": {
"Health": "OK",
"State": "Enabled"
},
"InterfaceType": "TPM2_0",
"InterfaceTypeSelection": "BiosSetting"
}
],
"Memory": {
"@odata.id": "/redfish/v1/Systems/1/Memory"
},
"Description": "This resource is used to represent a computing system for a Redfish implementation.",
"Bios": {
"@odata.id": "/redfish/v1/Systems/1/Bios"
},
"@odata.context": "/redfish/v1/$metadata#ComputerSystem.ComputerSystem",
"SecureBoot": {
"@odata.id": "/redfish/v1/Systems/1/SecureBoot"
},
"IndicatorLED": "Off",
"Model": "ThinkSystem ST650 V3 MAIN BOARD",
"LogServices": {
"@odata.id": "/redfish/v1/Systems/1/LogServices"
},
"Name": "ComputerSystem",
"@odata.type": "#ComputerSystem.v1_17_0.ComputerSystem",
"@odata.id": "/redfish/v1/Systems/1",
"PCIeFunctions@odata.count": 5,
"PartNumber": null,
"@odata.etag": "\"2830443250c3932c789b18\"",
"UUID": "00000000-0000-0000-0000-000000000000",
"Processors": {
"@odata.id": "/redfish/v1/Systems/1/Processors"
},
"MemorySummary": {
"Status": {
"HealthRollup": "OK",
"Health": "OK",
"State": "Enabled"
},
"Metrics": {
"@odata.id": "/redfish/v1/Systems/1/MemorySummary/MemoryMetrics"
},
"TotalSystemMemoryGiB": 16
},
"HostName": "XCC-0123-1234567890",
"AssetTag": "Madrid2",
"NetworkInterfaces": {
"@odata.id": "/redfish/v1/Systems/1/NetworkInterfaces"
},
"SystemType": "Physical",
"SerialNumber": "1234567890",
"EthernetInterfaces": {
"@odata.id": "/redfish/v1/Systems/1/EthernetInterfaces"
},
"Manufacturer": "Lenovo",
"SKU": "7D7AMT1",
"HostWatchdogTimer": {
"TimeoutAction@Redfish.AllowableValues": [
"PowerCycle"
],
"WarningAction@Redfish.AllowableValues": [
"None"
],
"FunctionEnabled": false,
"WarningAction": "None",
"TimeoutAction": "PowerCycle",
"Status": {
"State": "Disabled"
}
},
"Links": {
"CooledBy": [
{
"@odata.id": "/redfish/v1/Chassis/1/Thermal#/Fans/0"
},
{
"@odata.id": "/redfish/v1/Chassis/1/Thermal#/Fans/1"
},
{
"@odata.id": "/redfish/v1/Chassis/1/Thermal#/Fans/2"
},
{
"@odata.id": "/redfish/v1/Chassis/1/Thermal#/Fans/3"
}
],
"PoweredBy": [],
"Chassis": [
{
"@odata.id": "/redfish/v1/Chassis/1"
}
],
"ManagedBy": [
{
"@odata.id": "/redfish/v1/Managers/1"
}
]
},
"Oem": {

},
"PCIeFunctions": [
{
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/ob_2/PCIeFunctions/ob_2.00"
},
{
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/ob_2/PCIeFunctions/ob_2.01"
},
{
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/ob_5/PCIeFunctions/ob_5.00"
},
{
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/ob_4/PCIeFunctions/ob_4.00"
},
{
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/ob_1/PCIeFunctions/ob_1.00"
}
],
"@Redfish.Settings": {
"Messages": [],
"SettingsObject": {
"@odata.id": "/redfish/v1/Systems/1/Pending"
},
"SupportedApplyTimes": [
"OnReset"
],
"Time": null,
"@odata.type": "#Settings.v1_3_0.Settings"
},
"Id": "1",
"ProcessorSummary": {
"Count": 1,
"Metrics": {
"@odata.id": "/redfish/v1/Systems/1/ProcessorSummary/ProcessorMetrics"
},
"LogicalProcessorCount": 104,
"Model": "Intel(R) Xeon(R) Platinum 8470",
"Status": {
"HealthRollup": "OK",
"Health": "OK",
"State": "Enabled"
}
},
"VirtualMedia": {
"@odata.id": "/redfish/v1/Systems/1/VirtualMedia"
},
"Actions": {
"#ComputerSystem.Reset": {
"ResetType@Redfish.AllowableValues": [
"On",
"Nmi",
"GracefulShutdown",
"GracefulRestart",
"ForceOn",
"ForceOff",
"ForceRestart"
],
"target": "/redfish/v1/Systems/1/Actions/ComputerSystem.Reset",
"title": "Reset",
"@Redfish.ActionInfo": "/redfish/v1/Systems/1/ResetActionInfo"
},
"Oem": {

}
},
"Status": {
"HealthRollup": "Critical",
"Health": "Critical",
"State": "Enabled"
},
"SubModel": "7D7A",
"PCIeDevices": [
{
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/ob_4"
},
{
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/ob_2"
},
{
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/ob_1"
},
{
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/ob_5"
}
],
"PowerState": "On",
"PCIeDevices@odata.count": 4,
"Boot": {
"BootOrderPropertySelection": "BootOrder",
"BootOrder": [
"Boot0005",
"Boot0000",
"Boot0001",
"Boot0002",
"Boot0003",
"Boot0004"
],
"AutomaticRetryConfig": "RetryAttempts",
"AutomaticRetryAttempts": 50,
"BootOptions": {
"@odata.id": "/redfish/v1/Systems/1/BootOptions"
},
"BootSourceOverrideTarget": "None",
"BootSourceOverrideMode": "UEFI",
"BootSourceOverrideTarget@Redfish.AllowableValues": [
"None",
"Pxe",
"Cd",
"Usb",
"Hdd",
"BiosSetup",
"Diags",
"UefiTarget"
],
"BootSourceOverrideEnabled": "Disabled",
"BootSourceOverrideEnabled@Redfish.AllowableValues": [
"Once",
"Disabled"
],
"UefiTargetBootSourceOverride": null
},
"BiosVersion": "USE103V",
"Storage": {
"@odata.id": "/redfish/v1/Systems/1/Storage"
}
}