EnvironmentMetrics
更新时间： 2026/09/24
在AtomGit上查看源码ResourceDefinition
uris
/redfish/v1/Chassis/chassis_id/EnvironmentMetrics
properties
| 名称 | 类型 | 是否只读 | 取值范围/枚举值 | 说明 |
|---|---|---|---|---|
| @odata.context | string | true | - | 环境指标信息资源模型的OData描述信息 |
| @odata.type | string | true | - | 任务资源类型 |
| @odata.id | string | true | - | ● 当前任务资源的访问路径 ● 说明 ● 您可以访问该资源，获取该任务的详细信息。 |
| Id | string | true | - | 任务ID |
| Name | string | true | - | 任务的名称 |
| PowerWatts { | object | true | - | - |
| PowerWatts.ApparentVA | number | true | - | 整机功耗视在功率 |
| PowerWatts.PhaseAngleDegrees | number | true | - | 相位角 |
| PowerWatts.PowerFactor | number | true | - | 功率因数 |
| PowerWatts.PowerReactiveVAR | number | true | - | 无功功率 |
| PowerWatts.Reading | number | true | - | 整机功耗读数 |
| PowerWatts.DataSourceUri | string | true | - | 数据源 |
| } | ||||
| EnergykWh { | object | true | - | - |
| EnergykWh.ApparentkVA | string | true | - | 能源消耗视在功率 |
| EnergykWh.LifetimekReading | number | true | - | 累计总耗能 |
| EnergykWh.ReactivekVARh | number | true | - | 无功功率 |
| EnergykWh.Reading | number | true | - | 当前能耗读数 |
| EnergykWh.SensorResetTime | string | true | - | 上次清零时间 |
| EnergykWh.DataSourceUri | string | true | - | 数据源 |
| } | ||||
| TemperatureCelsius { | object | true | - | - |
| TemperatureCelsius.Reading | number | true | - | 进风口温度读数 |
| TemperatureCelsius.DataSourceUri | string | true | - | 数据源 |
| } | ||||
| Actions { | object | true | - | - |
| Actions.#EnvironmentMetrics.ResetMetrics { | object | true | - | - |
| Actions.#EnvironmentMetrics.ResetMetrics.target | string | true | - | ResetMetrics操作目标 |
| Actions.#EnvironmentMetrics.ResetMetrics.@Redfish.ActionInfo | string | true | - | ResetMetrics操作信息链接 |
| } | ||||
| } |
supported_methods
- GET
HTTP methods
GET
命令功能
查询设备环境指标信息资源。
命令格式
URL: https://device_ip/redfish/v1/Chassis/chassis_id/EnvironmentMetrics
请求头:
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服务器，取值还可以为Enc，表示计算节点所在的机框资源 ● 针对设备U位信息，取值可以为UN(N表示设备U位号)，例如"U1" ● 针对机柜资源，取值为Rack |
| auth_value | 执行该GET请求时，必须在“Headers”中携带“X-Auth-Token”值用于鉴权 | 可通过/redfish/v1/SessionService/Sessions创建会话时获得 |
使用指南
BMC500 5.14.0及以上版本支持。
使用实例
请求样例：
http
GET https://device_ip/redfish/v1/Chassis/1/EnvironmentMetrics请求头：
X-Auth-Token: 123456789***********************请求消息体：无
响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#EnvironmentMetrics.EnvironmentMetrics",
"@odata.type": "#EnvironmentMetrics.v1_5_0.EnvironmentMetrics",
"@odata.id": "/redfish/v1/Chassis/1/EnvironmentMetrics",
"Id": "EnvironmentMetrics",
"Name": "Chassis Environment Metrics",
"PowerWatts": {
"ApparentVA": null,
"PhaseAngleDegrees": null,
"PowerFactor": null,
"PowerReactiveVAR": null,
"Reading": 242,
"DataSourceUri": "/redfish/v1/Chassis/1/Sensors/Power.29"
},
"EnergykWh": {
"ApparentkVA": null,
"LifetimekReading": null,
"ReactivekVARh": null,
"Reading": 0.3333,
"SensorResetTime": "2026-06-16T17:20:00",
"DataSourceUri": null
},
"TemperatureCelsius": {
"Reading": 31,
"DataSourceUri": "/redfish/v1/Chassis/1/Sensors/InletTemp.16"
}
"Actions": {
"#EnvironmentMetrics.ResetMetrics": {
"target": "/redfish/v1/Chassis/1/EnvironmentMetrics/Actions/EnvironmentMetrics.ResetMetrics",
"@Redfish.ActionInfo": "/redfish/v1/Chassis/1/EnvironmentMetrics/ResetMetricsActionInfo"
}
}
}响应码：200