ResourceDefinition

uris

/redfish/v1/Chassis/chassis_id/Transceivers/transceivers_id

properties

名称	类型	是否只读	取值范围/枚举值	说明
@odata.context	string	true	-	光模块资源模型的OData描述信息
@odata.id	string	true	-	光模块资源的访问路径
@odata.type	string	true	-	光模块资源的类型
Id	string	true	-	光模块资源ID
Name	string	true	-	光模块资源名称
Status	object	true	-	光模块的状态，包括： ● State：光模块使能状态 ● Health：光模块健康状态 ● Severity：光模块的自定义健康状态
PartLocation	object	true	-	资源在封闭装置内的部件位置说明 BMC500 5.13.0及以上版本支持。
ServiceLabel	string	true	-	部件位置的标签说明 BMC500 5.13.0及以上版本支持。
LocationType	string	true	-	部件位置的类型说明 BMC500 5.13.0及以上版本支持。
LocationOrdinalValue	number	true	-	部件位置的序号说明 BMC500 5.13.0及以上版本支持。
PartLocationContext	string	true	-	部件位置上下文，用于区分同一外壳内不同零件的PartLocation值，其中可能包含该零件所包含的PartLocation值的层级信息说明 BMC500 5.13.0及以上版本支持。
RXFCSErrors	number	true	-	接收到的Frame Check Sequence错误数量
Manufacturer	string	true	-	光模块的厂商名称
PartNumber	string	true	-	光模块的部件号
SerialNumber	string	true	-	光模块的序列号
ProductionDate	string	true	-	光模块的生产日期
TransceiverType	array	true	-	光模块的收发器类型
PackagingType	string	true	-	光模块的封装类型，包括： ● GBIC ● modulesolderedto motherboard ● SFP ● 300 pin XBI ● XENPAK ● XFP ● XFF ● XFP-E ● XPAK ● X2 ● DWDM-SFP ● QSFP ● QSFP+ ● CXP ● Shielded Mini Multilane HD 4X ● Shielded Mini Multilane HD 8X ● QSFP28 ● CXP2/CXP28 ● CDFP Style 1/Style 2 ● Shielded Mini Multilane HD 4X Fanout Cable ● Shielded Mini Multilane HD 8X Fanout Cable ● CDFP Style 3 ● microQSFP
MediumMode	string	true	-	光模块的介质类型，包括： ● Monomode ● Multimode
WaveLengthNanometer	number	true	-	光模块的波长
SupportedSpeedsMbps	array	true	-	光模块支持的速率
ReadingVolts	number	true	-	光模块电压的当前读数说明已屏蔽该属性值频繁变化导致的事件上报
LowerThresholdCritical	number	true	-	电压过低严重告警门限
UpperThresholdCritical	number	true	-	电压过高严重告警门限
ReadingMilliWatts	number	true	-	光模块接收功率的当前读数说明已屏蔽该属性值频繁变化导致的事件上报
LowerThresholdCritical	number	true	-	接收功率过低严重告警门限
UpperThresholdCritical	number	true	-	接收功率过高严重告警门限
ReadingMilliWatts	number	true	-	光模块发送功率的当前读数说明已屏蔽该属性值频繁变化导致的事件上报
LowerThresholdCritical	number	true	-	发送功率过低严重告警门限
UpperThresholdCritical	number	true	-	发送功率过高严重告警门限
Identifier	string	true	-	光模块的识别码，包括 ● UNDEF ● GBIC ● SFP_SFP_PLUS_SFP28 ● QSFP ● QSFP_PLUS ● QSFP28
DeviceType	string	true	-	光模块的设备类型，包括 ● Optical ● Electric ● Copper ● Aoc ● Interface（背板类型） ● Baset（电卡口） ● Unknown
ConnectorType	string	true	-	光模块的连接器类型，包括 ● UNDEF（未定义） ● LC ● MPO ● OPTICAL_PIGTAIL（有源光缆） ● COPPER_PIGTAIL（铜缆） ● NO_SEPARABLE_CONNE CTOR（未分配）
RxLosState	boolean	true	-	光模块Rx端是否收不到信号
TxFaultState	boolean	true	-	光模块Tx端是否有故障
TransferDistance	number	true	-	传输距离
ReadingCelsius	number	true	-	光模块温度的当前读数说明已屏蔽该属性值频繁变化导致的事件上报
LowerThresholdCritical	number	true	-	温度过低严重告警门限
UpperThresholdCritical	number	true	-	温度过高严重告警门限
ReadingMilliAmperes	number	true	-	光模块偏置电流的当前读数说明已屏蔽该属性值频繁变化导致的事件上报
LowerThresholdCritical	number	true	-	偏置电流过低严重告警门限
UpperThresholdCritical	number	true	-	偏置电流过高严重告警门限
FirmwareVersion	string	true	-	指定扩展板卡的固件版本说明目前只有200 IOB卡支持
PRBSTest	string	true	-	光模块支持PRBSTest
ContaminationDetection	string	true	-	光模块支持光链路脏污检测
@odata.id	string	true	-	光模块通道映射关系资源节点的访问路径说明仅BMC300 5.12.0及以上版本支持
#Transceiver.ControlIndicatorLED	object	true	-	控制光模块Active指示灯状态
target	string	true	-	控制光模块Active指示灯状态访问路径
@Redfish.ActionInfo	string	true	-	控制光模块Active指示灯状态查询路径

supported_methods

GET
POST

HTTP methods

GET

命令功能

查询网络端口上接的光模块资源信息

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id/Transceivers/transceivers_id 原URL：https://device_ip/redfish/v1/Chassis/chassis_id/NetworkAdapters/networkadapters_id/NetworkPorts/networkports_id/OpticalModule

请求头:


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创建会话时获得
networkadapters_id	网络适配器资源的ID	属性DeviceLocator和属性 Position合并而成
networkports_id	网络端口资源的ID	属性PhysicalPortNumber 值，一般从一开始

使用指南

无

使用实例

请求样例：

http

GET https://device_ip/redfish/v1/Chassis/1/NetworkAdapters/mainboardPCIeCard4/NetworkPorts/1/OpticalModule

请求头：


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

请求消息体：无

响应样例：

json

{
  "@odata.context": "/redfish/v1/$metadata#hwOpticalModule.hwOpticalModule",
  "@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/mainboardPCIeCard5/NetworkPorts/1/OpticalModule",
  "@odata.type": "#hwOpticalModul.v1_0_0.hwOpticalModule",
  "Name": "OpticalModule",
  "Id": "OpticalModule",
  "Status": {
    "Health": "Warning",
    "Oem": {
      "Public": {
        "Severity": "Informational"
      }
    },
    "State": "Enabled"
  },
  "Location": {
    "PartLocation": {
      "ServiceLabel": "PIC-8 ETH1",
      "LocationType": "Connector",
      "LocationOrdinalValue": 1
    },
    "PartLocationContext": "NPU BOX 2"
  },
  "RXFCSErrors": 123,
  "Manufacturer": "",
  "PartNumber": "LTF8502-BC+",
  "SerialNumber": "N3367109619",
  "ProductionDate": "2016-07-26",
  "TransceiverType": [
    "10G Base-SR"
  ],
  "PackagingType": "SFP/SFP+",
  "MediumMode": "Multimode",
  "WaveLengthNanometer": 850,
  "SupportedSpeedsMbps": [
    10000
  ],
  "Voltage": {
    "ReadingVolts": 2,
    "LowerThresholdCritical": 2.97,
    "UpperThresholdCritical": 3.63
  },
  "RXPower": [
    {
      "ReadingMilliWatts": 0,
      "LowerThresholdCritical": 0.06,
      "UpperThresholdCritical": 1.26
    }
  ],
  "TXPower": [
    {
      "ReadingMilliWatts": 0.57,
      "LowerThresholdCritical": 0.12,
      "UpperThresholdCritical": 1.26
    }
  ],
  "Identifier": "SFP_SFP_PLUS_SFP28",
  "DeviceType": "Optical",
  "ConnectorType": "LC",
  "RxLosState": true,
  "TxFaultState": false,
  "TransferDistance": 40,
  "Temperature": {
    "ReadingCelsius": 45,
    "LowerThresholdCritical": null,
    "UpperThresholdCritical": null
  },
  "TXBiasCurrent": [
    {
      "ReadingMilliAmperes": 7504,
      "LowerThresholdCritical": null,
      "UpperThresholdCritical": null
    }
  ],
  "SupportedDiagnosticService": [
    "PRBSTest",
    "ContaminationDetection"
  ]
}

响应码：200

POST (ACTION)

ControlActiveIndicatorLED

命令功能

控制光模块 Active 指示灯状态

命令格式

URL: https://device_ip/redfish/v1/Chassis/Chassis_id/Transceivers/OpticalModule_EthernetAdapterBoardPort1/Actions/Transceiver.ControlIndicatorLED

请求头:


X-Auth-Token: 123456789***********************
Content-Type: header_type

请求消息体:

json

{
  "IndicatorLED": controltype
}

请求头参数说明

参见请求头参数说明

请求体参数说明

参数	参数说明	取值
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
transceivers_id	光模块资源的ID	可通过查询光模块集合资源信息获取
controltype	控制类型	● ForceOff：强制灭灯 ● Resume：恢复原状态

使用指南

无

使用实例

请求样例：

http

POST https://device_ip/redfish/v1/Chassis/1/Transceivers/OpticalModule_EthernetAdapterBoardPort1/Actions/Transceiver.ControlIndicatorLED

请求头：


X-Auth-Token: 123456789***********************
Content-Type: application/json

请求消息体： ● 设置强制灭灯：

json

{
  "IndicatorLED": "ForceOff"
}

● 设置恢复原状态： { "IndicatorLED":"Resume" } 响应样例：

json

{
  "error": {
    "code": "Base.1.0.GeneralError",
    "message": "A general error has occurred. See ExtendedInfo for more information.",
    "@Message.ExtendedInfo": [
      {
        "@odata.type": "#Message.v1_0_0.Message",
        "MessageId": "Base.1.0.Success",
        "RelatedProperties": [],
        "Message": "Successfully Completed Request",
        "MessageArgs": [],
        "Severity": "OK",
        "Resolution": "None"
      }
    ]
  }
}

响应码：200

ResourceDefinition ​

uris ​

properties ​

supported_methods ​

HTTP methods ​

GET ​

POST (ACTION) ​

ControlActiveIndicatorLED ​

ResourceDefinition

uris

properties

supported_methods

HTTP methods

GET

POST (ACTION)

ControlActiveIndicatorLED