DHCP管理

S1700, S2720, S5700, S6700 V200R019C10 NETCONF YANG API参考

本文档介绍了设备支持的NETCONF YANG API功能，包括数据模型及相关示例。

评分并提供意见反馈 :

华为采用机器翻译与人工审校相结合的方式将此文档翻译成不同语言，希望能帮助您更容易理解此文档的内容。请注意：即使是最好的机器翻译，其准确度也不及专业翻译人员的水平。华为对于翻译的准确性不承担任何责任，并建议您参考英文文档（已提供链接）。

DHCP管理

配置基于接口地址池的DHCP服务器功能
配置基于全局地址池的DHCP服务器功能
配置DHCP中继
配置DHCP客户端
- 数据模型
- 配置接口的DHCP客户端功能

配置基于接口地址池的DHCP服务器功能

数据模型

DHCP服务器对应的数据模型文件名为huawei-dhcp.yang和huawei-address-management.yang。

表2-267 huawei-dhcp.yang的数据模型

节点	说明	取值范围	备注
/huawei-dhcp:dhcp-config/dhcpv4-config/enable	表示使能DHCP功能。	布尔型，取值包括： true：表示使能DHCP功能。 false：表示去使能DHCP功能。缺省值是false。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/enable	表示使能DHCP服务器功能。	布尔型，取值包括： true：表示使能DHCP服务器功能。 false：表示去使能DHCP服务器功能。缺省值是false。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/user-defined-options/user-defined-option/option-code	表示自定义选项的数值。	整数形式，取值范围是1～254，但1、3、6、15、44、46、50、51、52、53、54、55、57、58、59、61、82、120、121、184不能配置。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/user-defined-options/user-defined-option	表示自定义选项的类型。节点包括： ip-address：自定义的选项为IP地址类型。 ascii-string：自定义的选项为ASCII字符串类型。 cipher-string：自定义的选项为密文字符串类型。 hex-string：自定义的选项为十六进制字符串类型。	ip-address：点分十进制形式。 ascii-string：自字符串形式，长度范围是1～255。 cipher-string：字符串形式，显示密码时长度范围是1～64、密文密码时长度范围32～104。 hex-string：偶数位长度的十六进制字符串（如hh或hhhh），长度范围是2～254，可以配置为包含0～9、A～F和a～f的组合。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/logging/type	开启DHCP服务器分配IP地址时记录日志的功能。	枚举类型。取值包括：renew-success，表示地址续租成功时打印日志。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/ip-range/ip-subnet	配置DHCP服务器分配给DHCP客户端的IP地址范围。节点包括： start-ip-address：起始IP地址。 end-ip-address：结束IP地址。	start-ip-address：点分十进制形式。 end-ip-address：点分十进制形式。	NA
huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/mask/mask/ip-prefix/ip-prefix	DHCP服务器分配给DHCP客户端的IP地址的子网掩码。	点分十进制形式。	NA
huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/mask/mask/length/length	DHCP服务器分配给DHCP客户端的IP地址的子网掩码。	整数形式，取值范围是0～32。	NA
huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/conflict-recycle	开启冲突地址的自动回收功能，并配置自动回收的时间间隔。节点包括： day：自动回收时间间隔的天数。 hour：自动回收时间间隔的小时数。 minute：自动回收时间间隔的分钟数。	day：整数形式，取值范围是0～999，单位是天。缺省值是0。 hour：整数形式，取值范围是0～23，单位是小时。缺省值是0。 minute：整数形式，取值范围是0～59，单位是分钟。缺省值是0。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/gateway	配置DHCP服务器分配给DHCP客户端的默认网关地址。	点分十进制形式。	NA
huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/sip-server	配置DHCP服务器分配给DHCP客户端的SIP服务器的IP地址。	点分十进制形式。	NA
huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/boot-file	配置DHCP服务器分配给DHCP客户端的配置文件的名称。	字符串形式，不支持空格，区分大小写，长度范围是1～127。	NA
huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/next-server	配置DHCP服务器分配给DHCP客户端的启动过程中下一步使用的网络服务器IP地址。	点分十进制形式。	NA
huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/option121	配置DHCP服务器分配给DHCP客户端的Option121选项（无分类静态路由）。	点分十进制形式。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/global-configuration/ping	配置DHCP服务器发送Ping报文的最大数量和最长等待响应时间。节点包括： packet-number：发送Ping报文的最大数量。 interval：等待Ping应答的最长时间。	packet-number：整数形式，取值范围是0～10。0表示不进行Ping操作。 interval：整数形式，取值范围是0～10000，单位是毫秒。0表示不进行Ping操作。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/global-configuration/database	是否开启将当前DHCP数据保存到存储设备的功能。节点包括： enable：开启DHCP数据保存功能。 recover：从存储设备恢复DHCP数据。 write-delay：保存时延，即间隔多长时间执行一次保存操作。	enable：仅支持配置为true。 recover：– write-delay：整数形式，取值范围是300～86400，单位是秒。缺省值是7200秒。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/enable	是否配置接口采用全局地址池的DHCP Server功能。	布尔型，取值包括： true：表示配置接口采用全局地址池的DHCP Server功能。 false：表示未配置接口采用全局地址池的DHCP Server功能。缺省值是false。	NA

表2-268 huawei-address-management.yang的数据模型

节点	说明	取值范围	备注
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/name	全局地址池的名称。	字符串形式，不支持空格，长度范围是1～64，可以设定为包含数字、字母、和特殊字符（例如“_”、“-”或“.”）的组合，不能为“-”或“--”。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/network	全局地址池下可分配的网段地址。节点包括： ip-address：网络地址段。 mask：网络掩码。 mask-length：网络掩码长度。	ip-address：点分十进制形式。 mask：点分十进制形式。 mask-length：整数形式，取值范围是0～32。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/lease	全局地址池内IP地址的租期。节点包括： unlimited：无限期。 lease-time：租期时长，由day、hour和minute组成。	unlimited：- day：整数形式，取值范围是0～999，单位是天。缺省值是1。 hour：整数形式，取值范围是0～23，单位是小时。缺省值是0。 minute：整数形式，取值范围是0～59，单位是分钟。缺省值是0。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/excluded-address/ip-subnet	全局地址池内不参与分配的IP地址。节点包括： start-ip-address：起始IP地址。 end-ip-address：结束IP地址。	start-ip-address：点分十进制形式。 end-ip-address：点分十进制形式。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/static-binding/address-binding	全局地址池内静态绑定的IP地址。节点包括： ip-address：绑定的IP地址。 mac-address：用户的MAC地址。	ip-address：点分十进制形式。 mac-address：格式为H-H-H，其中H为1至4位的十六进制数。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/gateway	配置分配给DHCP客户端的网关地址。	点分十进制形式。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/dns/dns-server/ip-address	配置分配给DHCP客户端的DNS服务器的IP地址。	点分十进制形式。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/user-defined-options	配置自定义选项信息。	-	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/section	配置全局地址池中的IP地址段。节点包括： section-id：IP地址段的编号。 start-address：起始IP地址。 end-address：结束IP地址。	section-id：整数形式，取值范围为0～255。 start-address：点分十进制形式。 end-address：点分十进制形式。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/conflict-recycle	开启全局地址池中冲突地址的自动回收功能，并配置自动回收的时间间隔。节点包括： day：自动回收时间间隔的天数。 hour：自动回收时间间隔的小时数。 minute：自动回收时间间隔的分钟数。	day：整数形式，取值范围是0～999，单位是天。缺省值是0。 hour：整数形式，取值范围是0～23，单位是小时。缺省值是0。 minute：整数形式，取值范围是0～59，单位是分钟。缺省值是0。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/logging/log-type	开启DHCP服务器分配IP地址时记录日志的功能。	枚举类型，取值包括： allocation-fail：地址分配失败时打印日志。 allocation-success：地址分配成功时打印日志。 release：地址释放时打印日志。 renew-fail：地址续租失败时打印日志。 renew-success：地址续租成功时打印日志。 detect-conflict：发现地址冲突时打印日志。 recycle-conflict：回收冲突地址时打印日志。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/boot-file	配置分配给DHCP客户端的配置启动配置文件名称。	字符串形式，不支持空格，区分大小写，长度范围是1～127。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/sip-server	配置分配给DHCP客户端的SIP服务器的IP地址或域名。节点包括： ip-address：SIP服务器的IP地址。 domain-name：SIP服务器的域名。	ip-address：点分十进制形式。 domain-name：字符串形式，长度范围为1～63。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/sname	配置DHCP客户端获取启动配置文件的服务器名称。	字符串形式，不支持空格，区分大小写，长度范围是1～63。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/next-server	配置DHCP客户端自动获取IP地址后下一步使用的服务器地址。	点分十进制形式。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/option121	配置分配给DHCP客户端的无分类静态路由。几点包括： destination-ip：目的IP地址和掩码。 gateway-address：网关IP地址。	destination-ip：点分十进制格式/取值范围是0～32的整数。 gateway-address：点分十进制形式。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/option184	配置Option184字段的内容。节点包括： ncp-ip：网络呼叫处理器IP地址。 as-ip：备份网络呼叫处理器IP地址。 fail-over：fail-over的IP地址（ip-address）和拨号字符串（dialer-string）。 voice-vlan：Voice-vlan的VLAN编号。	ncp-ip：点分十进制形式。 as-ip：点分十进制形式。 ip-address：点分十进制形式。 dialer-string：字符串形式，取值范围是1～64。 voice-vlan：整数形式，取值范围是1～4094。	NA
/huawei-address-management:address-management-v4-statistics-table/ip-pool-statistics	查看IPv4地址池的统计信息。节点包括： pool-name：地址池的名称。可以使全局地址池也可以是接口地址池。如果不指定该节点，则显示所有地址池的统计信息。 request-from：查看指定表项索引之后的统计信息。 request-num：统计信息显示的条数。	-	NA
/huawei-address-management:address-management-v4-bindings-table/dynamic-bindings	查看IPv4地址池中已分配的地址信息。节点包括： pool-name：地址池的名称。可以使全局地址池也可以是接口地址池。如果不指定该节点，则显示所有已分配的地址信息。 ip-section：查看地址池中指定IP地址范围内的已分配地址信息。 request-from：查看指定表项索引之后的已分配地址信息。 request-num：已分配地址信息显示的条数。	-	NA

打开DHCP服务器功能

本章节主要介绍通过rpc方法打开DHCP服务器功能。

表2-269 打开DHCP服务器功能

操作	XPATH
rpc	/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server

数据需求

项目	数据	描述
DHCP功能	true	在接口VLANIF404上打开DHCP服务器功能。
DHCP服务器功能	true
接口名称和IP地址	接口名称：VLANIF404 接口IP地址：10.10.10.44/24

请求示例

<rpc message-id="123" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
<interfaces xmlns="urn:ietf:params:xml:ns:yang:ietf-interfaces">
 <interface xmlns:ns0="urn:ietf:params:xml:ns:netconf:base:1.0" ns0:operation="merge">
  <name>Vlanif404</name>
  <type xmlns:x="urn:ietf:params:xml:ns:yang:iana-if-type">x:propVirtual</type>
  <ipv4 xmlns="urn:ietf:params:xml:ns:yang:ietf-ip">
   <address ns0:operation="merge">
    <ip>10.10.10.44</ip>
    <netmask>255.255.255.0</netmask>
   </address>
  </ipv4>
 </interface>
</interfaces>
<dhcp-config xmlns="urn:huawei:params:xml:ns:yang:huawei-dhcp">
 <dhcpv4-config>
  <enable>true</enable>
  <dhcp-server-configuration>
   <dhcp-servers>
    <dhcp-server xmlns:ns0="urn:ietf:params:xml:ns:netconf:base:1.0" ns0:operation="merge">
     <interface-name>Vlanif404</interface-name>
      <enable>true</enable>
      <interface-pool/>
    </dhcp-server>
   </dhcp-servers>
  </dhcp-server-configuration>
 </dhcpv4-config>
</dhcp-config>
    </config>
  </edit-config>
</rpc>

响应示例

配置成功响应示例。

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="123">
  <ok/>
</rpc-reply>

配置失败响应示例。

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="123">
  <rpc-error>
    <error-app-tag>-1</error-app-tag>
    <error-message> Please enable DHCP in the global view first.</error-message>
    <error-info>Error on node /huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server[interface-name="Vlanif404"]/enable</error-info>
  </rpc-error>
</rpc-reply>

配置自定义选项

本章节主要介绍通过rpc方法配置自定义选项。

表2-270 配置自定义选项

操作	XPATH
rpc	/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/user-defined-options/user-defined-option/option-code /huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/user-defined-options/user-defined-option

数据需求

项目	数据	描述
DHCP功能	true	在接口VLANIF404上打开DHCP服务器功能，并配置自定义选项Option43的格式为IP地址格式、取值为10.3.1.1。
DHCP服务器功能	true
接口名称和IP地址	接口名称：VLANIF404 接口IP地址：10.10.10.44/24
自定义选项的数值和格式	数值：43 格式：IP地址格式、取值为10.3.1.1

请求示例

<rpc message-id="123" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
<interfaces xmlns="urn:ietf:params:xml:ns:yang:ietf-interfaces">
 <interface xmlns:ns0="urn:ietf:params:xml:ns:netconf:base:1.0" ns0:operation="merge">
  <name>Vlanif404</name>
  <type xmlns:x="urn:ietf:params:xml:ns:yang:iana-if-type">x:propVirtual</type>
  <ipv4 xmlns="urn:ietf:params:xml:ns:yang:ietf-ip">
   <address ns0:operation="merge">
    <ip>10.10.10.44</ip>
    <netmask>255.255.255.0</netmask>
   </address>
  </ipv4>
 </interface>
</interfaces>
<dhcp-config xmlns="urn:huawei:params:xml:ns:yang:huawei-dhcp">
 <dhcpv4-config>
  <enable>true</enable>
  <dhcp-server-configuration>
   <dhcp-servers>
    <dhcp-server xmlns:ns0="urn:ietf:params:xml:ns:netconf:base:1.0" ns0:operation="merge">
     <interface-name>Vlanif404</interface-name>
      <enable>true</enable>
     <interface-pool>
      <user-defined-options>
       <user-defined-option>
        <option-code>43</option-code>
         <ip-address>10.3.1.1</ip-address>
        </user-defined-option>
       </user-defined-options>
      </interface-pool>
     </dhcp-server>
    </dhcp-servers>
   </dhcp-server-configuration>
  </dhcpv4-config>
</dhcp-config>
    </config>
  </edit-config>
</rpc>

响应示例

配置成功响应示例。

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="123">
  <ok/>
</rpc-reply>

配置失败响应示例。

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="11">
  <rpc-error>
    <error-type>application</error-type>
    <error-tag>operation-failed</error-tag>
    <error-severity>error</error-severity>
    <error-path>/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server[interface-name='Vlanif404']/interface-pool/user-defined-options/user-defined-option[option-code='43']/ip-address[.='1000.0.0.1']</error-path>
    <error-message>parse rpc config error.(Value "1000.0.0.1" does not satisfy the constraint "(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])(%[\p{N}\p{L}]+)?" (range, length, or pattern).).</error-message>
  </rpc-error>
</rpc-reply>

配置基于全局地址池的DHCP服务器功能

数据模型

DHCP服务器对应的数据模型文件名为huawei-dhcp.yang和huawei-address-management.yang。

表2-271 huawei-dhcp.yang的数据模型

节点	说明	取值范围	备注
/huawei-dhcp:dhcp-config/dhcpv4-config/enable	表示使能DHCP功能。	布尔型，取值包括： true：表示使能DHCP功能。 false：表示去使能DHCP功能。缺省值是false。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/enable	表示使能DHCP服务器功能。	布尔型，取值包括： true：表示使能DHCP服务器功能。 false：表示去使能DHCP服务器功能。缺省值是false。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/user-defined-options/user-defined-option/option-code	表示自定义选项的数值。	整数形式，取值范围是1～254，但1、3、6、15、44、46、50、51、52、53、54、55、57、58、59、61、82、120、121、184不能配置。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/user-defined-options/user-defined-option	表示自定义选项的类型。节点包括： ip-address：自定义的选项为IP地址类型。 ascii-string：自定义的选项为ASCII字符串类型。 cipher-string：自定义的选项为密文字符串类型。 hex-string：自定义的选项为十六进制字符串类型。	ip-address：点分十进制形式。 ascii-string：自字符串形式，长度范围是1～255。 cipher-string：字符串形式，显示密码时长度范围是1～64、密文密码时长度范围32～104。 hex-string：偶数位长度的十六进制字符串（如hh或hhhh），长度范围是2～254，可以配置为包含0～9、A～F和a～f的组合。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/logging/type	开启DHCP服务器分配IP地址时记录日志的功能。	枚举类型。取值包括：renew-success，表示地址续租成功时打印日志。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/ip-range/ip-subnet	配置DHCP服务器分配给DHCP客户端的IP地址范围。节点包括： start-ip-address：起始IP地址。 end-ip-address：结束IP地址。	start-ip-address：点分十进制形式。 end-ip-address：点分十进制形式。	NA
huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/mask/mask/ip-prefix/ip-prefix	DHCP服务器分配给DHCP客户端的IP地址的子网掩码。	点分十进制形式。	NA
huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/mask/mask/length/length	DHCP服务器分配给DHCP客户端的IP地址的子网掩码。	整数形式，取值范围是0～32。	NA
huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/conflict-recycle	开启冲突地址的自动回收功能，并配置自动回收的时间间隔。节点包括： day：自动回收时间间隔的天数。 hour：自动回收时间间隔的小时数。 minute：自动回收时间间隔的分钟数。	day：整数形式，取值范围是0～999，单位是天。缺省值是0。 hour：整数形式，取值范围是0～23，单位是小时。缺省值是0。 minute：整数形式，取值范围是0～59，单位是分钟。缺省值是0。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/gateway	配置DHCP服务器分配给DHCP客户端的默认网关地址。	点分十进制形式。	NA
huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/sip-server	配置DHCP服务器分配给DHCP客户端的SIP服务器的IP地址。	点分十进制形式。	NA
huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/boot-file	配置DHCP服务器分配给DHCP客户端的配置文件的名称。	字符串形式，不支持空格，区分大小写，长度范围是1～127。	NA
huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/next-server	配置DHCP服务器分配给DHCP客户端的启动过程中下一步使用的网络服务器IP地址。	点分十进制形式。	NA
huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/pool-type/interface-pool/interface-pool/option121	配置DHCP服务器分配给DHCP客户端的Option121选项（无分类静态路由）。	点分十进制形式。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/global-configuration/ping	配置DHCP服务器发送Ping报文的最大数量和最长等待响应时间。节点包括： packet-number：发送Ping报文的最大数量。 interval：等待Ping应答的最长时间。	packet-number：整数形式，取值范围是0～10。0表示不进行Ping操作。 interval：整数形式，取值范围是0～10000，单位是毫秒。0表示不进行Ping操作。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/global-configuration/database	是否开启将当前DHCP数据保存到存储设备的功能。节点包括： enable：开启DHCP数据保存功能。 recover：从存储设备恢复DHCP数据。 write-delay：保存时延，即间隔多长时间执行一次保存操作。	enable：仅支持配置为true。 recover：– write-delay：整数形式，取值范围是300～86400，单位是秒。缺省值是7200秒。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/enable	是否配置接口采用全局地址池的DHCP Server功能。	布尔型，取值包括： true：表示配置接口采用全局地址池的DHCP Server功能。 false：表示未配置接口采用全局地址池的DHCP Server功能。缺省值是false。	NA

表2-272 huawei-address-management.yang的数据模型

节点	说明	取值范围	备注
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/name	全局地址池的名称。	字符串形式，不支持空格，长度范围是1～64，可以设定为包含数字、字母、和特殊字符（例如“_”、“-”或“.”）的组合，不能为“-”或“--”。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/network	全局地址池下可分配的网段地址。节点包括： ip-address：网络地址段。 mask：网络掩码。 mask-length：网络掩码长度。	ip-address：点分十进制形式。 mask：点分十进制形式。 mask-length：整数形式，取值范围是0～32。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/lease	全局地址池内IP地址的租期。节点包括： unlimited：无限期。 lease-time：租期时长，由day、hour和minute组成。	unlimited：- day：整数形式，取值范围是0～999，单位是天。缺省值是1。 hour：整数形式，取值范围是0～23，单位是小时。缺省值是0。 minute：整数形式，取值范围是0～59，单位是分钟。缺省值是0。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/excluded-address/ip-subnet	全局地址池内不参与分配的IP地址。节点包括： start-ip-address：起始IP地址。 end-ip-address：结束IP地址。	start-ip-address：点分十进制形式。 end-ip-address：点分十进制形式。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/static-binding/address-binding	全局地址池内静态绑定的IP地址。节点包括： ip-address：绑定的IP地址。 mac-address：用户的MAC地址。	ip-address：点分十进制形式。 mac-address：格式为H-H-H，其中H为1至4位的十六进制数。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/gateway	配置分配给DHCP客户端的网关地址。	点分十进制形式。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/dns/dns-server/ip-address	配置分配给DHCP客户端的DNS服务器的IP地址。	点分十进制形式。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/user-defined-options	配置自定义选项信息。	-	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/section	配置全局地址池中的IP地址段。节点包括： section-id：IP地址段的编号。 start-address：起始IP地址。 end-address：结束IP地址。	section-id：整数形式，取值范围为0～255。 start-address：点分十进制形式。 end-address：点分十进制形式。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/conflict-recycle	开启全局地址池中冲突地址的自动回收功能，并配置自动回收的时间间隔。节点包括： day：自动回收时间间隔的天数。 hour：自动回收时间间隔的小时数。 minute：自动回收时间间隔的分钟数。	day：整数形式，取值范围是0～999，单位是天。缺省值是0。 hour：整数形式，取值范围是0～23，单位是小时。缺省值是0。 minute：整数形式，取值范围是0～59，单位是分钟。缺省值是0。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/logging/log-type	开启DHCP服务器分配IP地址时记录日志的功能。	枚举类型，取值包括： allocation-fail：地址分配失败时打印日志。 allocation-success：地址分配成功时打印日志。 release：地址释放时打印日志。 renew-fail：地址续租失败时打印日志。 renew-success：地址续租成功时打印日志。 detect-conflict：发现地址冲突时打印日志。 recycle-conflict：回收冲突地址时打印日志。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/boot-file	配置分配给DHCP客户端的配置启动配置文件名称。	字符串形式，不支持空格，区分大小写，长度范围是1～127。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/sip-server	配置分配给DHCP客户端的SIP服务器的IP地址或域名。节点包括： ip-address：SIP服务器的IP地址。 domain-name：SIP服务器的域名。	ip-address：点分十进制形式。 domain-name：字符串形式，长度范围为1～63。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/sname	配置DHCP客户端获取启动配置文件的服务器名称。	字符串形式，不支持空格，区分大小写，长度范围是1～63。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/next-server	配置DHCP客户端自动获取IP地址后下一步使用的服务器地址。	点分十进制形式。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/option121	配置分配给DHCP客户端的无分类静态路由。几点包括： destination-ip：目的IP地址和掩码。 gateway-address：网关IP地址。	destination-ip：点分十进制格式/取值范围是0～32的整数。 gateway-address：点分十进制形式。	NA
/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/option184	配置Option184字段的内容。节点包括： ncp-ip：网络呼叫处理器IP地址。 as-ip：备份网络呼叫处理器IP地址。 fail-over：fail-over的IP地址（ip-address）和拨号字符串（dialer-string）。 voice-vlan：Voice-vlan的VLAN编号。	ncp-ip：点分十进制形式。 as-ip：点分十进制形式。 ip-address：点分十进制形式。 dialer-string：字符串形式，取值范围是1～64。 voice-vlan：整数形式，取值范围是1～4094。	NA
/huawei-address-management:address-management-v4-statistics-table/ip-pool-statistics	查看IPv4地址池的统计信息。节点包括： pool-name：地址池的名称。可以使全局地址池也可以是接口地址池。如果不指定该节点，则显示所有地址池的统计信息。 request-from：查看指定表项索引之后的统计信息。 request-num：统计信息显示的条数。	-	NA
/huawei-address-management:address-management-v4-bindings-table/dynamic-bindings	查看IPv4地址池中已分配的地址信息。节点包括： pool-name：地址池的名称。可以使全局地址池也可以是接口地址池。如果不指定该节点，则显示所有已分配的地址信息。 ip-section：查看地址池中指定IP地址范围内的已分配地址信息。 request-from：查看指定表项索引之后的已分配地址信息。 request-num：已分配地址信息显示的条数。	-	NA

创建并配置全局地址池

本章节主要介绍通过rpc方法创建并配置全局地址池。

表2-273 创建并配置全局地址池

操作	XPATH
rpc	/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/name /huawei-address-management:address-management/ipv4/ip-pools/ip-pool/network /huawei-address-management:address-management/ipv4/ip-pools/ip-pool/lease /huawei-address-management:address-management/ipv4/ip-pools/ip-pool/conflict-recycle /huawei-address-management:address-management/ipv4/ip-pools/ip-pool/logging/log-type

数据需求

项目	数据	描述
全局地址池的名称	pool1	全局地址池的名称为pool1。
全局地址池可以动态分配的IP地址范围	ip-address：10.1.1.0 mask-length：24	全局地址池可以动态分配的IP地址范围为10.1.1.0/24。
租期	unlimited	租期为无限长。
配置全局地址池冲突地址回收功能	day：1 hour：0 minute：0	冲突地址回收时间间隔为1天。
配置全局分配IP地址时记录日志的功能	log-type：allocation-fail	地址分配失败时记录日志。

请求示例

<rpc message-id="1" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
      <hw-address-management:address-management xmlns:hw-address-management="urn:huawei:params:xml:ns:yang:huawei-address-management">
        <hw-address-management:ipv4>
          <hw-address-management:ip-pools>
            <hw-address-management:ip-pool>
              <hw-address-management:vsys>pub</hw-address-management:vsys>
              <hw-address-management:name>pool1</hw-address-management:name>
              <hw-address-management:network>
                <hw-address-management:ip-address>10.1.1.0</hw-address-management:ip-address>
                <hw-address-management:mask-length>24</hw-address-management:mask-length>
              </hw-address-management:network>
              <hw-address-management:lease><hw-address-management:unlimited></hw-address-management:unlimited></hw-address-management:lease>
              <hw-address-management:conflict-recycle>
                <hw-address-management:day>1</hw-address-management:day>
                <hw-address-management:hour>0</hw-address-management:hour>
                <hw-address-management:minute>0</hw-address-management:minute>
              </hw-address-management:conflict-recycle>
              <hw-address-management:logging>
                <hw-address-management:log-type>allocation-fail</hw-address-management:log-type>
              </hw-address-management:logging>
            </hw-address-management:ip-pool>
          </hw-address-management:ip-pools>
        </hw-address-management:ipv4>
      </hw-address-management:address-management>
    </config>
  </edit-config>
</rpc>

响应示例

配置成功响应示例。

<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-type>application</error-type>
    <error-tag>operation-failed</error-tag>
    <error-severity>error</error-severity>
    <error-path>/huawei-address-management:address-management/ipv4/ip-pools/ip-pool[vsys='pub'][name='pool1']/network/ip-address</error-path>
    <error-message>parse rpc config error.(Value "10.1.1.1111" does not satisfy the constraint "(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])(%[\p{N}\p{L}]+)?" (range, length, or pattern).).</error-message>
  </rpc-error>
</rpc-reply>

配置分配给DHCP客户端的网络参数

本章节主要介绍通过rpc方法配置分配给DHCP客户端的网络参数。

表2-274 打开DHCP服务器功能

操作	XPATH
rpc	/huawei-address-management:address-management/ipv4/ip-pools/ip-pool/sip-server /huawei-address-management:address-management/ipv4/ip-pools/ip-pool/dns/dns-server /huawei-address-management:address-management/ipv4/ip-pools/ip-pool/sname

数据需求

项目	数据	描述
全局地址池的名称	pool1	全局地址池的名称为pool1。
SIP服务器的IP地址	10.1.20.33	SIP服务器的IP地址为10.1.20.33。
DNS服务器的IP地址	10.3.3.3	DNS服务器的IP地址为10.3.3.3。
DHCP客户端获取启动配置文件的服务器名称	ftpserver	DHCP客户端获取启动配置文件的服务器名称为ftpserver。

请求示例

<rpc message-id="1" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
        <edit-config>
         <target>
          <running/>
         </target>
         <config xmlns:xc="urn:ietf:params:xml:ns:netconf:base:1.0"> 
          <address-management xmlns="urn:huawei:params:xml:ns:yang:huawei-address-management" xc:operation="merge">
           <ipv4>     
            <ip-pools>
             <ip-pool>     
              <name>pool1</name>
              <vsys>pub</vsys>
              <sip-server>        
               <ip-address>10.1.20.33</ip-address>
              </sip-server>
              <dns>         
               <dns-server>
                <ip-address>10.3.3.3</ip-address>
               </dns-server>
              </dns>
              <sname>ftpserver</sname>
             </ip-pool>
            </ip-pools>
           </ipv4>
          </address-management>
         </config>
        </edit-config>
       </rpc>

响应示例

配置成功响应示例。

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="1">
  <ok/>
</rpc-reply>

配置失败响应示例。

<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>Wrong parameter.</error-message>
    <error-info>Error on node /huawei-address-management:address-management/ipv4/ip-pools/ip-pool[vsys="pub",name="pool1"]/sname</error-info>
  </rpc-error>
</rpc-reply>

配置接口采用全局地址池的DHCP服务器功能

本章节主要介绍通过rpc方法配置接口采用全局地址池的DHCP服务器功能。

表2-275 配置接口采用全局地址池的DHCP服务器功能

操作	XPATH
rpc	/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-server-configuration/dhcp-servers/dhcp-server/enable

数据需求

项目	数据	描述
是否配置接口采用全局地址池的DHCP服务器功能	true	配置接口采用全局地址池的DHCP服务器功能。

请求示例

<rpc message-id="1" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
      <if:interfaces xmlns:ip="urn:ietf:params:xml:ns:yang:ietf-ip"
                     xmlns:if="urn:ietf:params:xml:ns:yang:ietf-interfaces">
       <if:interface xmlns:ns0="urn:ietf:params:xml:ns:netconf:base:1.0" ns0:operation="merge">
        <if:name>Vlanif9</if:name>
        <if:type xmlns:x="urn:ietf:params:xml:ns:yang:iana-if-type">x:propVirtual</if:type>
         <ip:ipv4 xmlns="urn:ietf:params:xml:ns:yang:ietf-ip">
         <ip:address ns0:operation="merge">
          <ip:ip>10.10.10.44</ip:ip>
          <ip:netmask>255.255.255.0</ip:netmask>
         </ip:address>
        </ip:ipv4>
       </if:interface>
      </if:interfaces>
      <hw-dhcp:dhcp-config xmlns:hw-dhcp="urn:huawei:params:xml:ns:yang:huawei-dhcp">
        <hw-dhcp:dhcpv4-config>
          <hw-dhcp:enable>true</hw-dhcp:enable>
          <hw-dhcp:dhcp-server-configuration>
            <hw-dhcp:dhcp-servers>
              <hw-dhcp:dhcp-server>
                <hw-dhcp:interface-name>Vlanif9</hw-dhcp:interface-name>
                <hw-dhcp:enable>true</hw-dhcp:enable>
                <hw-dhcp:global-pool/>
              </hw-dhcp:dhcp-server>
            </hw-dhcp:dhcp-servers>
          </hw-dhcp:dhcp-server-configuration>
        </hw-dhcp:dhcpv4-config>
      </hw-dhcp:dhcp-config>
    </config>
  </edit-config>
</rpc>

响应示例

配置成功响应示例。

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="1">
  <ok/>
</rpc-reply>

配置DHCP中继

数据模型

DHCP中继对应的数据模型文件名为huawei-dhcp.yang。

表2-276 DHCP中继数据模型

节点	说明	取值范围	备注
/huawei-dhcp:dhcp-config/dhcpv4-config/enable	表示使能DHCP功能。	布尔型，取值包括： true：表示使能DHCP功能。 false：表示去使能DHCP功能。缺省值是false。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-relay-configuration/dhcp-relays/dhcp-relay/enable	表示使能DHCP中继功能。	布尔型，取值包括： true：表示使能DHCP中继功能。 false：表示去使能DHCP中继功能。缺省值是false。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-relay-configuration/dhcp-relays/dhcp-relay/server-ip	表示DHCP中继所代理的DHCP服务器的IP地址。	点分十进制格式。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-relay-configuration/global-configuration/server-cycle-enable	表示是否使能DHCP中继的轮询功能。	布尔型，取值包括： true：表示使能DHCP中继的轮询功能。 false：表示去使能DHCP中继的轮询功能。缺省值是false。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-relay-configuration/dhcp-relays/dhcp-relay/relay-information/enable	表示是否使能DHCP中继支持Option82选项功能。	布尔型，取值包括： true：表示使能DHCP中继支持Option82选项功能。 false：表示去使能DHCP中继支持Option82选项功能。缺省值是false。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-relay-configuration/dhcp-relays/dhcp-relay/anycast-gw-reroute-enable	表示是否使能DHCP中继支持分布式网关重选路由功能。	布尔型，取值包括： true：表示使能DHCP中继支持分布式网关重选路由功能。 false：表示去使能DHCP中继支持分布式网关重选路由功能。缺省值是false。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-option82-configuration/option82-enable	表示是否使能在DHCP报文中添加Option82选项功能。支持在接口、VLAN、VLAN内的接口（vlan-and-interface）和BD下配置插入方式为Insert方式（insert-enable）或Rebuild方式（rebuild-enable）。	enable-mode：布尔型，取值包括：缺省值是false。 true：表示使能在DHCP报文中添加Option82选项功能。 false：表示去使能在DHCP报文中添加Option82选项功能。 vlan-id：整数形式，取值范围是1～4094。 interface-name：接口名称。 bd-id：必须是已经存在的BD的ID。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-option82-configuration/sub-option-enable	表示是否使能在Option82选项中的插入子选项的功能。支持在全局、接口、VLAN和BD下配置插入子选项1（circuit-id-enable）、子选项2（remote-id-enable）、子选项6（subscriber-id-enable）和子选项9（vendor-specific-enable）。说明： 4个子选项不能同时插入。	布尔型，取值包括： true：表示使能在Option82选项中的插入子选项的功能。 false：表示去使能在Option82选项中的插入子选项的功能。缺省值是false。	NA
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-option82-configuration/option82-format/vendor-specific-format/global/vendor-sub-option/option-format	表示Option82选项中子选项9的格式。取值包括： ip-address：子选项9的格式为IP地址类型。 ascii-string：子选项9的格式为ASCII字符串类型。 sysname：子选项9的格式为设备名称。 hex-string：子选项9的格式为十六进制字符串类型。	ip-address：点分十进制格式。 ascii-string：ASCII字符串形式，长度小于129个字符。 sysname：– hex-string：十六进制字符串形式。只能配置为0～9，A～F或者a～f范围段的字符。去掉空格后长度必须是偶数并且小于257。	NA

打开DHCP中继功能

本章节主要介绍通过rpc方法打开DHCP中继功能。

表2-277 打开DHCP中继功能

操作	XPATH
rpc	/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-relay-configuration/dhcp-relays

数据需求

项目	数据	描述
DHCP功能	true	在接口VLANIF3开启DHCP中继功能，代理的DHCP服务器的IP地址为10.1.1.2。
DHCP中继功能	true
接口名称	VLANIF3
DHCP中继代理的DHCP服务器的IP地址	10.1.1.2

请求示例

<rpc message-id="123" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
      <huawei-vlan:vlans xmlns:huawei-vlan="urn:huawei:params:xml:ns:yang:huawei-vlan">
        <huawei-vlan:vlan>
          <huawei-vlan:id>3</huawei-vlan:id>
        </huawei-vlan:vlan>
      </huawei-vlan:vlans>
      <if:interfaces xmlns:if="urn:ietf:params:xml:ns:yang:ietf-interfaces">
        <if:interface>
          <if:name>Vlanif3</if:name>
          <if:type xmlns:iana-if-type="urn:ietf:params:xml:ns:yang:iana-if-type">iana-if-type:propVirtual</if:type>
          <ip:ipv4 xmlns:ip="urn:ietf:params:xml:ns:yang:ietf-ip">
            <ip:address>
              <ip:ip>192.168.10.1</ip:ip>
              <ip:prefix-length>24</ip:prefix-length>
            </ip:address>
          </ip:ipv4>
        </if:interface>
      </if:interfaces>
      <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-vlan:vlan xmlns:huawei-vlan="urn:huawei:params:xml:ns:yang:huawei-vlan">
            <huawei-vlan:port-link-type>trunk</huawei-vlan:port-link-type>
            <huawei-vlan:trunk>
              <huawei-vlan:trunk-vlan>3</huawei-vlan:trunk-vlan>
            </huawei-vlan:trunk>
          </huawei-vlan:vlan>
        </if:interface>
      </if:interfaces>
      <hw-dhcp:dhcp-config xmlns:hw-dhcp="urn:huawei:params:xml:ns:yang:huawei-dhcp">
        <hw-dhcp:dhcpv4-config>
          <hw-dhcp:enable>true</hw-dhcp:enable>
          <hw-dhcp:dhcp-relay-configuration>
            <hw-dhcp:dhcp-relays>
              <hw-dhcp:dhcp-relay>
                <hw-dhcp:interface-name>Vlanif3</hw-dhcp:interface-name>
                <hw-dhcp:enable>true</hw-dhcp:enable>
                <hw-dhcp:server-ip>10.1.1.2</hw-dhcp:server-ip>
              </hw-dhcp:dhcp-relay>
            </hw-dhcp:dhcp-relays>
          </hw-dhcp:dhcp-relay-configuration>
        </hw-dhcp:dhcpv4-config>
      </hw-dhcp:dhcp-config>
    </config>
  </edit-config>
</rpc>

响应示例

配置成功响应示例。

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="123">
  <ok/>
</rpc-reply>

配置失败响应示例。

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="123">
  <rpc-error>
    <error-app-tag>-1</error-app-tag>
    <error-message> Please enable DHCP in the global view first.</error-message>
    <error-info>Error on node /huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-relay-configuration/dhcp-relays/dhcp-relay[interface-name="Vlanif3"]/enable</error-info>
  </rpc-error>
</rpc-reply>

配置DHCP中继分布式网关重选路由功能

本章节主要介绍通过rpc方法配置DHCP中继分布式网关重选路由功能。

配置该功能前需要配置Option82选项功能来携带DHCP报文的回程信息。Option82选项的配置请参见配置Option82功能。

表2-278 配置DHCP中继分布式网关重选路由功能

操作	XPATH
rpc	/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-relay-configuration/dhcp-relays/dhcp-relay/anycast-gw-reroute-enable

数据需求

项目	数据	描述
是否使能DHCP功能	true	使能DHCP功能
是否使能DHCP中继功能	true	使能DHCP中继功能
接口名称	VBDIF26	使能中继功能的接口为VLANIF3
是否使能DHCP中继分布式网关重选路由功能	true	使能DHCP中继分布式网关重选路由功能

请求示例

<rpc message-id="123" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
    <bd:bridge-domains xmlns:bd="urn:huawei:params:xml:ns:yang:huawei-bd" xmlns:xc="urn:ietf:params:xml:ns:netconf:base:1.0" xc:operation="merge">
        <bd:bridge-domain>
        <bd:id>26</bd:id>
        </bd:bridge-domain>
    </bd:bridge-domains>
    <interfaces xmlns="urn:ietf:params:xml:ns:yang:ietf-interfaces">
     <interface xmlns:ns0="urn:ietf:params:xml:ns:netconf:base:1.0" ns0:operation="merge">
      <name>Vbdif26</name>
      <type xmlns:x="urn:ietf:params:xml:ns:yang:iana-if-type">x:propVirtual</type>
     </interface>
    </interfaces>
    <dhcp-config xmlns="urn:huawei:params:xml:ns:yang:huawei-dhcp">
     <dhcpv4-config>
      <enable>true</enable>
      <dhcp-relay-configuration>
       <dhcp-relays>
        <dhcp-relay xmlns:ns0="urn:ietf:params:xml:ns:netconf:base:1.0" ns0:operation="merge">
         <interface-name>Vbdif26</interface-name>
          <enable>true</enable>
          <anycast-gw-reroute-enable>true</anycast-gw-reroute-enable>
         </dhcp-relay>
        </dhcp-relays>
       </dhcp-relay-configuration>
      </dhcpv4-config>
     </dhcp-config>
    </config>
  </edit-config>
</rpc>

响应示例

配置成功响应示例。

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="123">
  <ok/>
</rpc-reply>

配置失败响应示例。

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="11">
  <rpc-error>
    <error-type>application</error-type>
    <error-tag>operation-failed</error-tag>
    <error-severity>error</error-severity>
    <error-path>/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-relay-configuration/dhcp-relays/dhcp-relay[interface-name='Vbdif26']/anycast-gw-reroute-enable</error-path>
    <error-message>parse rpc config error.(Invalid value in "anycast-gw-reroute-enable" element.).</error-message>
  </rpc-error>
</rpc-reply>

配置Option82功能

本章节主要介绍通过rpc方法配置Option82功能。

表2-279 配置Option82功能

操作	XPATH
rpc	/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-relay-configuration/dhcp-relays/dhcp-relay/relay-information/enable /huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-option82-configuration/option82-enable /huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-option82-configuration/sub-option-enable /huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-option82-configuration/option82-format/vendor-specific-format/global/vendor-sub-option/option-format

操作

XPATH

rpc

/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-relay-configuration/dhcp-relays/dhcp-relay/relay-information/enable
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-option82-configuration/option82-enable
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-option82-configuration/sub-option-enable
/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-option82-configuration/option82-format/vendor-specific-format/global/vendor-sub-option/option-format

数据需求

项目	数据	描述
是否使能DHCP中继支持Option82选项功能	true	使能DHCP中继支持Option82选项功能
是否使能在DHCP报文中添加Option82选项功能	true	使能在DHCP报文中添加Option82选项功能
是否使能在Option82选项中的插入子选项9的功能。	true	使能在Option82选项中的插入子选项9的功能
Option82选项中子选项9的格式	ip-address	Option82选项中子选项9的格式为IP地址格式

请求示例

<rpc message-id="123" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
    <bd:bridge-domains xmlns:bd="urn:huawei:params:xml:ns:yang:huawei-bd" xmlns:xc="urn:ietf:params:xml:ns:netconf:base:1.0" xc:operation="merge">
        <bd:bridge-domain>
        <bd:id>26</bd:id>
        </bd:bridge-domain>
    </bd:bridge-domains>
    <interfaces xmlns="urn:ietf:params:xml:ns:yang:ietf-interfaces">
     <interface xmlns:ns0="urn:ietf:params:xml:ns:netconf:base:1.0" ns0:operation="merge">
      <name>Vbdif26</name>
      <type xmlns:x="urn:ietf:params:xml:ns:yang:iana-if-type">x:propVirtual</type>
     </interface>
    </interfaces>
    <dhcp-config xmlns="urn:huawei:params:xml:ns:yang:huawei-dhcp">
     <dhcpv4-config>
      <enable>true</enable>
      <dhcp-relay-configuration>
       <dhcp-relays>
        <dhcp-relay xmlns:ns0="urn:ietf:params:xml:ns:netconf:base:1.0" ns0:operation="merge">
         <interface-name>Vbdif26</interface-name>
          <enable>true</enable>
          <relay-information>
           <enable>true</enable>
          </relay-information>
         </dhcp-relay>
        </dhcp-relays>
       </dhcp-relay-configuration>
          <hw-dhcp:dhcp-option82-configuration>
            <hw-dhcp:option82-enable>
              <hw-dhcp:bd>
                <hw-dhcp:bd-id>26</hw-dhcp:bd-id>
                <hw-dhcp:insert-enable>true</hw-dhcp:insert-enable>
              </hw-dhcp:bd>
            </hw-dhcp:option82-enable>
            <hw-dhcp:option82-format>
              <hw-dhcp:vendor-specific-format>
                <hw-dhcp:global>
                  <hw-dhcp:vsys>pub</hw-dhcp:vsys>
                  <hw-dhcp:vendor-sub-option>
                    <hw-dhcp:sub-option-code>23</hw-dhcp:sub-option-code>
                    <hw-dhcp:ip-address>10.1.1.1</hw-dhcp:ip-address>
                  </hw-dhcp:vendor-sub-option>
                </hw-dhcp:global>
              </hw-dhcp:vendor-specific-format>
            </hw-dhcp:option82-format>
            <hw-dhcp:sub-option-enable>
              <hw-dhcp:bd xmlns:xc="urn:ietf:params:xml:ns:netconf:base:1.0" xc:operation="merge">
                <hw-dhcp:bd-id>26</hw-dhcp:bd-id>
                <hw-dhcp:vendor-specific-enable>true</hw-dhcp:vendor-specific-enable>
              </hw-dhcp:bd>
            </hw-dhcp:sub-option-enable>
          </hw-dhcp:dhcp-option82-configuration>
      </dhcpv4-config>
     </dhcp-config>
    </config>
  </edit-config>
</rpc>

响应示例

配置成功响应示例。

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="123">
  <ok/>
</rpc-reply>

配置失败响应示例。

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="47">
  <rpc-error>
    <error-type>application</error-type>
    <error-tag>operation-failed</error-tag>
    <error-severity>error</error-severity>
    <error-path>/huawei-dhcp:dhcp-config/dhcpv4-config/dhcp-relay-configuration/dhcp-relays/dhcp-relay[interface-name='Vlanif4000']/relay-information/enable</error-path>
    <error-message>parse rpc config error.(Invalid value in "enable" element.).</error-message>
  </rpc-error>
</rpc-reply>

配置DHCP客户端

数据模型

DHCP客户端对应的数据模型文件名为huawei-ip.yang。

表2-280 DHCP客户端数据模型

节点	说明	取值范围	备注
/ietf-interfaces:interfaces/interface/ietf-ip:ipv4/huawei-ip:ip-address-extend-type	表示开启接口的DHCP客户端功能。	IdentityRef类型，取值如下： dhcp：接口通过DHCP获取IP地址。 static：接口的IP地址是手动配置的。	NA

节点

说明

取值范围

备注

/ietf-interfaces:interfaces/interface/ietf-ip:ipv4/huawei-ip:ip-address-extend-type

表示开启接口的DHCP客户端功能。

IdentityRef类型，取值如下：

dhcp：接口通过DHCP获取IP地址。
static：接口的IP地址是手动配置的。

配置接口的DHCP客户端功能

本章节主要介绍通过config方法配置接口的DHCP客户端功能。

表2-281 配置接口的DHCP客户端功能

操作	XPATH
config	/ietf-interfaces:interfaces/interface/ietf-ip:ipv4/huawei-ip:ip-address-extend-type

数据需求

项目	数据	描述
接口名称	Vlanif2	配置接口VLANIF2的DHCP客户端，接口通过DHCP获取IP地址。
配置接口的DHCP客户端功能	dhcp	配置接口VLANIF2的DHCP客户端，接口通过DHCP获取IP地址。

请求示例

<?xml version='1.0' encoding='UTF-8'?>
<rpc message-id="2" 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>Vlanif2</if:name>
          <if:type xmlns:iana-if-type="urn:ietf:params:xml:ns:yang:iana-if-type">iana-if-type:propVirtual</if:type>
          <ip:ipv4 xmlns:ip="urn:ietf:params:xml:ns:yang:ietf-ip">
            <hw-ip:ip-address-extend-type xmlns:hw-ip="urn:huawei:params:xml:ns:yang:hw-ip">dhcp</hw-ip:ip-address-extend-type>
          </ip:ipv4>
        </if:interface>
      </if:interfaces>
    </config>
  </edit-config>
</rpc>

响应示例

配置成功响应示例。

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="2">
  <ok/>
</rpc-reply>

配置失败响应示例。

<?xml version='1.0' encoding='UTF-8'?>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="2">
  <rpc-error>
    <error-type>application</error-type>
    <error-tag>operation-failed</error-tag>
    <error-severity>error</error-severity>
    <error-path>/ietf-interfaces:interfaces/interface[name='Vlanif2']/ietf-ip:ipv4/huawei-ip:ip-address-extend-type</error-path>
    <error-message>parse rpc config error.(Failed to resolve identityref "huawei-ip:dhc".).</error-message>
  </rpc-error>
</rpc-reply>

配置基于接口地址池的DHCP服务器功能
配置基于全局地址池的DHCP服务器功能
配置DHCP中继
配置DHCP客户端
- 数据模型
- 配置接口的DHCP客户端功能

翻译

English

下载文档

更新时间：2022-05-25

文档编号：EDOC1100127118

浏览量：14808

下载量：1049

平均得分:

本文档适用于这些产品

数字签名

数字签名验证工具

本文档介绍了设备支持的NETCONF YANG API功能，包括数据模型及相关示例。

配置基于接口地址池的DHCP服务器功能

数据模型

打开DHCP服务器功能

数据需求

请求示例

响应示例

配置自定义选项

数据需求

请求示例

响应示例

配置基于全局地址池的DHCP服务器功能

数据模型

创建并配置全局地址池

数据需求

请求示例

响应示例

配置分配给DHCP客户端的网络参数

数据需求

请求示例

响应示例

配置接口采用全局地址池的DHCP服务器功能

数据需求

请求示例

响应示例

配置DHCP中继

数据模型

打开DHCP中继功能

数据需求

请求示例

响应示例

配置DHCP中继分布式网关重选路由功能

数据需求

请求示例

响应示例

配置Option82功能

数据需求

请求示例

响应示例

配置DHCP客户端

数据模型

配置接口的DHCP客户端功能

数据需求

请求示例

响应示例

相关版本

相关文档

数字签名