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 | 字符串 | 此属性指示此资源的物理外形规格类型。有效值包括:
| |||
EnvironmentalClass | 字符串 | 此机箱的 ASHRAE 环境等级。 | |||
HeightMn | 数字 | 机箱的高度。 | |||
IndicatorLED | 字符串 | 指示灯 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 | 字符串 | 此机箱的当前电源状态。有效值包括:
| |||
SKU | 字符串 | 此机箱的 SKU。 | |||
Sensors | 链接 | 此机箱中包含的传感器资源的引用链接。 | |||
SerialNumber | 字符串 | 此机箱的序列号。 | |||
Thermal | 链接 | 此机箱中包含的散热资源的引用链接。 | |||
Status | 对象 | 包含以下元素。 | |||
Health | 字符串 | 此机箱当前的运行状况,如事件日志中的条目所示。有效值包括:
| |||
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 |
---|---|
500 | InternalError |
示例
返回以下示例 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"
}