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	null	true	-	指定PCIe设备的SDID
SubsystemVendorId	null	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设备根端口功能号
Oem {	object	true	-	自定义属性
Oem.Public {	object	true	-	自定义属性
Oem.Public.BusNumber	string	true	-	新URL：指定PCIe功能的总线号，旧URL：指定PCIe设备根端口总线号
Oem.Public.DeviceNumber	string	true	-	新URL：指定PCIe功能的设备号，旧URL：指定PCIe设备根端口设备号
Oem.Public.FunctionNumber	string	true	-	新URL：指定PCIe功能的功能号，旧URL：指定PCIe设备根端口功能号
Oem.Public.AssociatedResource	string	true	-	指定PCIe设备归属资源
Oem.Public.DeviceBDF {	object	true	-	设备BDF信息
Oem.Public.DeviceBDF.Bus	string	true	-	指定PCIe设备总线号
Oem.Public.DeviceBDF.Device	string	true	-	指定PCIe设备的设备号
Oem.Public.DeviceBDF.Function	string	true	-	指定PCIe设备功能号
}
Oem.Public.LinkWidthAbility	null	true	-	指定PCIe设备最大链路带宽
Oem.Public.LinkSpeedAbility	null	true	-	指定PCIe设备最大链路速率
Oem.Public.LinkWidth	null	true	-	指定PCIe设备链路带宽
Oem.Public.LinkSpeed	null	true	-	指定PCIe设备链路速率
}
}
BusNumber	string	true	-	指定PCIe设备根端口总线号
DeviceNumber	string	true	-	指定PCIe设备根端口设备号
FunctionNumber	string	true	-	指定PCIe设备根端口功能号
@odata.id	string	true	-	各属性的访问路径
Links {	object	true	-	指定PCIe功能关联的资源
Links.EthernetInterfaces [ {	array	true	-	指定PCIe功能资源的网口信息的访问路径
Links.EthernetInterfaces[].@odata.id	string	true	-	成员资源节点的访问路径
} ]
Links.PCIeDevices {	object	true	-	指定PCIe设备的导航
Links.PCIeDevices.@odata.id	string	true	-	PCIeDevices资源的访问路径
}
}

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