GET – 电源管理属性

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

请求 URL

GET https://<BMC_IPADDR>/redfish/v1/Chassis/1/Power

请求正文

无

响应正文

字段					类型	描述
Id					字符串	Power
Description					字符串	“Power Consumption and Power Limiting”
Name					字符串	电源资源的名称。始终设置为 Power。
PowerControl					数组	这是电源控制功能（功率读数/限制）的定义。
	PowerControl[1]				对象	这是 PowerControl 数组的可寻址成员的基类型。
		MemberId			字符串	此 PowerControl 数组的索引。
		Name			字符串	电源控制功能名称。始终设置为“Server Power Control”。
		PhysicalContext			字符串	此电源控制适用的区域、设备或设备组。
		PowerConsumedWatts			数字	机箱消耗的实际功率。
		PowerCapacityWatts			数字	可供机箱分配的功率总量。此数字可能是电源模块容量或从上游机箱分配给此机箱的功率预算。
		PowerMetrics			对象	此机箱的功率读数。注如果此系统的层级小于 2，则此对象将被隐藏。
			IntervalInMin		数字	测量 PowerMetrics 的时间间隔（或窗口）。始终设置为 1。
			MinConsumedWatts		数字	测量窗口（最后 IntervalInMin 分钟）内的最低功耗水平。
			MaxConsumedWatts		数字	测量窗口（最后 IntervalInMin 分钟）内的最高功耗水平。
			AverageConsumedWatts		数字	测量窗口（最后 IntervalInMin 分钟）内的平均功耗水平。
		PowerLimit			对象	此机箱的功率限制状态和配置信息。注如果此系统的层级小于 3 或者是 AMD 系统，则此对象将被隐藏。
			LimitInWatts		数字	功率限制（以瓦为单位）。设置为 null 将禁用功率上限。
			LimitException		字符串	无法将功率维持在低于 LimitInWatts 时执行的操作。始终设置为“NoAction”。
		Status			对象	描述资源及其子项的状态和运行状况。
			State		字符串	指示资源的已知状态，例如是否已启用。始终设置为“Enabled”。
			Health		字符串	“OK”
		RelatedItem			数组	机箱资源的链接数组。
			RelatedItem[1]		链接	机箱资源的引用链接。
	PowerControl[2]				对象	这是 PowerControl 数组的可寻址成员的基类型。
		MemberId			字符串	此 PowerControl 数组的索引。
		Name			字符串	电源控制功能名称。始终设置为“CPU Sub-system Power”。
		PhysicalContext			字符串	此电源控制适用的区域、设备或设备组。始终设置为“CPUSubsystem”。
		PowerConsumedWatts			数字	CPUSubsystem 消耗的实际功率。
		PowerMetrics			对象	此 CPUSubsystem 的功率读数。注如果此系统的层级小于 2，则此对象将被隐藏。
			IntervalInMin		整数	测量 PowerMetrics 的时间间隔（或窗口）。始终设置为 1。
			MinConsumedWatts		数字	测量窗口（最后 IntervalInMin 分钟）内的最低功耗水平。
			MaxConsumedWatts		数字	测量窗口（最后 IntervalInMin 分钟）内的最高功耗水平。
			AverageConsumedWatts		数字	测量窗口（最后 IntervalInMin 分钟）内的平均功耗水平。
		Status			对象	描述资源及其子项的状态和运行状况。
			State		字符串	指示资源的已知状态，例如是否已启用。始终设置为“Enabled”。
			Health		字符串	“OK”
		RelatedItem			数组	处理器资源的链接数组
			RelatedItem[1]		链接	处理器资源的引用链接
	PowerControl[3]				对象	这是 PowerControl 数组的可寻址成员的基类型。注 AMD 系统不支持此对象。
		MemberId			字符串	此 PowerControl 数组的索引。
		Name			字符串	电源控制功能名称。始终设置为“Memory Sub-system Power”。
		PhysicalContext			字符串	此电源控制适用的区域、设备或设备组。始终设置为“MemorySubsystem”。
		PowerConsumedWatts			数字	MemorySubsystem 消耗的实际功率。
		PowerMetrics			对象	此 MemorySubsystem 的功率读数。注如果此系统的层级小于 2，则此对象将被隐藏。
			IntervalInMin		整数	测量 PowerMetrics 的时间间隔（或窗口）。始终设置为 1。
			MinConsumedWatts		数字	测量窗口（最后 IntervalInMin 分钟）内的最低功耗水平。
			MaxConsumedWatts		数字	测量窗口（最后 IntervalInMin 分钟）内的最高功耗水平。
			AverageConsumedWatts		数字	测量窗口（最后 IntervalInMin 分钟）内的平均功耗水平。
		Status			对象	描述资源及其子项的状态和运行状况。
			State		字符串	指示资源的已知状态，例如是否已启用。始终设置为“Enabled”。
			Health		字符串	“OK”
		RelatedItem			数组	机箱资源的链接数组
			RelatedItem[1]		链接	机箱资源的引用链接
Redundancy					数组	此系统或设备的电源子系统的冗余信息。项数始终设置为 1。
	Redundancy[1]				对象	指示电源模块冗余的详细信息。
		Name			字符串	“PSU Redundancy”
		MemberId			字符串	此 Redundancy 数组的索引。
		Mode			字符串	“N+m”
		MaxNumSupported			整数	此特定冗余组允许的最大成员数。
		MinNumNeeded			整数	此组实现冗余所需的最小成员数。值为 2
		RedundancyEnabled			布尔	指示是否启用了冗余。
		Status			对象	描述资源及其子项的状态和运行状况。
			State		字符串	指示此冗余的已知状态。有效值： “Enabled”：已启用此功能或资源 “Disabled”：已禁用此功能或资源 “Absent”：指示此 PSU 插槽中未安装 PSU
			Health		字符串	指示此冗余的运行状况状态。有效值： “OK”：正常 “Warning”：存在需要注意的状况 “Critical”：存在需要立即关注的紧急状况
		RedundancySet			数组	这是冗余集的定义。项数是 Power 的 PowerSupplies 数量。
			RedundancySet[N]		链接	Power 的 PowerSupplies 的链接。
PowerSupplies					数组	与此系统或设备关联的电源模块的详细信息。项数是此系统中安装的电源模块的数量。
	PowerSupplies[N]				对象	与此系统或设备关联的电源模块的详细信息。
		MemberId			字符串	这是集合中成员的标识符。此字符串为 PSU ID，如“1”。
		Name			字符串	电源模块的名称。此字符串以“PSU”开头，后跟 PSU ID，如“PSU1”。
		Location			对象	电源模块的位置。
			PartLocation		对象	部件位置。
				ServiceLabel	字符串	部件位置标签，如丝印名称或印刷标签。始终设置为“PSU”+ psu_id。
				LocationType	字符串	部件位置类型，如 slot、bay 和 socket。始终设置为“Slot”。
				LocationOrdinalValue	整数	表示部件位置的数字。如果 LocationType 为“slot”，而此单元位于插槽 2 中，则 LocationOrdinalValue 为 2。
		Model			字符串	此电源模块的型号。
		FirmwareVersion			字符串	此电源模块的固件版本。固件字符串包含 PowerSupply OEM 部分中定义的主固件版本和辅助固件版本。
		SerialNumber			字符串	此电源模块的序列号。
		PartNumber			字符串	此电源模块的部件号。
		PowerCapacityWatts			数字	此电源模块的最大容量。
		PowerInputWatts			数字	此电源模块的实测输入功率。
		PowerOutputWatts			数字	此电源模块的实测输出功率。
		PowerSupplyType			字符串	电源模块类型（交流或直流）。有效值： “Unknown”：无法确定电源模块类型 “AC”：交流（AC）电源模块 “DC”：直流（DC）电源模块 “ACorDC”：电源模块同时支持直流和交流
		Status			对象	描述资源及其子项的状态和运行状况。
			State		字符串	指示此电源模块的已知状态。有效值： “Enabled”：已启用此功能或资源 “Disabled”：已禁用此功能或资源 “Absent”：指示此 PSU 插槽中未安装 PSU
		RelatedItem			数组	机箱资源的链接数组。
			RelatedItem[1]		链接	机箱资源的引用链接。
		Manufacturer			字符串	此电源模块的制造商。
Voltages					数组	这是电压传感器的定义。项数是此系统中的电压传感器的数量。
	Voltages[N]				对象	电压传感器的定义。
		MemberId			字符串	此 Voltages 数组的索引
		Name			字符串	电压传感器名称。
		Status			对象	描述资源及其子项的状态和运行状况。
			State		字符串	指示此电压传感器的已知状态。有效值： “Enabled”：已启用此功能或资源 “Disabled”：已禁用此功能或资源
			Health		字符串	指示此电压传感器的运行状况状态。有效值： “OK”：正常 “Warning”：存在需要注意的状况 “Critical”：存在需要立即关注的紧急状况
		ReadingVolts			数字	电压传感器的当前值。如果此电压传感器的 State 为“Disabled”，“ReadingVolts”将被隐藏。
		UpperThresholdNonCritical			数字	高于正常范围。
		UpperThresholdCritical			数字	高于正常范围，但尚未达到致命程度。
		UpperThresholdFatal			数字	高于正常范围，且达到致命程度。
		LowerThresholdNonCritical			数字	低于正常范围。
		LowerThresholdCritical			数字	低于正常范围，但尚未达到致命程度。
		LowerThresholdFatal			数字	低于正常范围，且达到致命程度。
		MinReadingRange			数字	CurrentReading 的最小值。
		MaxReadingRange			数字	CurrentReading 的最大值。
		PhysicalContext			字符串	描述此电压测量适用的区域或设备。始终设置为“VoltageRegulator”。 “VoltageRegulator”：稳压器设备
		RelatedItem			数组	描述此温度测量适用的区域或设备。项数为 2。
			RelatedItem[1]		链接	/redfish/v1/Systems/1
			RelatedItem[2]		链接	/redfish/v1/Chassis/1

状态代码

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

示例

返回以下示例 JSON 响应：

{
    "@odata.context": "/redfish/v1/$metadata#Power.Power",
    "@odata.etag": "\"54030DE7\"",
    "@odata.id": "/redfish/v1/Chassis/1/Power",
    "@odata.type": "#Power.v1_5_2.Power",
    "Description": "Power Consumption and Power Limiting",
    "Id": "Power",
    "Name": "Power",
    "PowerControl": [
        {
            "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerControl/0",
            "MemberId": "0",
            "Name": "Server Power Control",
            "PhysicalContext": "Chassis",
            "PowerCapacityWatts": 2000,
            "PowerConsumedWatts": 545,
            "PowerLimit": {
                "LimitException": "NoAction",
                "LimitInWatts": null
            },
            "PowerMetrics": {
                "AverageConsumedWatts": 498,
                "IntervalInMin": 1,
                "MaxConsumedWatts": 500,
                "MinConsumedWatts": 497
            },
            "RelatedItem": [
                {
                    "@odata.id": "/redfish/v1/Chassis/1"
                }
            ],
            "RelatedItem@odata.count": 1,
            "Status": {
                "Health": "OK",
                "State": "Enabled"
            }
        },
        {
            "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerControl/1",
            "MemberId": "1",
            "Name": "CPU Sub-system Power",
            "PhysicalContext": "CPUSubsystem",
            "PowerConsumedWatts": 193,
            "PowerMetrics": {
                "AverageConsumedWatts": 171,
                "IntervalInMin": 1,
                "MaxConsumedWatts": 171,
                "MinConsumedWatts": 171
            },
            "RelatedItem": [
                {
                    "@odata.id": "/redfish/v1/Systems/1/Processors"
                }
            ],
            "RelatedItem@odata.count": 1,
            "Status": {
                "Health": "OK",
                "State": "Enabled"
            }
        },
        {
            "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerControl/2",
            "MemberId": "2",
            "Name": "Memory Sub-system Power",
            "PhysicalContext": "MemorySubsystem",
            "PowerConsumedWatts": 27,
            "PowerMetrics": {
                "AverageConsumedWatts": 26,
                "IntervalInMin": 1,
                "MaxConsumedWatts": 26,
                "MinConsumedWatts": 26
            },
            "RelatedItem": [
                {
                    "@odata.id": "/redfish/v1/Systems/1/Memory"
                }
            ],
            "RelatedItem@odata.count": 1,
            "Status": {
                "Health": "OK",
                "State": "Enabled"
            }
        }
    ],
    "PowerControl@odata.count": 3,
    "PowerSupplies": [
        {
            "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/0",
            "Id": "PSU1",
            "Location": {
                "PartLocation": {
                    "LocationOrdinalValue": 1,
                    "LocationType": "Slot"
                }
            },
            "MemberId": "0",
            "Name": "PSU1",
            "RelatedItem": [
                {
                    "@odata.id": "/redfish/v1/Chassis/1"
                }
            ],
            "Status": {
                "Health": "OK"
            }
        },
        {
            "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/1",
            "Id": "PSU2",
            "Location": {
                "PartLocation": {
                    "LocationOrdinalValue": 2,
                    "LocationType": "Slot"
                }
            },
            "MemberId": "1",
            "Name": "PSU2",
            "RelatedItem": [
                {
                    "@odata.id": "/redfish/v1/Chassis/1"
                }
            ],
            "Status": {
                "Health": "OK"
            }
        }
    ],
    "Redundancy": [
        {
            "@odata.id": "/redfish/v1/Chassis/1/Power#/Redundancy/0",
            "MaxNumSupported": 2,
            "MemberId": "0",
            "MinNumNeeded": 2,
            "Mode": "N+m",
            "Name": "PSU Redundancy",
            "RedundancyEnabled": true,
            "RedundancyGroup": [
                {
                    "@odata.id": "/redfish/v1/Chassis/1/PowerSubsystem/PowerSupplies/PSU1"
                }
            ],
            "RedundancySet": [
                {
                    "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/0"
                },
                {
                    "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/1"
                }
            ],
            "Status": {
                "Health": "OK",
                "State": "Enabled"
            }
        }
    ],
    "Redundancy@odata.count": 1,
    "Voltages": [
        {
            "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/0",
            "@odata.type": "#Power.v1_0_0.Voltage",
            "LowerThresholdCritical": 2.249,
            "LowerThresholdNonCritical": 2.392,
            "MaxReadingRange": 3.4125035351104405,
            "MemberId": "0",
            "MinReadingRange": 0.0,
            "Name": "CMOS Battery",
            "PhysicalContext": "VoltageRegulator",
            "ReadingVolts": 3.1013,
            "RelatedItem": [
                {
                    "@odata.id": "/redfish/v1/Chassis/1"
                },
                {
                    "@odata.id": "/redfish/v1/Systems/1"
                }
            ],
            "Status": {
                "Health": "OK",
                "State": "Enabled"
            }
        }
    ]
}

提供反馈

GET – 电源管理属性

请求 URL​

请求正文​

响应正文​

状态代码​

示例​

请求 URL

请求正文

响应正文

状态代码

示例