PoE管理
本章节介绍PoE管理的配置模型,以及配置的XML报文举例说明。
数据模型
PoE管理对应的配置模型文件名为huawei-poe.yang和huawei-time-range.yang。
仅支持PoE的设备支持该配置。
节点 |
说明 |
取值范围 |
备注 |
---|---|---|---|
/ietf-interfaces:interfaces/interface/huawei-poe:poe/enable |
表示是否使能PoE功能。 |
布尔型,具体取值如下:
|
NA |
/ietf-interfaces:interfaces/interface/huawei-poe:poe/time-range |
表示PoE下电时间段策略。 |
字符串形式。 必须是设备上已存在的时间段名称。 |
NA |
/huawei-time-range:time-ranges/time-range/vsys |
表示PoE下电时间段策略的Vsys名称。 |
字符串形式。 |
NA |
/huawei-time-range:time-ranges/time-range/name |
表示PoE下电时间段策略名。 |
字符串形式,长度范围是1~32。 |
NA |
/huawei-time-range:time-ranges/time-range/period-time/start |
表示PoE下电时间段开始时间点。 |
字符串形式。 |
NA |
/huawei-time-range:time-ranges/time-range/period-time/end |
表示PoE下电时间段结束时间点。 |
字符串形式。 |
NA |
huawei-time-range:time-ranges/time-range/period-time/weekday |
表示PoE下电时间段。 |
枚举值类型,具体取值如下:
|
NA |
/ietf-interfaces:interfaces/interface/huawei-poe:poe/fast-on-enable |
表示PoE端口快速上电。 |
布尔型,具体取值如下:
|
NA |
/ietf-interfaces:interfaces/interface/huawei-poe:poe/conformance-to-std |
表示PoE供电模式切换。 |
枚举型,具体取值如下:
|
NA |
/ietf-interfaces:interfaces/interface/huawei-poe:poe/poweron-legacy-level |
表示PoE端口非标兼容。 |
布尔型,具体取值如下:
|
NA |
/huawei-board:boards/board/huawei-poe:poe/reserved-power |
表示PoE设备预留功率。 |
整数形式,取值范围为0~100,单位是%。 |
NA |
/huawei-board:boards/board/huawei-poe:poe/high-inrush-enable |
表示是否使能允许上电瞬间的高冲击电流。 |
布尔型,具体取值如下:
|
NA |
/huawei-poe:get-poe-power-state/port-name |
表示查看PoE信息时指定的接口名。 |
字符串形式。 |
NA |
/huawei-poe:get-poe-power-state/slot-id |
表示查看PoE信息时指定的槽位号。 |
字符串形式。 |
若不指定接口和槽位号,则会显示设备所有接口的PoE供电信息。 |
/huawei-poe:get-poe-power-state/port-state/port-name |
表示查看到的PoE信息对应的接口名。 |
字符串形式。 |
NA |
/huawei-poe:get-poe-power-state/port-state/port-index |
表示查看到的PoE信息对应的接口索引。 |
整数形式。 |
NA |
/huawei-poe:get-poe-power-state/port-state/power-state |
表示查看到的对应接口是否供电。 |
枚举值类型,具体取值如下:
|
NA |
/huawei-poe:get-poe-power-state/port-state/enable |
表示查看到的对应接口是否使能PoE功能。 |
布尔型,具体取值如下:
|
NA |
/huawei-poe:get-poe-power-state/port-state/fast-on |
表示查看到的对应接口是否使能快速上电功能。 |
布尔型,具体取值如下:
|
NA |
/huawei-poe:get-poe-power-state/port-state/priority |
表示查看到的对应接口供电的优先级。 |
枚举值类型,具体取值如下:
|
NA |
/huawei-poe:get-poe-power-state/port-state/status |
表示查看到的对应接口的供电状态。 |
枚举值类型,具体取值如下:
|
NA |
/huawei-poe:get-poe-power-state/port-state/legacy |
表示查看到的对应接口是否使能兼容性检测功能。 |
枚举值类型,具体取值如下:
|
NA |
/huawei-poe:get-poe-power-state/port-state/class |
表示查看到的对应接口接入PD对应的分级。 |
整数形式,取值范围为0~4。 |
NA |
/huawei-poe:get-poe-power-state/port-state/reference-power |
表示查看到的对应接口的参考功率。 |
整数形式,单位mW。 |
NA |
/huawei-poe:get-poe-power-state/port-state/max-power |
表示查看到的对应接口的最大输出功率。 |
整数形式,单位mW。 |
NA |
/huawei-poe:get-poe-power-state/port-state/power |
表示查看到的对应接口当前的输出功率。 |
整数形式,单位mW。 |
NA |
/huawei-poe:get-poe-power-state/port-state/peak-power |
表示查看到的对应接口的峰值输出功率。 |
整数形式,单位mW。 |
NA |
/huawei-poe:get-poe-power-state/port-state/average-power |
表示查看到的对应接口的平均输出功率。 |
整数形式,单位mW。 |
NA |
/huawei-poe:get-poe-power-state/port-state/current |
表示查看到的对应接口的输出电流。 |
整数形式,单位mA。 |
NA |
/huawei-poe:get-poe-power-state/port-state/voltage |
表示查看到的对应接口的输出电压。 |
整数形式,单位V。 |
NA |
配置PoE下电时间段
本章节主要介绍通过rpc配置PoE下电时间段。
操作 |
XPATH |
---|---|
rpc |
/huawei-time-range:time-ranges/time-range/ |
数据需求
项目 |
数据 |
描述 |
---|---|---|
下电时间策略名 |
timerangege0/0/2 |
- |
下电开始时间 |
8:00 |
|
下电结束时间 |
18:00 |
|
下电weekday |
周一到周五 |
请求示例
<?xml version='1.0' encoding='UTF-8'?> <rpc message-id="4" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> <edit-config> <target> <running/> </target> <config> <hw-time-range:time-ranges xmlns:hw-time-range="urn:huawei:params:xml:ns:yang:huawei-time-range"> <hw-time-range:time-range> <hw-time-range:vsys>public</hw-time-range:vsys> <hw-time-range:name>timerangege0/0/2</hw-time-range:name> <hw-time-range:period-time> <hw-time-range:start>8:0:0</hw-time-range:start> <hw-time-range:end>18:0:0</hw-time-range:end> <hw-time-range:weekday>monday</hw-time-range:weekday> <hw-time-range:weekday>tuesday</hw-time-range:weekday> <hw-time-range:weekday>wednesday</hw-time-range:weekday> <hw-time-range:weekday>thursday</hw-time-range:weekday> <hw-time-range:weekday>friday</hw-time-range:weekday> </hw-time-range:period-time> </hw-time-range:time-range> </hw-time-range:time-ranges> </config> </edit-config> </rpc>
响应示例
配置成功响应示例
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="4"> <ok/> </rpc-reply>
配置失败响应示例
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="5"> <rpc-error> <error-type>application</error-type> <error-tag>operation-failed</error-tag> <error-severity>error</error-severity> <error-message>parse rpc config error.</error-message> </rpc-error> </rpc-reply>
配置PoE端口下电时间
本章节主要介绍通过create方法配置PoE端口下电时间。
操作 |
XPATH |
---|---|
edit-config:create |
/ietf-interfaces:interfaces/interface/huawei-poe:poe/enable |
数据需求
项目 |
数据 |
描述 |
---|---|---|
PoE端口 |
GigabitEthernet0/0/2 |
请保证该接口在设备上存在并已经配置,具体配置方法请参见配置接口的基础属性。 |
PoE端口配置下电时间 |
timerangege0/0/2 |
请保证下电时间已经配置,具体配置方法请参见配置PoE下电时间段。 |
请求示例
<?xml version='1.0' encoding='UTF-8'?>
<rpc message-id="9" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
<edit-config>
<target>
<running/>
</target>
<config>
<if:interfaces xmlns:if="urn:ietf:params:xml:ns:yang:ietf-interfaces">
<if:interface>
<if:name>GigabitEthernet0/0/2</if:name>
<if:type xmlns:iana-if-type="urn:ietf:params:xml:ns:yang:iana-if-type">iana-if-type:ethernetCsmacd</if:type>
<huawei-poe:poe xmlns:huawei-poe="urn:huawei:params:xml:ns:yang:huawei-poe">
<huawei-poe:enable>true</huawei-poe:enable>
<huawei-poe:time-range>timerangege0/0/2</huawei-poe:time-range>
</huawei-poe:poe>
</if:interface>
</if:interfaces>
</config>
</edit-config>
</rpc>
响应示例
配置成功响应示例
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="9"> <ok/> </rpc-reply>
配置失败响应示例
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="10"> <rpc-error> <error-type>application</error-type> <error-tag>operation-failed</error-tag> <error-severity>error</error-severity> <error-message>parse rpc config error.</error-message> </rpc-error> </rpc-reply>
配置PoE端口快速上电
本章节主要介绍通过edit-config方法配置PoE端口快速上电。
操作 |
XPATH |
---|---|
edit-config |
/ietf-interfaces:interfaces/interface/huawei-poe:poe/fast-on-enable |
数据需求
项目 |
数据 |
描述 |
---|---|---|
PoE端口 |
GigabitEthernet0/0/1 |
请保证该接口在设备上存在并已经配置,具体配置方法请参见配置接口的基础属性。 仅S5720-28X-PWH-LI-AC、S5720-16X-PWH-LI-AC、S5720I-12X-PWH-SI-DC、S5730-SI、S5730S-EI、S5730-HI、S5735-L、S5735S-L、S5735S-L-M、S5735-S、S5731-H、S5731-H-K、S5731S-H、S5731-S、S5731S-S、S5732-H和S6720-SI支持该功能。 |
请求示例
<?xml version='1.0' encoding='UTF-8'?> <rpc message-id="8" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> <edit-config> <target> <running/> </target> <config> <if:interfaces xmlns:if="urn:ietf:params:xml:ns:yang:ietf-interfaces"> <if:interface> <if:name>GigabitEthernet0/0/1</if:name> <if:type xmlns:iana-if-type="urn:ietf:params:xml:ns:yang:iana-if-type">iana-if-type:ethernetCsmacd</if:type> <huawei-poe:poe xmlns:huawei-poe="urn:huawei:params:xml:ns:yang:huawei-poe"> <huawei-poe:fast-on-enable>true</huawei-poe:fast-on-enable> </huawei-poe:poe> </if:interface> </if:interfaces> </config> </edit-config> </rpc>
响应示例
配置成功响应示例
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="8"> <ok/> </rpc-reply>
配置失败响应示例
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="8"> <rpc-error> <error-app-tag>-1</error-app-tag> <error-message>Service process failed.</error-message> <error-info>Error on node /ietf-interfaces:interfaces/interface[name="GigabitEthernet0/0/1"]/huawei-poe:poe/fast-on-enable</error-info> </rpc-error> </rpc-reply>
配置PoE端口供电模式切换
本章节主要介绍通过edit-config方式配置PoE端口供电模式切换。
操作 |
XPATH |
---|---|
edit-config |
/ietf-interfaces:interfaces/interface/huawei-poe:poe/conformance-to-std |
数据需求
项目 |
数据 |
描述 |
---|---|---|
PoE端口 |
GigabitEthernet0/0/1 |
配置PoE端口为af模式。 请保证该接口在设备上存在并已经配置,具体配置方法请参见配置接口的基础属性。 |
请求示例
<?xml version='1.0' encoding='UTF-8'?> <rpc message-id="3" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> <edit-config> <target> <running/> </target> <config> <if:interfaces xmlns:if="urn:ietf:params:xml:ns:yang:ietf-interfaces"> <if:interface> <if:name>GigabitEthernet0/0/1</if:name> <if:type xmlns:iana-if-type="urn:ietf:params:xml:ns:yang:iana-if-type">iana-if-type:ethernetCsmacd</if:type> <huawei-poe:poe xmlns:huawei-poe="urn:huawei:params:xml:ns:yang:huawei-poe"> <huawei-poe:conformance-to-std>ieee8023af</huawei-poe:conformance-to-std> </huawei-poe:poe> </if:interface> </if:interfaces> </config> </edit-config> </rpc>
响应示例
配置成功响应示例
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="3"> <ok/> </rpc-reply>
配置失败响应示例
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="3"> <rpc-error> <error-app-tag>-1</error-app-tag> <error-message>Service process failed.</error-message> <error-info>Error on node /ietf-interfaces:interfaces/interface[name="GigabitEthernet0/0/1"]/huawei-poe:poe/conformance-to-std</error-info> </rpc-error> </rpc-reply>
配置PoE端口非标兼容
本章节主要介绍通过edit-config配置PoE端口非标兼容。
操作 |
XPATH |
---|---|
edit-config |
/ietf-interfaces:interfaces/interface/huawei-poe:poe/poweron-legacy-level |
数据需求
项目 |
数据 |
描述 |
---|---|---|
PoE端口 |
GigabitEthernet0/0/1 |
配置PoE端口强制供电。 请保证该接口在设备上存在并已经配置,具体配置方法请参见配置接口的基础属性。 |
请求示例
<?xml version='1.0' encoding='UTF-8'?> <rpc message-id="1" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> <edit-config> <target> <running/> </target> <config> <if:interfaces xmlns:if="urn:ietf:params:xml:ns:yang:ietf-interfaces"> <if:interface> <if:name>GigabitEthernet0/0/1</if:name> <if:type xmlns:iana-if-type="urn:ietf:params:xml:ns:yang:iana-if-type">iana-if-type:ethernetCsmacd</if:type> <huawei-poe:poe xmlns:huawei-poe="urn:huawei:params:xml:ns:yang:huawei-poe"> <huawei-poe:poweron-legacy-level>force</huawei-poe:poweron-legacy-level> </huawei-poe:poe> </if:interface> </if:interfaces> </config> </edit-config> </rpc>
响应示例
配置成功响应示例
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="1"> <ok/> </rpc-reply>
配置失败响应示例
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="1"> <rpc-error> <error-app-tag>-1</error-app-tag> <error-message>Service process failed.</error-message> <error-info>Error on node /ietf-interfaces:interfaces/interface[name="GigabitEthernet0/0/1"]/huawei-poe:poe/poweron-legacy-level</error-info> </rpc-error> </rpc-reply>
配置PoE设备预留功率
本章节主要介绍通过edit-config配置PoE设备预留功率。
操作 |
XPATH |
---|---|
edit-config |
/huawei-board:boards/board/huawei-poe:poe/reserved-power |
请求示例
<?xml version='1.0' encoding='UTF-8'?> <rpc message-id="5" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> <edit-config> <target> <running/> </target> <config> <board:boards xmlns:board="urn:huawei:params:xml:ns:yang:huawei-board"> <board:board> <board:name>0</board:name> <huawei-poe:poe xmlns:huawei-poe="urn:huawei:params:xml:ns:yang:huawei-poe"> <huawei-poe:reserved-power>10</huawei-poe:reserved-power> </huawei-poe:poe> </board:board> </board:boards> </config> </edit-config> </rpc>
响应示例
配置成功响应示例
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="5"> <ok/> </rpc-reply>
配置失败响应示例
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="5"> <rpc-error> <error-app-tag>-1</error-app-tag> <error-message>Service process failed.</error-message> <error-info>Error on node /huawei-board:boards/board[name="0"]/huawei-poe:poe/reserved-power</error-info> </rpc-error> </rpc-reply>
配置设备使能高冲击电流
本章节主要介绍通过edit-config配置使能高冲击电流。
操作 |
XPATH |
---|---|
edit-config |
/huawei-board:boards/board/huawei-poe:poe/high-inrush-enable |
请求示例
<?xml version='1.0' encoding='UTF-8'?> <rpc message-id="6" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> <edit-config> <target> <running/> </target> <config> <board:boards xmlns:board="urn:huawei:params:xml:ns:yang:huawei-board"> <board:board> <board:name>0</board:name> <huawei-poe:poe xmlns:huawei-poe="urn:huawei:params:xml:ns:yang:huawei-poe"> <huawei-poe:high-inrush-enable>true</huawei-poe:high-inrush-enable> </huawei-poe:poe> </board:board> </board:boards> </config> </edit-config> </rpc>
响应示例
配置成功响应示例
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="6"> <ok/> </rpc-reply>
配置失败响应示例
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="6"> <rpc-error> <error-app-tag>-1</error-app-tag> <error-message>Service process failed.</error-message> <error-info>Error on node /huawei-board:boards/board[name="0"]/huawei-poe:poe/high-inrush-enable</error-info> </rpc-error> </rpc-reply>
查看PoE供电状态信息
本章节主要介绍通过get方法查看PoE供电状态信息的报文举例。
操作 |
XPATH |
---|---|
get |
/huawei-poe:get-poe-power-state |
数据需求
项目 |
数据 |
描述 |
---|---|---|
接口名 |
GigabitEthernet0/0/2 |
- |
<?xml version="1.0" encoding="UTF-8"?> <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="1"> <huawei-poe:get-poe-power-state xmlns:huawei-poe="urn:huawei:params:xml:ns:yang:huawei-poe"> <huawei-poe:port-name>GigabitEthernet0/0/2</huawei-poe:port-name> </huawei-poe:get-poe-power-state> </rpc>
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="1"> <data> <get-poe-power-state xmlns="urn:huawei:params:xml:ns:yang:huawei-poe"> <ports-state> <port-state> <port-name>GigabitEthernet0/0/2</port-name> <port-index>8</port-index> <power-state>off</power-state> <enable>enable</enable> <fast-on>disable</fast-on> <priority>low</priority> <status>detecting</status> <legacy>0</legacy> <class>0</class> <reference-power>0</reference-power> <max-power>30000</max-power> <power>0</power> <peak-power>0</peak-power> <average-power>0</average-power> <current>0</current> <voltage>0</voltage> </port-state> </ports-state> </get-poe-power-state> </data> </rpc-reply>
项目 |
数据 |
描述 |
---|---|---|
槽位号 |
0 |
显示指定槽位所有端口的PoE供电状态信息。 |
<?xml version="1.0" encoding="UTF-8"?> <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="2"> <huawei-poe:get-poe-power-state xmlns:huawei-poe="urn:huawei:params:xml:ns:yang:huawei-poe"> <huawei-poe:slot-id>0</huawei-poe:slot-id> </huawei-poe:get-poe-power-state> </rpc>
<?xml version='1.0' encoding='UTF-8'?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="2"> <data> <get-poe-power-state xmlns="urn:huawei:params:xml:ns:yang:huawei-poe"> <ports-state> <port-state> <port-name>GigabitEthernet0/0/1</port-name> <port-index>7</port-index> <power-state>off</power-state> <enable>disable</enable> <fast-on>disable</fast-on> <priority>low</priority> <status>disabled</status> <legacy>0</legacy> <class>0</class> <reference-power>0</reference-power> <max-power>30000</max-power> <power>0</power> <peak-power>0</peak-power> <average-power>0</average-power> <current>0</current> <voltage>0</voltage> </port-state> <port-state> <port-name>GigabitEthernet0/0/2</port-name> <port-index>8</port-index> <power-state>off</power-state> <enable>enable</enable> <fast-on>disable</fast-on> <priority>low</priority> <status>detecting</status> <legacy>0</legacy> <class>0</class> <reference-power>0</reference-power> <max-power>30000</max-power> <power>0</power> <peak-power>0</peak-power> <average-power>0</average-power> <current>0</current> <voltage>0</voltage> </port-state> <port-state> <port-name>GigabitEthernet0/0/3</port-name> <port-index>9</port-index> <power-state>off</power-state> <enable>enable</enable> <fast-on>disable</fast-on> <priority>low</priority> <status>detecting</status> <legacy>0</legacy> <class>0</class> <reference-power>0</reference-power> <max-power>30000</max-power> <power>0</power> <peak-power>0</peak-power> <average-power>0</average-power> <current>0</current> <voltage>0</voltage> </port-state> ............ </ports-state> </get-poe-power-state> </data> </rpc-reply>