ResourceDefinition

uris

/redfish/v1/Chassis/chassis_id

properties

名称	类型	是否只读	取值范围/枚举值	说明
@odata.context	string	true	-	指定机箱资源模型的OData描述信息
@odata.id	string	true	-	指定机箱资源的访问路径
@odata.type	string	true	-	指定机箱资源的类型
Id	string	true	-	指定机箱资源的ID，为机箱在机箱集合中的唯一标识
Name	string	true	-	指定机箱资源的名称
ChassisType	string	true	-	机箱类型，包括： ● Rack：机柜 ● Blade：刀片服务器 ● Enclosure：存储柜 ● StandAlone：塔式 ● RackMount：机柜组 ● Card：板卡 ● Cartridge：模组盒 ● Row：机柜排 ● Pod：集装器 ● Expansion：扩展机箱 ● Sidecar：附加机箱 ● Zone：分区 ● Sled：滑架 ● Shelf：机框 ● Drawer：抽屉式机箱 ● Module：模块 ● Component：组件式 ● Other：其他
Manufacturer	string	true	-	机箱厂商信息
Model	string	true	-	机箱型号信息
Power {	object	true	-	指定机箱的功耗说明已屏蔽该属性值频繁变化导致的事件上报
`Power.@odata.id`	string	true	-	Power资源的访问路径
}
SerialNumber	string	true	-	机箱序列号
PartNumber	string	true	-	机箱部件号
Assembly {	object	true	-	装配体资源信息
`Assembly.@odata.id`	string	true	-	Assembly资源的访问路径
}
AssetTag	string	false	-	机箱资产标签
Oem {	object	true	-	机箱的自定义信息
Oem.Public {	object	true	-	机箱的自定义信息
Oem.Public.PowerSupplySummary {	object	true	-	电源汇总信息
Oem.Public.PowerSupplySummary.Status {	object	true	-	指定机箱资源的状态，包括： ● State：机箱是否使能 ● Health：机箱健康状态 ● Severity：机箱的自定义健康状态
Oem.Public.PowerSupplySummary.Status.HealthRollup	string	true	-	指定机箱子资源整体运行状态，通常取值为OK，任意Job子资源JobStatus存在异常（Critical）时取值为Warning，包括： ● OK：正常 ● Warning：警告
Oem.Public.PowerSupplySummary.Status.Severity	string	true	-	错误严重级别，包括： ● OK：正常 ● Warning：警告 ● Critical：严重
}
Oem.Public.PowerSupplySummary.Count	number	true	-	硬盘个数
}
Oem.Public.ChassisID	string	true	-	指定机箱资源的机框号
Oem.Public.HeadNodeId	number	true	-	机头ID，默认为null，表示未分配
Oem.Public.Boards {	object	true	-	扩展板卡资源导航：包括： ● @odata.id：扩展板卡资源的访问路径
`Oem.Public.Boards.@odata.id`	string	true	-	电子保单资源访问路径
}
Oem.Public.Mainboard {	object	true	-	主板信息
Oem.Public.Mainboard.Manufacturer	string	true	-	机箱厂商信息
Oem.Public.Mainboard.SerialNumber	string	true	-	机箱序列号
Oem.Public.Mainboard.BoardName	string	true	-	主板名称
}
Oem.Public.BackupBatteryUnits	object	true	-	备电集合资源导航
Oem.Public.Board	object	true	-	单板域
Oem.Public.Chassis	object	true	-	机框域
Oem.Public.DeviceMaxNum	object	true	-	单板部件最大个数
Oem.Public.DigitalWarranty	object	true	-	电子保单
Oem.Public.DiscreteSensors	object	true	-	离散型传感器资源列表导航
Oem.Public.DriveSummary	object	true	-	指定机箱资源的硬盘状态聚合值
Oem.Public.EnergyEfficiency	object	true	-	显示服务器的节能信息说明：已屏蔽该属性及其子属性频繁变化导致的事件上报
Oem.Public.ExtendField	object	true	-	设备U位标签扩展字段
Oem.Public.NetworkAdaptersSummary	object	true	-	指定机箱资源的网卡状态聚合值
Oem.Public.Placement	object	true	-	放置信息
Oem.Public.PostalAddress	object	true	-	设备可投递地址
Oem.Public.ThresholdSensors	object	true	-	连续型传感器资源列表导航
Oem.Public.TopologyConfig	object	true	-	拓扑配置信息
}
}
LocationIndicatorActive	boolean	false	-	是否允许操作员物理定位该资源说明 openUBMC 26.03及以上版本支持。
Links {	object	true	-	指定机箱关联的资源
Links.Contains[ ]	array	true	-	包含的子机箱资源链接
`Links.Contains[].@odata.id`	string	true	-	成员资源节点的访问路径
Links.ManagedBy[ ]	array	true	-	相关对象的链接
Links.Processors [ {	array	true	-	处理器资源的导航
} ]
}
Location {	object	true	-	指定机箱丝印
Location.Info	string	true	-	机箱位置
Location.PartLocation {	object	true	-	部件位置信息，包含：LocationType、LocationOrdinalValue
Location.PartLocation.LocationOrdinalValue	number	true	-	部件位置的序号说明 openUBMC 26.03及以上版本支持。
Location.PartLocation.LocationType	string	true	-	部件位置的类型说明 openUBMC 26.03及以上版本支持。
}
}
Thermal {	object	true	-	散热资源信息
`Thermal.@odata.id`	string	true	-	Thermal资源的访问路径
}
AssetOwner	string	true	-	设备所有人
AvailableRackSpaceU	number	true	-	设备允许占用的机柜U位空间，单位为U
BackupBatteryUnitNum	number	false	-	备电单元最大个数
BasicRackSN	string	true	-	基本配置机柜SN
BoardManufacturer	string	false	-	单板厂商信息
Building	string	true	-	楼号
BunchId	number	false	-	机箱资源的ID，默认为null，表示未分配
BunchType	string	false	-	机头扩展的功能类型。包括：GPU
CabinetSerialNumber	string	false	-	机柜序列号
CarbonFootprintReductionKg	number	false	-	本服务器减少的碳排放量
ChassisLocation	string	true	-	指定机箱资源的机框位置
CheckInTime	string	true	-	设备开始使用时间
City	string	true	-	城市
Country	string	true	-	国家
CPUNum	number	false	-	CPU最大个数
DepthMm	number	true	-	机箱的深度，单位mm
DeviceSlotID	number	false	-	节点设备槽位号
DeviceType	string	true	-	设备类型 Server：服务器设备 Storage：存储设备 Network：网络设备自定义
Direction	string	true	-	机柜U位丝印增长方向 FromTopDown：从上往下增长 FromBottomUp：从下往上增长
DirectionType	string	true	-	U位方向类型包括：Changeable（方向可变）Fixed（方向固定）
DiscoveredTime	string	true	-	扫描到设备的时间
DiskNum	number	false	-	硬盘最大个数
EmptyRackSN	string	true	-	机柜的空机柜序列号
EnclosureSerialNumber	string	false	-	机框序列号
EnergySavingsPercent	number	false	-	本服务器相比于其他厂商同类设备节省能源的比例
FanNum	number	false	-	风扇最大个数
Floor	string	true	-	楼层
HeightMm	number	true	-	机箱的高度，单位mm
HouseNumber	string	true	-	房间号
IndicatorColor	string	true	-	U位识别灯颜色 Green：绿色 Yellow：黄色 Red：红色
InfoFormat	string	true	-	设备位置信息格式
InletTemperatureCelsius	number	false	-	指定机箱资源的进风口温度说明：已屏蔽该属性值频繁变化导致的事件上报
LifeCycleYear	number	true	-	设备生命周期(年)
LoadCapacityKg	number	true	-	机柜额定承重，单位:KG
ManufacturingDate	string	true	-	单板域制造日期
MaxPowerWatts	number	false	-	机箱的功耗上限
MemoryNum	number	false	-	内存最大个数
MezzCardNum	number	false	-	Mezz卡最大个数
MinPowerWatts	number	false	-	机箱的功耗下限
PackageCode	string	false	-	服务器套餐编码
PCIeNum	number	false	-	PCIe卡最大个数
PostalCode	string	true	-	邮政编码
PowerSavingsKwh	number	false	-	本服务器节省的电量
PowerState	string	false	-	当前机箱电源状态，包括：On：机箱内的组件已通电 Off：机箱内的组件未通电，但某些组件（如管理控制器）可能仍具有辅助电源
PowerSupplyNum	number	false	-	电源最大个数
Presence	string	false	-	单板在位信息 Present Absent
ProductName	string	true	-	单板域产品名
Rack	string	true	-	列
RackModel	string	true	-	机柜的型号
RatedPowerWatts	number	true	-	设备或机柜的额定功率，单位:Watts
RFIDTagUID	string	true	-	设备U位标签唯一识别ID
Room	string	true	-	房间号
Row	string	true	-	行
RWCapability	string	true	-	该U位信息的读写能力（不影响上下架能力）ReadWrite – 用户可读写 ReadOnly – 用户只读
SDCardNum	number	false	-	SD卡最大个数
SDContollerNum	number	false	-	SD控制器最大个数
SecurityModuleNum	number	false	-	安全模块最大个数
Street	string	true	-	街道
Territory	string	true	-	州、省
TopUSlot	number	true	-	设备的顶部U位号
TotalUCount	number	true	-	机柜总U位数
Type	string	true	-	机框类型
TypicalConfigurationRackSN	string	true	-	机柜的典配序列号
UBMDeployMode	string	false	-	服务器UBM部署位置 InBandPhysicalOS（带内物理机）InBandVirtualOS（带内虚拟机）OutofBand（带外物理机）
UcountUsed	number	true	-	机柜已使用U位数
UHeight	number	true	-	设备占用U位高度
UnitOccupyDirection	string	true	-	U位占用方向包括：Downward（占用方向向下）Upward（占用方向向上）
UUID	string	true	-	机箱UUID值
WeightKg	number	true	-	设备重量，单位:KG
WidthMm	number	true	-	机箱的宽度，单位mm
Drives {	object	true	-	驱动器资源的导航
}
NetworkAdapters {	object	true	-	指定机箱的网络适配器资源访问路径
}
PCIeDevices {	object	true	-	PCIe设备资源的导航
}
TrustedComponents {	object	true	-	可信组件集合资源的导航说明 openUBMC 25.12 LTS及以上版本支持
}

supported_methods

GET
PATCH
POST

HTTP methods

GET

命令功能

查询指定机箱资源信息

说明

GA140C等机型为纯液冷散热，响应体以实际返回结果为准。

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id

请求头:

text


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

请求消息体: 无

参数说明

参数	参数说明	取值
device_ip	登录设备的IP地址	IPv4或IPv6地址
chassis_id	机箱资源的ID	● 针对机架服务器，取值为1 ● 针对高密服务器，取值为BladeN（N表示节点槽位号），例如“Blade1” ● 针对刀片服务器，取值可以为BladeN（N表示计算节点槽位号）或 SwiN（N表示交换模块槽位号），例如“Swi1” ● 针对X6800 V5，X6000 V5，G5500，XA320 V2，CN221S V2，CM221S服务器，取值还可以为Enc，表示计算节点所在的机框资源
auth_value	执行该GET请求时，必须在“Headers”中携带“X-Auth-Token”值用于鉴权	可通过/redfish/v1/SessionService/Sessions创建会话时获得

使用指南

无

使用实例

请求样例：

http

GET <https://device_ip/redfish/v1/Chassis/1>

请求头：

text


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

请求消息体：无

响应样例：

json

{
"@odata.context": "/redfish/v1/$metadata#Chassis.Chassis",
"@odata.id": "/redfish/v1/Chassis/1",
"@odata.type": "#Chassis.v1_15_7.Chassis",
"Id": "1",
"Name": "Computer System Chassis",
"ChassisType": "Rack",
"Manufacturer": "",
"Model": "RH2288H V3",
"SerialNumber": "12345678",
"PartNumber": null,
"AssetTag": null,
"IndicatorLED": "Off",
"Status": {
"State": "Enabled",
"Oem": {
"Public": {
"Severity": "Informational"
}
},
"Health": "OK"
},
"MinPowerWatts": null,
"MaxPowerWatts": null,
"PowerState": "On",
"LocationIndicatorActive": false,
"Oem": {
"Public": {
"ChassisID": null,
"InletTemperatureCelsius": 30,
"BoardManufacturer": "BMCsoftware",
"DeviceSlotID": 1,
"EnclosureSerialNumber": "2102314XAD10QA100080",
"CabinetSerialNumber": "2102314XAD10QA100088",
"HeadNodeId": 1,
"DriveSummary": {
"Count": 1,
"Status": {
"Severity": "Informational",
"HealthRollup": "OK"
},
"Presence": "Present"
},
"SSDMediaLifeLeftPercentThreshold": 5,
"ThresholdSensors": {
"@odata.id": "/redfish/v1/Chassis/1/ThresholdSensors"
},
"DiscreteSensors": {
"@odata.id": "/redfish/v1/Chassis/1/DiscreteSensors"
},
"BackupBatteryUnits": {
"@odata.id": "/redfish/v1/Chassis/1/BackupBatteryUnits"
},
"NetworkAdaptersSummary": {
"Count": 3,
"Status": {
"Severity": "Informational",
"HealthRollup": "OK"
}
},
"PowerSupplySummary": {
"Count": 2,
"Status": {
"Severity": "Informational",
"HealthRollup": "OK"
}
},
"PackageCode": "xxxxxx",
"Boards": {
"@odata.id": "/redfish/v1/Chassis/1/Boards"
},
"DeviceMaxNum": {
"MemoryNum": 32,
"PCIeNum": 5,
"CPUNum": 4,
"NPUNum": 16,
"DiskNum": 8,
"PowerSupplyNum": 5,
"FanNum": 5,
"MezzCardNum": 5,
"SDCardNum": 0,
"SDContollerNum": 0,
"SecurityModuleNum": 0,
"BackupBatteryUnitNum": 1
},
"EnergyEfficiency": {
"EnergySavingsPercent": 5,
"PowerSavingsKwh": 2.545,
"CarbonFootprintReductionKg": 2.538
},
"Mainboard": {
"BoardName": BC62MBHA,
"SerialNumber": 024LKECNJ7001262
},
"SuperPodEnabled": true,
"SuperPodLabel": {
"SuperPodId": 0,
"ServerIndex": 0,
"SuperPodSize": 384,
"TopologyType": 1,
"UBMDeployMode": "InBandPhysicalOS",
"IsUBFabricMode": true,
"IsUBControlNode": true
},
"TopologyConfig": {
"Id": 23
},
"DigitalWarranty": {
"@odata.id": "/redfish/v1/Chassis/1/Oem/Public/DigitalWarranty"
},
"Actions": {
"#Chassis.ControlIndicatorLED": {
"target": "/redfish/v1/Chassis/1/Oem/Public/Actions/Chassis.ControlIndicatorLED",
"@Redfish.ActionInfo": "/redfish/v1/Chassis/1/ControlIndicatorLEDActionInfo"
},
"#Chassis.SuperPodLabelRestoreDefaults": {
"target": "/redfish/v1/Chassis/1/Oem/Public/Actions/Chassis.SuperPodLabelRestoreDefaults",
"@Redfish.ActionInfo": "/redfish/v1/Chassis/1/SuperPodLabelRestoreDefaultsActionInfo"
}
}
}
},
"Assembly": {
"@odata.id": "/redfish/v1/Chassis/1/Assembly"
},
"Thermal": {
"@odata.id": "/redfish/v1/Chassis/1/Thermal"
},
"LeakDetectors": {
"@odata.id": "/redfish/v1/Chassis/1/LeakDetectors"
},
"Power": {
"@odata.id": "/redfish/v1/Chassis/1/Power"
},
"PowerSubsystem": {
"@odata.id": "/redfish/v1/Chassis/1/PowerSubsystem"
},
"NetworkAdapters": {
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters"
},
"PCIeDevices": {
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices"
},
"Drives": {
"@odata.id": "/redfish/v1/Chassis/1/Drives"
},
"TrustedComponents": {
"@odata.id": "/redfish/v1/Chassis/1/TrustedComponents"
},
"Links": {
"ComputerSystems": [
{
"@odata.id": "/redfish/v1/Systems/1"
}
],
"ManagedBy": [
{
"@odata.id": "/redfish/v1/Managers/1"
}
],
"Drives": [
{
"@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk2"
}
],
"Processors": [
{
"@odata.id": "/redfish/v1/Systems/1/Processors/1"
},
{
"@odata.id": "/redfish/v1/Systems/1/Processors/Gpu2"
},
{
"@odata.id": "/redfish/v1/Systems/1/Processors/Npu1"
}
],
"PCIeDevices": []
}
}

响应码：200 请求样例：

http

GET <https://device_ip/redfish/v1/Chassis/Enc>

请求头：

text


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

请求消息体：无

响应样例：

json

{
"@odata.context": "/redfish/v1/$metadata#Chassis.Chassis",
"@odata.id": "/redfish/v1/Chassis/Enc",
"@odata.type": "#Chassis.v1_7_0.Chassis",
"Id": "Enc",
"Name": "Enclosure With Multiple Modules",
"ChassisType": "Enclosure",
"Manufacturer": "",
"Model": "test_02",
"SerialNumber": null,
"PartNumber": null,
"AssetTag": null,
"LocationIndicatorActive": false,
"Oem": {
"Public": {
"ChassisID": "0",
"PowerSupplySummary": {
"Count": 4,
"Status": {
"Severity": "Critical",
"HealthRollup": "Critical"
}
},
"Mainboard": {
"BoardName": "BC62MBHA",
"SerialNumber": "024LKECNJ7001262",
"Manufacturer": ""
},
"Boards": {
"@odata.id": "/redfish/v1/Chassis/Enc/Boards"
},
"HeadNodeId": 1
}
},
"Assembly": {
"@odata.id": "/redfish/v1/Chassis/Enc/Assembly"
},
"Thermal": {
"@odata.id": "/redfish/v1/Chassis/Enc/Thermal"
},
"Power": {
"@odata.id": "/redfish/v1/Chassis/Enc/Power"
},
"Links": {
"ManagedBy": [],
"Contains": [
{
"@odata.id": "/redfish/v1/Chassis/Blade2"
}
]
},
"Location": {
"Info": null,
"PartLocation": {
"LocationType": "Bay",
"LocationOrdinalValue": 1
}
}
}

响应码：200 请求样例：

http

GET <https://device_ip/redfish/v1/Chassis/Expansion1>

请求头：

text


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

请求消息体：无

响应样例：

json

{
"@odata.context": "/redfish/v1/$metadata#Chassis.Chassis",
"@odata.id": "/redfish/v1/Chassis/Expansion1",
"@odata.type": "#Chassis.v1_10_0.Chassis",
"Id": "Expansion1",
"Name": "JBOG Chassis 1",
"ChassisType": "Expansion",
"SerialNumber": "123456789",
"Oem": {
"Public": {
"HeadNodeId": null,
"BunchType": "GPU",
"BunchId": 0
}
},
"Links": {
"ManagedBy": [
{
"@odata.id": "/redfish/v1/Managers/Expansion1"
}
]
}
}

响应码：200

PATCH

命令功能

修改指定机箱资源信息

说明

GA140C等机型为纯液冷散热，响应体以实际返回结果为准。

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id

请求头:

text


X-Auth-Token: 123456789***********************
Content-Type: header_type
If-Match: ifmatch_value

请求消息体:

json

{
"AssetTag": AssetTag_value,
"IndicatorLED": state,
"LocationIndicatorActive": location_indicator_active,
"Oem": {
"Public": {
"SuperPodLabel": {
"SuperPodId": 0,
"ServerIndex": 0,
"SuperPodSize": 384,
"TopologyType": 1,
"IsUBFabricMode": true,
"IsUBControlNode": true
},
"SSDMediaLifeLeftPercentThreshold": 5
}
}
}

URL参数说明

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

请求头参数说明

参见请求头参数说明

请求体参数说明

参数	参数说明	取值
AssetTag	机箱资产标签	最大长度为48的字符串
IndicatorLED	机箱定位指示灯的状态	● Lit ● Off ● Blinking ● Unknown
LocationIndicatorActive	是否允许操作员物理定位该资源	● true：允许 ● false：不允许说明 openUBMC 26.03及以上版本支持。
SuperPodEnabled	是否按超节点组网	● true：按照超节点组网 ● false：按照非超节点组网说明 openUBMC 25.12 LTS及以上版本， A900 A3 SuperPoD，A800T A3，A800I A3机型支持
SuperPodLabel	超节点信息
SuperPodId	数字	超节点集合ID，默认值 4294967295(0xFFFFFFFF)，数据类型：U32，取值范围：0-4294967295(0xFFFFFFF F) 说明：修改SuperPodId的属性值后，需要复位NPU或者重启 OS，才能生效到NPU
ServerIndex	数字	超节点内的计算节点编号，默认值 65535(0xFFFF)，数据类型：U16，取值范围：0-65535(0xFFFF) 说明：修改ServerIndex的属性值后，需要复位NPU或者重启 OS，才能生效到NPU
SuperPodSize	数字	超节点规模(NPU卡数)，默认值384，取值范围：1-384 说明：修改SuperPodSize的属性值后，需要复位NPU或者重启 OS，才能生效到NPU
TopologyType	数字	节点拓扑类型，默认值0 0：普通8P Server 1：1D 2：2D 说明：修改TopologyType的属性值后，需要等下一次OS启动，才能生效到BIOS
IsUBFabricMode	布尔	服务器是否通过UB互联组集群，默认值true ● true：集群模式 ● false：单机模式说明：修改IsUBFabricMode的属性值后，需要等下一次 OS启动，才能生效到 BIOS
IsUBControlNode	布尔	是否为UB控制节点，默认值true ● true：控制节点 ● false：代理节点说明：修改IsUBControlNode的属性值后，需要等下一次 OS启动，才能生效到 BIOS
SSDMediaLifeLeftPercentThreshold	数字	整机的SSD剩余磨损率告警门限。说明 openUBMC 25.12 LTS及以上版本支持；可设置的范围为[1,50],默认值为5

使用指南

无

使用实例

请求样例：

http

PATCH <https://device_ip/redfish/v1/Chassis/1>

请求头：

text


X-Auth-Token: 123456789***********************
Content-Type: application/json
If-Match: W/"3d607e36"

请求消息体：

json

{
"AssetTag": "hello-123",
"IndicatorLED": "Lit",
"LocationIndicatorActive": true,
"Oem": {
"Public": {
"SuperPodEnabled": true,
"SuperPodLabel": {
"SuperPodId": 0,
"ServerIndex": 0,
"SuperPodSize": 384
},
"SSDMediaLifeLeftPercentThreshold": 5
}
}
}

响应样例：

json

{
"@odata.context": "/redfish/v1/$metadata#Chassis.Chassis",
"@odata.id": "/redfish/v1/Chassis/1",
"@odata.type": "#Chassis.v1_4_0.Chassis",
"Id": "1",
"Name": "Computer System Chassis",
"ChassisType": "Enclosure",
"Manufacturer": "",
"Model": "RH2288H V3",
"SerialNumber": "12345678",
"PartNumber": null,
"AssetTag": "hello-123",
"IndicatorLED": "Lit",
"Status": {
"State": "Enabled",
"Oem": {
"Public": {
"Severity": "Informational"
}
},
"Health": "OK"
},
"PowerState": "On",
"LocationIndicatorActive": true,
"Oem": {
"Public": {
"ChassisID": "3",
"InletTemperatureCelsius": 25,
"BoardManufacturer": "BMCsoftware",
"DriveSummary": {
"Count": 1,
"Status": {
"Severity": "Informational",
"HealthRollup": "OK"
}
},
"SSDMediaLifeLeftPercentThreshold": 5,
"ThresholdSensors": {
"@odata.id": "/redfish/v1/Chassis/1/ThresholdSensors"
},
"DiscreteSensors": {
"@odata.id": "/redfish/v1/Chassis/1/DiscreteSensors"
},
"BackupBatteryUnits": {
"@odata.id": "/redfish/v1/Chassis/1/BackupBatteryUnits"
},
"NetworkAdaptersSummary": {
"Count": 3,
"Status": {
"Severity": "Informational",
"HealthRollup": "OK"
}
},
"PowerSupplySummary": {
"Count": 2,
"Status": {
"Severity": "Informational",
"HealthRollup": "OK"
}
},
"PackageCode": "xxxxxx",
"Boards": {
"@odata.id": "/redfish/v1/Chassis/1/Boards"
},
"DeviceMaxNum": {
"MemoryNum": 16,
"PCIeNum": 2,
"CPUNum": 4,
"NPUNum": 16,
"DiskNum": 8,
"PowerSupplyNum": 5,
"FanNum": 5,
"MezzCardNum": 5,
"SDCardNum": 0,
"SDContollerNum": 0,
"SecurityModuleNum": 0,
"BackupBatteryUnitNum": 1
},
"EnergyEfficiency": {
"EnergySavingsPercent": 5,
"PowerSavingsKwh": 2.545,
"CarbonFootprintReductionKg": 2.538
},
"Mainboard": {
"BoardName": "BC62MBHA",
"SerialNumber": "024LKECNJ7001262",
"Manufacturer": ""
},
"SuperPodEnabled": true,
"SuperPodLabel": {
"SuperPodId": 0,
"ServerIndex": 0,
"SuperPodSize": 384
},
"TopologyConfig": {
"Id": 23
},
"DigitalWarranty": {
"@odata.id": "/redfish/v1/Chassis/1/Oem/Public/DigitalWarranty"
},
"Actions": {
"#Chassis.ControlIndicatorLED": {
"target": "/redfish/v1/Chassis/1/Oem/Public/Actions/Chassis.ControlIndicatorLED",
"@Redfish.ActionInfo": "/redfish/v1/Chassis/1/ControlIndicatorLEDActionInfo"
},
"#Chassis.SuperPodLabelRestoreDefaults": {
"target": "/redfish/v1/Chassis/1/Oem/Public/Actions/Chassis.SuperPodLabelRestoreDefaults",
"@Redfish.ActionInfo": "/redfish/v1/Chassis/1/SuperPodLabelRestoreDefaultsActionInfo"
}
}
}
},
"Assembly": {
"@odata.id": "/redfish/v1/Chassis/1/Assembly"
},
"Thermal": {
"@odata.id": "/redfish/v1/Chassis/1/Thermal"
},
"Power": {
"@odata.id": "/redfish/v1/Chassis/1/Power"
},
"NetworkAdapters": {
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters"
},
"PCIeDevices": {
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices"
},
"Drives": {
"@odata.id": "/redfish/v1/Chassis/1/Drives"
},
"Links": {
"ComputerSystems": [
{
"@odata.id": "/redfish/v1/Systems/1"
}
],
"ManagedBy": [
{
"@odata.id": "/redfish/v1/Managers/1"
}
],
"Drives": [
{
"@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk0"
}
],
"PCIeDevices": [
{
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/PCIeCard1"
}
]
}
}

响应码：200

POST (ACTION)

ControlIndicatorLED

命令功能

控制机箱定位指示灯状态

命令格式

URL: https://device_ip/redfish/v1/Chassis/Chassis_id/Oem/Public/Actions/Chassis.ControlIndicatorLED

请求头:

text


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

请求消息体:

json

{
"IndicatorLED": controltype,
"Duration": number
}

请求头参数说明

参见请求头参数说明

请求体参数说明

参数	参数说明	取值
Chassis_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
controltype	控制类型	● Lit：常亮 ● Off：熄灭 ● Blinking：闪烁
number	闪烁时间	设置控制类型为闪烁时的必要参数，闪烁时间，单位秒，取值范围1~255

使用指南

无

使用实例

请求样例：

http

POST <https://device_ip/redfish/v1/Chassis/1/Oem/Public/Actions/Chassis.ControlIndicatorLED>

请求头：

text


X-Auth-Token: 123456789***********************
Content-Type: application/json

请求消息体： ● 设置长亮点灯：

json

{
"IndicatorLED": "Lit"
}

● 设置长灭点灯：

json

{
"IndicatorLED": "Off"
}

● 设置闪烁点灯：

json

{
"IndicatorLED": "Blinking",
"Duration": 50
}

响应样例：

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)

SuperPodLabelRestoreDefaults

命令功能

恢复超节点配置信息为默认值

命令格式

URL: https://device_ip/redfish/v1/Chassis/Chassis_id/Oem/Public/Actions/Chassis.SuperPodLabelRestoreDefaults

请求头:

text


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

请求消息体:

json

{}

请求头参数说明

参见请求头参数说明

请求体参数说明

参数	参数说明	取值
Chassis_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/Chassis/1/Oem/Public/Actions/Chassis.SuperPodLabelRestoreDefaults>

请求头：

text


X-Auth-Token: 123456789***********************
Content-Type: application/json

请求消息体：

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)

Reset

命令功能

重启整机服务器

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id/Actions/Chassis.Reset

请求头:

text


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

请求消息体:

json

{
"ResetType": value
}

请求头参数说明

参见请求头参数说明

请求体参数说明

参数	参数说明	取值
chassis_id	机箱资源的ID	● 针对机架服务器，取值为1 ● 针对高密服务器，取值为BladeN（N表示节点槽位号），例如“Blade1” ● 针对刀片服务器，取值可以为EBladeN（N表示计算节点槽位号）或 SwiN（N表示交换模块槽位号），例如“Swi1” ● 针对X6800 V5，X6000 V5，G5500，XA320 V2服务器，取值还可以为Enc，表示计算节点所在的机框资源 ● 针对设备U位信息，取值可以为UN(N表示设备U位号)，例如"U1" ● 针对机柜资源，取值为 Rack
value	上下电类型	● On：上电（多个 system错峰上电） ● ForceOff：强制下电 ● GracefulShutdown：正常下电 ● ForceRestart：强制重启（多个system错峰重启） ● Nmi：触发不可屏蔽中断 ● ForcePowerCycle：强制下电再上电 ● GracefulPowerCycle：安全下电再上电

使用指南

无

使用实例

请求样例：

http

POST <https://device_ip/redfish/v1/Chassis/1/Actions/Chassis.Reset>

请求头：

text


X-Auth-Token: 123456789***********************
Content-Type: application/json

请求消息体：

json

{
"ResetType": "On"
}

响应样例：

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 ​

PATCH ​

POST (ACTION) ​

ControlIndicatorLED ​

POST (ACTION) ​

SuperPodLabelRestoreDefaults ​

POST (ACTION) ​

Reset ​

ResourceDefinition

uris

properties

supported_methods

HTTP methods

GET

PATCH

POST (ACTION)

ControlIndicatorLED

POST (ACTION)

SuperPodLabelRestoreDefaults

POST (ACTION)

Reset