跳到主要内容

GET – 机箱属性

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

请求 URL

GET https://<BMC_IPADDR>/redfish/v1/Chassis/{1..N}

请求正文

响应正文

响应是包含以下参数的 JSON 对象:

字段类型描述

Id

字符串

唯一标识机箱集合中的资源。

对于服务器的 Chassis 资源,此 Id 为“1”。

在高密度系统或 Flex System 刀片系统上,Chassis 资源中的 Id 为“2”。

对于服务器中配备存储背板的 Chassis 资源,Id 为“3”~“N”。

Description

字符串

提供此机箱资源的描述。

LogServices

链接

此机箱中包含的日志服务资源的引用链接。

Memory

链接

位于此机箱中的内存资源的引用链接。

PCIeDevices

链接

位于此机箱中的 PCIe 设备的引用链接。

Power

链接

此机箱中包含的电源资源的引用链接。

AssetTag

字符串

用户为此机箱分配的资产标记。

ChassisType

字符串

此属性指示此资源的物理外形规格类型。有效值包括:

  • RackMount:服务器为机架式服务器。

  • Blade:服务器为刀片式服务器。

  • StandAlone:服务器为立式服务器。

EnvironmentalClass

字符串

此机箱的 ASHRAE 环境等级。

HeightMn

数字

机箱的高度。

IndicatorLED

字符串

指示灯 LED 的状态,用于识别机箱。有效值包括:

  • Off:指示灯 LED 熄灭。

  • Lit:指示灯 LED 点亮。

  • Blinking:指示灯 LED 正在闪烁。

Links

对象

已展开。

 

ComputerSystems

数组

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

  

ComputerSystems[1]

链接

计算机系统资源的引用链接。

 

ContainedBy

链接此属性的值是对 Flex System Enterprise Chassis 或 Lenovo D2 Enclosure 的机箱资源的 URI 引用。
 

CooledBy

数组

为此机箱散热的资源的 ID 数组。

  

CooledBy[N]

链接

散热设备资源的引用链接。

 

Drives

数组

此机箱中硬盘的资源数组。

  

Drives[N]

链接

硬盘资源的引用链接。

 

ManagedBy

数组

负责管理此机箱的管理器的引用数组。

  

ManagedBy[0]

链接

负责管理此机箱的管理器资源的引用链接。

 

ManagersInChassis

数组

此机箱中包含的管理器的引用数组。

  

ManagerInChassis[0]

链接

管理器资源的引用链接。

 

PCIeDevices

数组

位于此机箱中的 PCIe 设备的引用数组。

  

PCIeDevices[N]

链接

位于此机箱中的 PCIe 设备资源的引用链接。

 

PoweredBy

数组

为此机箱供电的资源的 ID 数组。

  

PoweredBy[N]

链接

电源设备资源的引用链接。

 

Processors

数组

位于此机箱中的处理器的引用数组。

  

Processors[N]

链接

位于此机箱中的处理器资源的引用链接。

 

Storage

数组

连接到此机箱或位于此机箱内部的存储子系统的引用数组。

  

Storage[N]

链接

位于此机箱内的存储设备资源的引用链接。

MaxPowerWatts

数字

机箱消耗的总功率的上限。

MinPowerWatts

数字

机箱消耗的总功率的下限。

Manufacturer

字符串

此机箱的制造商。始终设置为“Lenovo”或“LNVO”。

Model

字符串

机箱的型号。

Name

字符串

Chassis 资源的名称。始终设置为“Chassis”。

NetworkAdapters

链接

此机箱中包含的网络适配器资源集合的引用链接。

PartNumber

字符串

此机箱的部件号。

Power

链接

此机箱中包含的电源设备资源的引用链接。

PowerState

字符串

此机箱的当前电源状态。有效值包括:

  • On

  • Off

SKU

字符串

此机箱的 SKU。

Sensors

链接

此机箱中包含的传感器资源的引用链接。

SerialNumber

字符串

此机箱的序列号。

Thermal

链接

此机箱中包含的散热资源的引用链接。

Status

对象

包含以下元素。

 

Health

字符串

此机箱当前的运行状况,如事件日志中的条目所示。有效值包括:

  • OK:正常。此机箱的事件日志中无警告或紧急事件。

  • Critical:存在需要立即关注的紧急状况。此机箱的事件日志中至少有一个紧急事件。

  • Warning:存在需要注意的状况。此机箱的事件日志中至少有一个警告(但没有紧急事件)。

 

State

字符串

“Enabled”。

UUID

字符串

此机箱的 UUID。

Location

对象

机箱的位置。

 

Contacts

数组

联系信息的数组。

  

Contacts[0]

对象

已展开

   

ContactName

字符串

此联系人的姓名。

 

PartLocation

对象

部件位置。

  

LocationOrdinalValue

整数

表示部件位置的数字。如果 LocationType 为“slot”,而此单元位于插槽 2 中,则 LocationOrdinalValue 为 2。

  

LocationType

字符串

部件位置类型,如 slot、bay 和 socket

  

ServiceLabel

字符串

部件位置标签,如丝印名称或印刷标签。

 

Placement

对象

寻址位置中的点位。

  

Rack

字符串

一行中的机架位置的名称。

  

RackOffset

整数

项的垂直位置(以 RackOffsetUnits 为单位)。

  

RackOffsetUnits

字符串

正在使用的机架单元类型。

 

PostalAddress

对象

寻址资源的邮政地址。

  

Building

字符串

建筑物的名称。

  

Location

字符串

机房名称或其他附加信息。

  

Name

字符串

名称。

  

Room

字符串

机房名称或编号。

状态代码

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

示例

返回以下示例 JSON 响应:

{
"SerialNumber": "NARVIR073",
"@odata.id": "/redfish/v1/Chassis/1",
"IndicatorLED": "Lit",
"PowerState": "On",
"NetworkAdapters": {
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters"
},
"EnvironmentalClass": "A4",
"Oem": {

},
"ChassisType": "RackMount",
"Location": {
"PostalAddress": {
"Location": "",
"Room": "10F",
"Building": "ZJ",
"Name": "Narvi-SR860V2-1"
},
"Placement": {
"RackOffset": 48,
"Rack": "15C",
"RackOffsetUnits": "EIA_310"
},
"PartLocation": {},
"Contacts": [
{
"ContactName": ""
}
]
},
"Model": "7Z59CTO1WW",
"PCIeSlots": {
"@odata.id": "/redfish/v1/Chassis/1/PCIeSlots"
},
"Description": "This resource is used to represent a chassis or other physical enclosure for a Redfish implementation.",
"Thermal": {
"@odata.id": "/redfish/v1/Chassis/1/Thermal"
},
"Links": {
"Drives": [],
"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"
},
{
"@odata.id": "/redfish/v1/Chassis/1/Thermal#/Fans/4"
},
{
"@odata.id": "/redfish/v1/Chassis/1/Thermal#/Fans/5"
},
{
"@odata.id": "/redfish/v1/Chassis/1/Thermal#/Fans/6"
},
{
"@odata.id": "/redfish/v1/Chassis/1/Thermal#/Fans/7"
},
{
"@odata.id": "/redfish/v1/Chassis/1/Thermal#/Fans/8"
},
{
"@odata.id": "/redfish/v1/Chassis/1/Thermal#/Fans/9"
}
],
"ComputerSystems": [
{
"@odata.id": "/redfish/v1/Systems/1"
}
],
"PCIeDevices": [
{
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices"
}
],
"PoweredBy": [
{
"@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/0"
},
{
"@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/1"
},
{
"@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/2"
},
{
"@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/3"
}
],
"Storage": [],
"ManagersInChassis": [
{
"@odata.id": "/redfish/v1/Managers/1"
}
],
"Processors": [
{
"@odata.id": "/redfish/v1/Systems/1/Processors/1"
},
{
"@odata.id": "/redfish/v1/Systems/1/Processors/2"
}
],
"ManagedBy": [
{
"@odata.id": "/redfish/v1/Managers/1"
}
]
},
"AssetTag": "asset tag",
"MaxPowerWatts": 1800,
"MinPowerWatts": 0,
"PCIeDevices": {
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices"
},
"Status": {
"State": "Enabled",
"Health": "Critical"
},
"Id": "1",
"Name": "Chassis",
"HeightMm": 177.8,
"Power": {
"@odata.id": "/redfish/v1/Chassis/1/Power"
},
"SKU": "7Z59CTO1WW",
"@odata.type": "#Chassis.v1_12_0.Chassis",
"PartNumber": "SB27A22721",
"Manufacturer": "Lenovo",
"@odata.etag": "\"f72f9435541d30ea47472\"",
"LogServices": {
"@odata.id": "/redfish/v1/Systems/1/LogServices"
},
"UUID": "55833BF4-5BBB-11E7-997F-0A94EF402C57"
}