ResourceDefinition

uris

/redfish/v1/Chassis/chassis_id/PCIeDevices/pciedevices_id/PCIeFunctions/functions_id

properties

名称	类型	是否只读	取值范围/枚举值	说明
@odata.context	string	true	-	指定PCIe功能资源的OData描述信息
@odata.id	string	true	-	指定PCIe功能资源的访问路径
@odata.type	string	true	-	指定PCIe功能资源的类型
Id	string	true	-	指定PCIe功能资源ID
Name	string	true	-	指定PCIe功能资源名称
DeviceId	string	true	-	指定PCIe设备的DID
VendorId	string	true	-	指定PCIe设备的VID
SubsystemId	string	true	-	指定PCIe设备的SDID
SubsystemVendorId	string	true	-	指定PCIe设备的SVID
DeviceClass	string	true	-	指定PCIe设备分类包括： ● UnclassifiedDevice ● MassStorageController ● NetworkController ● DisplayController ● MultimediaController ● MemoryController ● Bridge ● CommunicationController ● GenericSystemPeripheral ● InputDeviceController ● IntelligentController ● SatelliteCommunicationsController ● EncryptionController ● SignalProcessingController ● ProcessingAccelerators ● NonEssentialInstrumentation ● Coprocessor ● UnassignedClass ● Other
FunctionId	number	true	-	指定PCIe设备根端口功能号
FunctionProtocol	string	true	-	指定PCIe设备的协议说明 BMC300 5.10.0及以上版本支持
FunctionType	string	true	-	指定PCIe设备的类型说明 BMC300 5.10.0及以上版本支持
SegmentNumber	string	true	-	指定PCIe设备端口段号
BusNumber	string	true	-	新URL：指定PCIe功能的总线号，旧URL：指定PCIe设备根端口总线号
DeviceNumber	string	true	-	新URL：指定PCIe功能的设备号，旧URL：指定PCIe设备根端口设备号
FunctionNumber	string	true	-	新URL：指定PCIe功能的功能号，旧URL：指定PCIe设备根端口功能号
ClassCode	string	true	-	指定PCIe设备功能类码（当前仅新URL支持）
AssociatedResource	string	true	-	指定PCIe设备归属资源
BusNumber	string	true	-	指定PCIe设备根端口总线号
DeviceNumber	string	true	-	指定PCIe设备根端口设备号
FunctionNumber	string	true	-	指定PCIe设备根端口功能号
Bus	string	true	-	指定PCIe设备总线号
Device	string	true	-	指定PCIe设备的设备号
Function	string	true	-	指定PCIe设备功能号
LinkWidthAbility	string	true	-	指定PCIe设备最大链路带宽
LinkSpeedAbility	string	true	-	指定PCIe设备最大链路速率
LinkWidth	string	true	-	指定PCIe设备链路带宽
LinkSpeed	string	true	-	指定PCIe设备链路速率
@odata.id	string	true	-	各属性的访问路径
PCIeDevices	object	true	-	指定PCIe设备的导航
EthernetInterfaces.Drives.StorageControllers	array	true	-	网口导航/驱动器导航/控制器导航

supported_methods

HTTP methods

GET

命令功能

查询指定 PCIe 功能资源信息

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id/PCIeDevices/pciedevices_id/PCIeFunctions/functions_id 原URL：https://device_ip/redfish/v1/Chassis/chassis_id/PCIeDevices/pciedevices_id/Functions/functions_id

请求头:


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

请求消息体: 无

参数说明

参数	参数说明	取值
device_ip	登录设备的IP地址	IPv4或IPv6地址
chassis_id	机箱资源的ID	● 针对机架服务器，取值为1 ● 针对高密服务器，取值为BladeN（N表示节点槽位号），例如 “Blade1” ● 针对刀片服务器，取值可以为BladeN（N表示计算节点槽位号） ● 针对X6800 V5，X6000 V5，G5500，XA320 V2服务器，取值还可以为Enc，表示计算节点所在的机框资源 ● 针对设备U位信息，取值可以为UN(N表示设备U位号)，例如"U1" ● 针对机柜资源，取值为 Rack
pciedevices_id	PCIe设备资源ID	可通过查询指定资源获取
functions_id	PCIe功能资源ID	可通过查询指定PCIe功能资源获取
auth_value	执行该GET请求时，必须在“Headers”中携带“X- Auth-Token”值用于鉴权	可通过/redfish/v1/ SessionService/Sessions 创建会话时获得

使用指南

无

使用实例

请求样例1：

http

GET https://device_ip/redfish/v1/Chassis/1/PCIeDevices/PCIeCard4/Functions/1

请求头：


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

请求消息体：无

响应样例：

json

{
  "@odata.context": "/redfish/v1/$metadata#PCIeFunction.PCIeFunction",
  "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/PCIeCard4/Functions/1",
  "@odata.type": "#PCIeFunction.v1_0_1.PCIeFunction",
  "Id": "1",
  "Name": "Function1",
  "DeviceId": "0x8086",
  "VendorId": "0x10fb",
  "SubsystemId": null,
  "SubsystemVendorId": null,
  "DeviceClass": "NetworkController",
  "FunctionId": 0,
  "FunctionProtocol": "PCIe",
  "FunctionType": "Physical",
  "SegmentNumber": "0x00",
  "BusNumber": "0x00",
  "DeviceNumber": "0x03",
  "FunctionNumber": "0x00",
  "Oem": {
    "Public": {
      "AssociatedResource": "CPU1",
      "BusNumber": "0x00",
      "DeviceNumber": "0x03",
      "FunctionNumber": "0x00",
      "DeviceBDF": {
        "Bus": "0x41",
        "Device": "0x00",
        "Function": "0x00"
      },
      "LinkWidthAbility": null,
      "LinkSpeedAbility": null,
      "LinkWidth": null,
      "LinkSpeed": null
    }
  },
  "Links": {
    "PCIeDevices": {
      "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/PCIeCard4"
    },
    "EthernetInterfaces": [
      {
        "@odata.id": "/redfish/v1/Systems/1/EthernetInterfaces/mainboardPCIeCard4Port1"
      },
      {
        "@odata.id": "/redfish/v1/Systems/1/EthernetInterfaces/mainboardPCIeCard4Port2"
      }
    ]
  }
}

响应码：200 请求样例2：

http

GET https://device_ip/redfish/v1/Chassis/1/PCIeDevices/PCIeCard4/PCIeFunctions/1

请求头：


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

请求消息体：无

响应样例：

json

{
  "@odata.context": "/redfish/v1/$metadata#PCIeFunction.PCIeFunction",
  "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/PCIeCard1/PCIeFunctions/1",
  "@odata.type": "#PCIeFunction.v1_6_0.PCIeFunction",
  "Id": "1",
  "Name": "Function1",
  "BusNumber": "0x41",
  "ClassCode": "0x120000",
  "DeviceClass": "ProcessingAccelerators",
  "DeviceId": "0xd500",
  "DeviceNumber": "0x00",
  "FunctionId": 0,
  "FunctionNumber": "0x0",
  "FunctionProtocol": "PCIe",
  "FunctionType": "Physical",
  "Links": {
    "EthernetInterfaces": [],
    "PCIeDevices": {
      "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/PCIeCard1"
    }
  },
  "SegmentNumber": "0x0000",
  "SubsystemId": "0x0110",
  "SubsystemVendorId": "0x0200",
  "VendorId": "0x19e5"
}

响应码：200

ResourceDefinition ​

uris ​

properties ​

supported_methods ​

HTTP methods ​

GET ​

ResourceDefinition

uris

properties

supported_methods

HTTP methods

GET