Chassis
更新时间: 2026/06/26
在Gitcode上查看源码

ResourceDefinition

uris

  • /redfish/v1/Chassis/chassis_id

properties

名称类型是否只读取值范围/枚举值说明
@odata.contextstringtrue-指定机箱资源模型的OData描述信息
@odata.idstringtrue-指定机箱资源的访问路径
@odata.typestringtrue-指定机箱资源的类型
Idstringtrue-指定机箱资源的ID,为机箱在机箱集合中的唯一标识
Namestringtrue-指定机箱资源的名称
ChassisTypestringtrue-机箱类型,包括:
● Rack
● Blade
● Enclosure
● StandAlone
● RackMount
● Card
● Cartridge
● Row
● Pod
● Expansion
● Sidecar
● Zone
● Sled
● Shelf
● Drawer
● Module
● Component
● Other
Manufacturerstringtrue-机箱厂商信息
Modelstringtrue-机箱型号信息
SerialNumberstringtrue-机箱序列号
PartNumberstringtrue-机箱部件号
AssetTagstringfalse-机箱资产标签
IndicatorLEDstringfalse-指定机箱资源的定位指示灯的状态,包括:
● Lit
● Off
● Blinking
● Unknown
Statusobjecttrue-指定机箱资源的状态,包括:
● State:机箱是否使能
● Health:机箱健康状态
● Severity:机箱的自定义健康状态
MinPowerWattsnumbertrue-机箱的功耗下限
MaxPowerWattsnumbertrue-机箱的功耗上限
PowerStatestringtrue-当前机箱电源状态,包括:
● On:机箱内的组件已通电
● Off:机箱内的组件未通电,但某些组件(如管理控制器)可能仍具有辅助电源
LocationIndicatorActivebooleanfalse-是否允许操作员物理定位该资源 说明 BMC500 5.13.0及以上版本支持。
ChassisIDstringtrue-指定机箱资源的机框号
ChassisLocationstringtrue-指定机箱资源的机框位置
InletTemperatureCelsiusnumbertrue-指定机箱资源的进风口温度 说明 已屏蔽该属性值频繁变化导致的事件上报
BoardManufacturerstringtrue-单板厂商信息
DeviceSlotIDnumbertrue-节点设备槽位号
EnclosureSerialNumberstringtrue-机框序列号
CabinetSerialNumberstringtrue-机柜序列号
HeadNodeIdnumbertrue-机头ID,默认为null,表示未分配
BunchTypestringtrue-机头扩展的功能类型。 包括:
● GPU
BunchIdnumbertrue-机箱资源的ID,默认为null,表示未分配
Countnumbertrue-硬盘个数
Statusobjecttrue-硬盘健康状态
SSDMediaLifeLeftPercentThresholdnumberfalse-整机的SSD剩余磨损率告警门限 说明 BMC300 5.12.0及以上版本支持; 可设置的范围为[1,50],默认值为5
ThresholdSensorsobjecttrue-连续型传感器资源列表导航
DiscreteSensorsobjecttrue-离散型传感器资源列表导航
BackupBatteryUnitsobjecttrue-备电集合资源导航
Countnumbertrue-网卡个数
Statusobjecttrue-网卡健康状态
Countnumbertrue-电源个数
Statusobjecttrue-电源健康状态
● On
● Off
● PoweringOn
● PoweringOff
PackageCodestringtrue-服务器套餐编码
Boardsobjecttrue-扩展板卡资源导航:包括:
● @odata.id:扩展板卡资源的访问路径
MemoryNumnumbertrue-内存最大个数
PCIeNumnumbertrue-PCIe卡最大个数
CPUNumnumbertrue-CPU最大个数
DiskNumnumbertrue-硬盘最大个数
PowerSupplyNumnumbertrue-电源最大个数
FanNumnumbertrue-风扇最大个数
MezzCardNumnumbertrue-Mezz卡最大个数
SDCardNumnumbertrue-SD卡最大个数
SDContollerNumnumbertrue-SD控制器最大个数
SecurityModuleNumnumbertrue-安全模块最大个数
BackupBatteryUnitNumnumbertrue-备电单元最大个数
EnergySavingsPercentnumbertrue-本服务器相比于其他厂商同类设备节省能源的比例
PowerSavingsKwhnumbertrue-本服务器节省的电量
CarbonFootprintReductionKgnumbertrue-本服务器减少的碳排放量
BoardNamestringtrue-主板名称
SerialNumberstringtrue-主板序列号
Typestringtrue-机框类型
PartNumberstringtrue-单板域部件号
SerialNumberstringtrue-单板域序列号
ManufacturingDatestringtrue-单板域制造日期
Manufacturerstringtrue-单板域制造商
ProductNamestringtrue-单板域产品名
SuperPodEnabledbooleanfalse-是否按超节点组网
● true
● false 说明 BMC300 5.8.3.27及以上版本,A900 A3 SuperPoD, A800T A3,A800I A3机型支持
SuperPodIdnumberfalse-超节点集合ID,默认值4294967295(0xFFFFFFFF ),数据类型:U32,取值范围: 0-4294967295(0xFFFFFF FF)
ServerIndexnumberfalse-超节点内的计算节点编号,默认值65535(0xFFFF),数据类型:U16,取值范围: 0-65535(0xFFFF)
SuperPodSizenumberfalse-超节点规模(NPU卡数), 默认值384,取值范围: 1-384
TopologyTypenumberfalse-节点拓扑类型,默认值:0 0:普通8P Server 1:1D 2:2D
UBMDeployModestringtrue-服务器UBM部署位置
● InBandPhysicalOS (带内物理机)
● InBandVirtualOS(带内虚拟机)
● OutofBand(带外物理机)
IsUBFabricModebooleanfalse-服务器是否通过UB互联组集群,默认值:true
● true:集群模式
● false:单机模式
IsUBControlNodebooleanfalse-是否为UB控制节点,默认值:true
● true:控制节点
● false:代理节点
Idnumbertrue-拓扑配置Id
@odata.idstringtrue-电子保单资源访问路径
#Chassis.ControlIndicatorLEDobjecttrue-控制定位灯状态
@Redfish.ActionInfostringtrue-控制定位灯的查询路径
targetstringtrue-控制定位灯的访问路径
#Chassis.SuperPodLabelRestoreDefaultsobjecttrue-SuperPodLabel恢复默认值
@Redfish.ActionInfostringtrue-SuperPodLabel恢复默认值访问路径
targetstringtrue-SuperPodLabel恢复默认值参数查询路径
@odata.idstringtrue-各属性的访问路径
ComputerSystems.ManagedByarraytrue-相关对象的链接
Processorsarraytrue-处理器资源的导航
PCIeDevicesarraytrue-PCIe设备资源的导航
Drivesarraytrue-驱动器资源的导航
TrustedComponentsobjecttrue-可信组件集合资源的导航 说明 BMC300 5.12.0.1及以上版本支持
Infostringtrue-机箱位置

supported_methods

  • GET
  • PATCH
  • POST

HTTP methods

GET

命令功能

查询指定机箱资源信息

说明

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

命令格式

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

请求头:


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

请求头:


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"
        }
      },
      "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

请求头:


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
  }
}

响应码:200 请求样例:

http
GET https://device_ip/redfish/v1/Chassis/Expansion1

请求头:


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

请求头:


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
    }
  }
}

请求头参数说明

参见 请求头参数说明

请求体参数说明

参数参数说明取值
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_value机箱资产标签最大长度为48的字符串
state机箱定位指示灯的状态● Lit
● Off
● Blinking
● Unknown
location_indicator_active是否允许操作员物理定位 该资源● true:允许
● false:不允许 说明 在BMC500 5.13.0 及以 上版本支持。
SuperPodEnabled是否按超节点组网● true:按照超节点组网
● false:按照非超节点组 网 说明 BMC300 5.8.3.27及以上版 本,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剩余磨损率告 警门限 说明 BMC300 5.12.0及以上版本 支持; 可设置的范围为[1,50],默认 值为5

使用指南

使用实例

请求样例:

http
PATCH https://device_ip/redfish/v1/Chassis/1

请求头:


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

请求头:


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

请求头:


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

请求头:


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

请求头:


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

请求头:


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

请求头:


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