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 |
---|---|
500 | InternalError |
示例
返回以下示例 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"
}
}