GET – 服务器 PCIe 设备

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

请求 URL

GET https://<BMC_IPADDR>/redfish/v1/Chassis/1/PCIeDevices/{Location}

请求正文

无

响应正文

字段				类型	描述
Id				字符串	Id 属性用于唯一标识此 PCIe 设备。
DeviceType				字符串	此 PCIe 设备的设备类型。
FirmwareVersion				字符串	此 PCIe 设备的固件版本。
SKU				字符串	这是此 PCIe 设备的 SKU。
PCIeFunctions				对象	相关 PCIeFunctions 的链接。
Links				对象	展开
	Chassis			链接	机箱资源的链接。
	PCIeFunctions			链接	相关 PCIeFunctions 的链接。
	Links/PCIeFunctions@ Redfish.Deprecated			字符串	此属性已弃用。请改用 PCIeFunctions。
Manufacturer				字符串	这是此 PCIe 设备的制造商。
Model				字符串	这是 PCIe 设备的型号。
Name				字符串	此 PCIe 设备的 VPD 中的卡名，如果是板载 PCIe 设备，请在末尾添加“(onboard)”。如果没有 VPD 数据，此属性将为“Adapter”。
PartNumber				字符串	此 PCIe 设备的部件号。
SerialNumber				字符串	此 PCIe 设备的序列号。
PCIeInterface				对象	这些属性应包含某个 Redfish 实现的 PCIe 接口的定义。
	LanesInUse			整数	此设备使用的 PCIe 通道数。
	MaxPCIeType			字符串	此设备支持的 PCIe 规范的最高版本。
	MaxLanes			整数	此设备支持的 PCIe 通道数。
	PCIeType			字符串	正在使用的 PCIe 规范的版本。
Status				对象	展开
	State			字符串	Enabled
	Health			字符串	表示此资源的运行状况状态。
Description				字符串	“This resource represents the properties of a PCIeDevice attached to a System.”
Slot				对象	已展开
	Location			对象	已展开
		InfoFormat		字符串	Info 属性的格式。“Slot X”或“OnBoard”。
		Info		字符串	资源的位置：Slot {N}（N 是插槽编号）或“OnBoard”。
		PartLocation		对象	已展开。部件位置。
			ServiceLabel	字符串	部件位置的标签。对于 PCIeCard，值为“PCIe X”（X 是插槽编号）。对于板载设备，值为“OnBoard”。
			LocationType	字符串	PCIe 设备的位置类型。固定值：Slot
			LocationOrdinalValue	整数	表示部件位置的数字。如果 LocationType 为“slot”，而此单元位于插槽 2 中，则 LocationOrdinalValue 为 2。

状态代码

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

示例

返回以下示例 JSON 响应：

{
    "PCIeInterface": {
        "LanesInUse": 8,
        "MaxPCIeType": "Gen4",
        "MaxLanes": 8,
        "PCIeType": "Gen4"
    },
    "FirmwareVersion": "52.22.0-4475",
    "Slot": {
        "Location": {
            "InfoFormat": "Slot X",
            "PartLocation": {
                "ServiceLabel": "PCIe 2",
                "LocationType": "Slot",
                "LocationOrdinalValue": 2
            },
            "Info": "Slot 2"
        }
    },
    "PartNumber": "SR17A32440",
    "SKU": "01PE818",
    "Links": {
        "Links/PCIeFunctions@Redfish.Deprecated": "The property is deprecated. Please use PCIeFunctions instead.",
        "Chassis": [
            {
                "@odata.id": "/redfish/v1/Chassis/1"
            }
        ],
        "PCIeFunctions": [
            {
                "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/slot_2/PCIeFunctions/slot_2.00"
            }
        ]
    },
    "@odata.etag": "\"907b2398e42d2ff67233e\"",
    "PCIeFunctions": {
        "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/slot_2/PCIeFunctions"
    },
    "Description": "This resource represents the properties of a PCIeDevice attached to a System.",
    "Status": {
        "Health": "OK",
        "State": "Enabled"
    },
    "Name": "ThinkSystem RAID 940-16i 8GB Flash PCIe Gen4 12Gb Adapter",
    "@odata.type": "#PCIeDevice.v1_9_0.PCIeDevice",
    "DeviceType": "SingleFunction",
    "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/slot_2",
    "@odata.context": "/redfish/v1/$metadata#PCIeDevice.PCIeDevice",
    "Oem": {
        …
    },
    "SerialNumber": "L1FM195SA55",
    "Model": "SAS3916",
    "Id": "slot_2",
    "Manufacturer": "Lenovo"
} {
    "SerialNumber": null,
    "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/slot_3",
    "Links": {
        "Links/PCIeFunctions@Redfish.Deprecated": "The property is deprecated. Please use PCIeFunctions instead.",
        "Chassis": [
            {
                "@odata.id": "/redfish/v1/Chassis/1"
            }
        ],
        "PCIeFunctions": [
            {
                "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/slot_3/PCIeFunctions/slot_3.00"
            }
        ]
    },
    "PCIeFunctions": {
        "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/slot_3/PCIeFunctions"
    },
    "PCIeInterface": {
        "LanesInUse": null,
        "MaxLanes": null,
        "MaxPCIeType": "Gen3"
    },
    "PartNumber": null,
    "Description": "This resource represents the properties of a PCIeDevice attached to a System.",
    "FirmwareVersion": null,
    "Status": {
        "State": "Enabled",
        "Health": "OK"
    },
    "Name": "Adapter",
    "Id": "slot_3",
    "Oem": {
        "Lenovo": {
            "@odata.type": "#LenovoDeviceInfo.v1_0_0.LenovoDeviceInfo",
            "Location": {
                "PartLocation": {
                    "LocationType": "Slot",
                    "ServiceLabel": "PCIe 3",
                    "LocationOrdinalValue": 3
                },
                "InfoFormat": "Slot X",
                "Info": "Slot 3",
                "Info@Redfish.Deprecated": "The property is deprecated. Please use PartLocation instead.",
                "InfoFormat@Redfish.Deprecated": "The property is deprecated. Please use PartLocation instead."
            }
        }
    },
    "@odata.type": "#PCIeDevice.v1_4_0.PCIeDevice",
    "SKU": null,
    "Manufacturer": null,
    "@odata.etag": "\"e7a9cb060992cf9c73f21a48370932b8\"",
    "Model": null,
    "DeviceType": "SingleFunction"
}

提供反馈

GET – 服务器 PCIe 设备

请求 URL​

请求正文​

响应正文​

状态代码​

示例​

请求 URL

请求正文

响应正文

状态代码

示例