11-网络管理和监控配置指导

设备收到订阅报文后会回应客户端，当客户端收到如下报文时，表示订阅成功：

<create-subscription xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0">

<stream>NETCONF</stream>

<Group>group</Group>

<Severity>severity</Severity>

</event>

</filter>

<startTime>start-time</startTime>

</create-subscription>

</rpc>

其中：

· stream表示支持的事件流，目前只支持NETCONF。

· event表示订阅的事件。

· code表示日志信息中的助记符。

· group表示日志信息中的模块名。

· severity表示日志信息中的安全级别。

· start-time表示订阅的开始时间。

· stop-time表示结束订阅的时间。

2. 结果验证

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

<ok/>

</rpc-reply >

当订阅出错时设备会返回错误信息，例如：

客户端订阅没有时间限制的全部事件。订阅后在断开连接之前，设备发生的所有事件都会发送给客户端。

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

<rpc-error>

<error-type>error-type</error-type>

<error-tag>error-tag</error-tag>

<error-severity>error-severity</error-severity>

<error-message xml:lang="en">error-message</error-message>

</rpc-error>

</rpc-reply>

错误报文的详细定义请参见RFC 4741。

1.7.2 订阅事件举例

1. 组网需求

2. 配置步骤

# 进入XML视图。

# 进行能力交换。

urn:ietf:params:netconf:base:1.0

</capability>

</capabilities>

</hello>

# 订阅全部事件，不限制订阅时间。

xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">

<create-subscription xmlns ="urn:ietf:params:xml:ns:netconf:notification:1.0">

<stream>NETCONF</stream>

</create-subscription>

</rpc>

3. 结果验证

# 如果客户端收到如下报文，则表示订阅成功：

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

<ok/>

</rpc-reply>

当设备上的风扇1有问题时，设备会发送如下报文来通知订阅客户端：

<Code>FAN_DIRECTION_NOT_PREFERRED</Code>

<Severity>Alert</Severity>

<context>Fan 1 airflow direction is not preferred on slot 6, please check it.</context>

</event>

</notification>

当用户（IP地址为192.168.100.130）登录设备时，设备会发送如下报文来通知订阅客户端：

只有持有锁的用户可以解锁，解锁后其他用户才可以修改设备的当前配置或另外加锁。如果持有锁的用户的当前连接断开，系统会自动解锁。

<Group>SHELL</Group>

<Code>SHELL_LOGIN</Code>

<Severity>Notification</Severity>

<context>VTY logged in from 192.168.100.130.</context>

</event>

</notification>

1.8 给当前配置加锁/解锁

因为设备同时可以建立多个NETCONF连接，即支持多个用户同时使用NETCONF功能管理和监控设备。所以，当用户管理、维护设备或者定位网络问题时，为防止其他NETCONF用户修改当前配置、引入干扰，可以使用本特性给当前配置加锁。给当前配置加锁后，只有持有锁的用户可以修改设备的当前配置，其他NETCONF用户只能读取，不能修改当前配置。

1.8.1 给当前配置加锁

1. 客户端发送报文

目前设备只支持对当前配置加锁，不能对具体的功能模块进行加锁。请将以下报文拷贝、粘贴到客户端，用户即能完成加锁操作：

设备收到加锁报文后会回应客户端，当客户端收到如下报文时，表示加锁成功：

<lock>

</target>

</lock>

</rpc>

2. 结果验证

请将以下报文拷贝、粘贴到客户端，用户即能完成解锁操作：

<rpc-reply message-id="100"

xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">

<ok/>

</rpc-reply>

1.8.2 给当前配置解锁

只有锁的持有用户才能解锁，其它用户不能解锁。

1. 客户端发送报文

设备收到解锁报文后会回应客户端，当客户端收到如下报文时，表示解锁成功：

</target>

</unlock>

</rpc>

2. 结果验证

<rpc-reply message-id="100"

xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">

<ok/>

</rpc-reply>

1.8.3 当前配置加锁举例

1. 组网需求

给设备加锁，以免其它用户使用XML语言修改设备的当前配置。

2. 配置步骤

# 进入XML视图。

# 进行能力交换。

urn:ietf:params:netconf:base:1.0

</capability>

</capabilities>

</hello>

# 对当前配置加锁。

<lock>

</target>

</lock>

</rpc>

3. 结果验证

# 如果客户端收到如下报文，则表示加锁成功：

用户加锁成功后，另一客户端发送加锁报文，设备会返回如下报文：

<rpc-reply message-id="100"

xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">

<ok/>

</rpc-reply>

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

<rpc-error>

<error-type>protocol</error-type>

<error-tag>lock-denied</error-tag>

<error-severity>error</error-severity>

<error-message xml:lang="en">Lock failed because the NETCONF lock is held by another session.</error-message>

<error-info>

<session-id>1</session-id>

</error-info>

</rpc-error>

</rpc-reply>

以上报文表明：加锁失败，session-id是1的用户已经持有锁。

1.9 业务处理功能

NETCONF支持用户对设备进行业务操作，包括对指定信息的获取和修改。基本标签有<get>、<get-bulk>、<get-config>、<get-bulk-config>和<edit-config>，分别用来获取所有数据、获取配置数据和编辑指定模块的数据。详细规则参见《NETCONF XML API 手册》。

1.9.1 <get>/<get-bulk>获取信息

<get>操作用来获取数据，包括运行状态数据和配置数据。

<get-bulk>操作用来从指定索引的下一条开始批量获取后续N条数据（索引行数据不返回），包括运行状态数据和配置数据。用户通过index属性由指定索引，通过count属性指定N。如未指定索引，则以第一条为索引；如未指定N，或者数据表中符合条件的数据记录不足N条，则返回表中所有剩下的数据条目。

<get>操作会返回所有符合条件的数据，在某些情况下，会导致获取数据效率不高。<get-bulk>允许用户从固定数据项开始，向后获取指定条目的数据记录。

1. 客户端发送报文

<get>和<get-bulk>报文的通用格式如下：

· 如果不指定模块（子模块），则表示全部模块（子模块）。一旦指定模块（子模块），则返回数据只包含指定模块（子模块）。

<getoperation>

指定模块，子模块，表名，列名

</top>

</filter>

</getoperation>

</rpc>

其中，getoperation可以为get或者get-bulk。<filter>选项用于过滤信息，<filter>中可包括模块名、子模块名、表名和列名：

· 如果模块下不指定表，则表示全部表。一旦指定表，则返回数据只包含指定表。

· 如果只指定索引列，则返回的数据包括全部的列。如果同时指定了索引列之外的其他列，则意味着返回的数据仅仅包含索引列和指定的列。

<get-bulk>操作报文中还可以携带count和index参数，如下为一个携带了count和index参数的<get-bulk>操作报文示例：

设备收到配置获取请求报文后会将相应参数的值通过如下报文反馈给客户端：

<get-bulk>

<Log>

</Log>

</Logs>

</Syslog>

</top>

</filter>

</get-bulk>

</rpc>

其中，<get-bulk>操作报文中的count属性遵循如下约定：

· count属性的位置在可以从top下的节点开始，到表节点为止，即：模块节点，表节点这几个位置都能放置count属性，其他位置的count将不被解释。

· 如果count放在模块节点上，则报文中指定的子孙节点（表）中没有count的都默认count属性的值和模块一致。

· 如果不指定count，则获取出从指定索引开始的所有数据。

2. 结果验证

<rpc-reply message-id="100"

xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">

<data>

全部配置数据和状态数据

</data>

</rpc-reply>

1.9.2 <get-config>/<get-bulk-config>获取配置信息

<get-config>和<get-bulk-config>用来获取系统中所有可配置的变量的值，配置的方式包括CLI、MIB等。<get-config>和<get-bulk-config>操作报文中可以包含子标签<filter>，用来对要获取的信息进行过滤。

1. 客户端发送报文：

<get-config>和<get-bulk-config>的通用报文格式如下：

设备收到配置获取请求报文后会将相应配置通过如下报文反馈给客户端：

<get-config>

</source>

指定模块，子模块，表名，列名

</top>

</filter>

</get-config>

</rpc>

2. 结果验证

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

<data>

所有指定filter内的数据

</data>

</rpc-reply>

1.9.3 <edit-config>编辑指定模块数据

<edit-config>支持如下选项：merge、create、replace、remove、delete、默认操作选项、默认错误处理选项、测试处理、增量下发，关于这些选项的详细描述请参见“2 Comware V7中支持的NETCONF操作类型”。

1. 客户端发送报文

<edit-config>

<error-option>

失败时默认操作

</error-option>

指定模块名，子模块名，列名，表名

</top>

</config>

</edit-config>

</rpc>

2. 结果验证

· 设备收到edit-config请求后会回应客户端，当客户端收到如下报文时，表示设置成功：

<?xml version="1.0">

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

<ok/>

</rpc-reply>

· 另外，用户还可以通过<get>操作可以查看参数的当前值是否和edit-config操作设置的值一致。

1.9.4 举例——获取所有模块所有配置数据

1. 组网需求

获取所有模块所有配置数据。

2. 配置步骤

# 进入XML视图。

# 进行能力交换。

urn:ietf:params:netconf:base:1.0

</capability>

</capabilities>

</hello>

# 获取所有模块所有配置数据。

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:web="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="100">

xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">

<get-config>

</source>

</get-config>

</rpc>

3. 结果验证

# 如果客户端收到类似如下的报文，则表示操作成功：

<data>

<Ifmgr>

</Interface>

</Interface>

</Interface>

</Interface>

</Interface>

</Interfaces>

</Ifmgr>

</LogBuffer>

</Syslog>

<ZoneName>beijing</ZoneName>

</TimeZone>

</Device>

</System>

</top>

</data>

</rpc-reply>

1.9.5 举例——获取Syslog模块的所有配置数据

1. 组网需求

获取Syslog模块的所有配置数据

2. 配置步骤

# 进入XML视图。

# 进行能力交换。

urn:ietf:params:netconf:base:1.0

</capability>

</capabilities>

</hello>

# 获取Syslog模块的所有配置数据。

xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">

<get-config>

</source>

</top>

</filter>

</get-config>

</rpc>

3. 结果验证

# 如果客户端收到类似如下的报文，则表示操作成功：

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

<data>

</LogBuffer>

</Syslog>

</top>

</data>

</rpc-reply>

1.9.6 举例——取接口表的一条数据

1. 组网需求

取接口表的一条数据

2. 配置步骤

# 进入XML视图。

# 进行能力交换。

<capability>urn:ietf:params:netconf:base:1.0</capability>

</capabilities>

</hello>

# 取接口表的一条数据。

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:web="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="100">

<get-bulk>

<Ifmgr>

</Interfaces>

</Ifmgr>

</top>

</filter>

</get-bulk>

</rpc>

3. 结果验证

# 如果客户端收到类似如下的报文，则表示操作成功：

<data>

<Ifmgr>

<Name>FortyGigE1/0/2</Name>

<Description>FortyGigE1/0/2 Interface</Description>

</Interface>

</Interfaces>

</Ifmgr>

</top>

</data>

</rpc-reply>

1.9.7 举例——修改参数值

1. 组网需求

修改syslog模块中的日志缓冲区可存储的信息条数为512。

2. 配置步骤

# 进入XML视图。

# 进行能力交换。

<capability>urn:ietf:params:netconf:base:1.0</capability>

</capabilities>

</hello>

# 把Syslog模块LogBuffer表中的BufferSize列，改成512。

<edit-config>

</target>

</LogBuffer>

</Syslog>

</top>

</config>

</edit-config>

</rpc>

3. 结果验证

# 如果客户端收到类似如下的报文，则表示操作成功：

请将以下报文拷贝、粘贴到客户端，用户即可将设备的当前配置保存到指定名称的文件中，同时该文件将自动作为下次启动配置文件：

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

<ok/>

</rpc-reply>

1.10 配置保存、回滚、加载

使用NETCONF功能，用户可以对设备配置进行保存、回滚和加载操作。

1.10.1 配置保存

1. 客户端发送报文

设备收到配置保存请求后会回应客户端，当客户端收到如下报文时，表示保存成功：

<save>

<file>指定文件的名称</file>

</save>

</rpc>

其中，“指定文件的名称”必须以存储介质的名称开头，后缀为.cfg，配置文件保存路径和文件名称的总长度不能超过191个字符。当报文中存在<file>列时，必须输入指定文件的名称，不能为空；如果不存在该列，则设备会自动将当前配置保存到缺省主用下次启动配置文件中。

2. 结果验证

请将以下报文拷贝、粘贴到客户端，用户即可将设备的当前配置恢复到指定配置文件中的配置：

<rpc-reply message-id="100"

xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">

<ok/>

</rpc-reply>

1.10.2 配置文件回滚

1. 客户端发送报文

设备收到配置回滚请求后会回应客户端，当客户端收到如下报文时，表示配置回滚成功：

<file>指定文件的名称</file>

</rollback>

</rpc>

其中，“指定文件的名称”必须以存储介质的名称开头，后缀为.cfg，配置文件保存路径和文件名称的总长度不能超过191个字符。

2. 结果验证

请将以下报文拷贝、粘贴到客户端，用户即可将指定文件中的配置追加到当前配置中：

<rpc-reply message-id="100"

xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">

<ok/>

</rpc-reply>

1.10.3 运行配置回滚

设备支持对当前正在运行的配置进行回滚，配置回滚点后，设备可以在如下场景下进行配置回滚：

· NETCONF客户端主动下发配置回滚指令。

· NETCONF客户端在指定的时间内无任何指令，即NETCONF会话空闲时间超过配置的回滚空闲超时时间。

· NETCONF客户端和设备间的连接异常断开。

配置回滚步骤如下：

如果存在多个NETCONF会话同时配置设备，建议配置回滚前先用<lock>锁定系统，否则可能导致设备运行配置与回滚前配置不一致。

(1) 对当前系统加锁。

(2) 下发<save-point>/<begin>操作进行配置回滚点标记。

(3) 下发<edit-config>操作，对设备进行所需配置。

(4) 下发<save-point>/<commit>进行配置确认，可分多次修改配置并确认。

(5) 下发<save-point>/<rollback>进行配置回滚，可选择对应的一次commit进行配置回滚，或者等待NETCONF会话空闲时间超过配置的回滚空闲超时时间而自动进行配置回滚到最近使用的commit的配置。

(6) 下发<save-point>/<end>结束配置回滚功能。

(7) 对当前系统解锁。

2. 启动配置回滚功能，标识起始回滚点

(1) 客户端发送报文

请将以下报文拷贝、粘贴到客户端：

<save-point>

<begin>

<confirm-timeout>100</confirm-timeout>

</begin>

</save-point>

</rpc>

回滚空闲超时时间<confirm-timeout>为可选，取值范围为1～65535，单位为秒，缺省为600秒。

(2) 验证结果

当客户端收到如下报文时，表示配置回滚点成功：

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

<data>

<save-point>

<commit-id>1</commit-id>

</commit>

</save-point>

</data>

</rpc-reply>

3. 主动下发配置回滚

(1) 客户端发送报文

请将以下报文拷贝、粘贴到客户端：

<save-point>

<commit-id/>

<commit-index/>

<commit-label/>

</rollback>

</save-point>

</rpc>

<commit-id/>、<commit-index/>、<commit-label/>任选一个，或者不选时回滚此前最近使用的commit的配置。其中commit-id为系统唯一标识的commit编号。commit-index表示最近50次的commit，0表示最近一次下发commit，49表示最远一次commit。commit-label为标签，不同的commit标签不能相同，可以没有标签。

(2) 验证结果

当客户端收到如下报文时，表示主动下发配置回滚成功：

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

</rpc-reply>

4. 主动下发配置确认

下发<save-point>/<commit>操作接受当前配置。使能save-point后，系统支持最近50个commit回滚点的配置回滚。超过50个回滚点后，进行commit操作时需指定force属性强制覆盖最早的回滚点。

(1) 客户端发送报文

请将以下报文拷贝、粘贴到客户端：

<save-point>

<label>SUPPORT VLAN<label>

<comment>VLANs 1 to 100 and interfaces.</comment>

</commit>

</save-point>

</rpc>

<label/>和<comment/>可选。

(2) 验证结果

当客户端收到如下报文时，表示主动下发配置确认成功：

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

<data>

<save-point>

<commit-id>2</commit-id>

</commit>

</save-point>

</data>

</rpc-reply>

5. 取消配置回滚

下发<save-point>/<end>操作取消配置回滚。

<save-point>

<end/>

</save-point>

</rpc>

(1) 客户端发送报文

请将以下报文拷贝、粘贴到客户端：

<save-point>

<end/>

</save-point>

</rpc>

(2) 验证结果

当客户端收到如下报文时，返回对应的end结果成功。

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

<ok/>

</rpc-reply>

6. 获取系统的commit回滚点的记录。

下发<save-point>/<get-commits>操作获取commit的操作记录。

<save-point>

<get-commits>

<commit-id/>

<commit-index/>

<commit-label/>

</get-commits>

</save-point>

</rpc>

<commit-id>，<commit-index>，<commit-label>任选一个，也可以都不选，显示所有的commit记录。

(1) 客户端发送报文

请将以下报文拷贝、粘贴到客户端：

<save-point>

<get-commits>

<commit-label>SUPPORT VLAN</commit-label>

</get-commits>

</save-point>

</rpc>

(2) 验证结果

当客户端收到如下报文时，返回对应的commit操作记录：

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

<data>

<save-point>

<commit-information>

<Label>SUPPORT VLAN</Label>

</commit-information>

</save-point>

</data>

</rpc-reply>

7. 获取系统commit回滚点的配置

下发<save-point>/<get-commit-information>操作获取对应的commit操作时的配置。

<save-point>

<get-commit-information>

<commit-information>

<commit-id/>

<commit-index/>

<commit-label/>

</commit-information>

<compare-information>

<commit-id/>

<commit-index/>

<commit-label/>

</compare-information

</get-commit-information>

</save-point>

</rpc>

<commit-id/>，<commit-index/>，<commit-label/>任选一个。<compare-information/>可选。

<get-commit-information>不输入参数显示最近的使用的commit配置。

(1) 客户端发送报文

请将以下报文拷贝、粘贴到客户端：

<save-point>

<get-commit-information>

<commit-information>

<commit-label>SUPPORT VLAN</commit-label>

</commit-information>

</get-commit-information>

</save-point>

</rpc>

(2) 验证结果

当客户端收到如下报文时，显示对应的配置信息：

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

<data>

<save-point>

<commit-information>

…

interface vlan 1

…

</content>

</commit-information>

</save-point>

</data>

</rpc-reply>

1.10.4 加载文件

<load>操作执行后，指定文件中的配置会被合并到设备的当前配置中。设备会将指定文件中的配置中的配置和当前配置进行比较：对于指定文件中有，但当前配置中没有的配置，直接运行；对于指定文件中和当前配置中不一致的配置，则用指定文件中的配置替换当前配置中的对应配置。

1. 客户端发送报文

设备收到配置加载请求后会回应客户端，当客户端收到如下报文时，表示配置加载成功：

<load>

<file>指定文件的名称</file>

</load>

</rpc>

其中，“指定文件的名称”必须以存储介质的名称开头，后缀为.cfg，配置文件保存路径和文件名称的总长度不能超过191个字符。

2. 结果验证

将设备的当前配置保存到配置文件my_config.cfg。

<rpc-reply message-id="100"

xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">

<ok/>

</rpc-reply>

1.10.5 配置保存举例

1. 组网需求

2. 配置步骤

# 进入XML视图。

# 进行能力交换。

urn:ietf:params:netconf:base:1.0

</capability>

</capabilities>

</hello>

# 将设备的当前配置保存到配置文件my_config.cfg。

<save>

<file> my_config.cfg</file>

</save>

</rpc>

3. 结果验证

# 如果客户端收到类似如下的报文，则表示操作成功。

基于列的过滤包括严格匹配、正则表达式匹配过滤和条件匹配过滤。同时指定多种过滤条件时，只有一个生效，其优先级从高到底依次为：严格匹配过滤、正则表达式匹配过滤和条件匹配过滤。

<rpc-reply message-id="100"

xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">

<ok/>

</rpc-reply>

1.11 开启预配置

如果用户在成员设备退出、或子卡被拔出之后执行了保存配置并重启IRF操作，成员设备再次加入IRF、或子卡再次插入成员设备时，该成员设备/子卡上的配置无法恢复。对于这种情况，用户可以在成员设备退出、或子卡被拔出前，执行<config-provisioned>操作开启预配置功能。开启预配置后，如果成员设备退出、或子卡被拔出，用户仍然可以查看该成员设备退出、或子卡拔出前的配置，并对配置进行修改。保存配置并重启IRF后，该成员设备再次加入IRF、或子卡再次插入成员设备时，该成员设备/子卡原有的配置可以重新被下发到该成员设备/子卡上，无需用户再次配置。

执行<config-provisioned>操作开启预配置功能时，请注意：

· 仅成员设备/子卡接口视图、slot视图下的命令行、以及报文统计功能（通过qos traffic-counter配置）支持预配置。

· 仅运行状态为“Normal”成员设备/子卡支持预配置。

· 成员设备退出、或子卡被拔出后，仅支持使用命令行查看该成员设备退出IRF前、或子卡被拔出前的配置，并对配置进行修改。

1. 客户端发送报文

请将以下报文拷贝、粘贴到客户端，用户即可开启预配置：

<?xml version="1.0" encoding="UTF-8"?>

<config-provisioned>

</config-provisioned>

</rpc>

2. 结果验证

设备收到预配置请求后会回应客户端，当客户端收到如下报文时，表示开启预配置成功：

<?xml version="1.0" encoding="UTF-8"?>

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

<ok/>

</rpc-reply>

1.12 数据过滤功能

当用户执行<get>、<get-bulk>、<get-config>或者<get-bulk-config>操作时，在XML语言中增加过滤条件，可以使用户只看到自己关心的数据。数据过滤包括基于表的过滤和基于列的过滤：

· 基于表的过滤用于过滤表的信息。

· 基于列的过滤用于过滤单个列的信息。

基于表的过滤需要在基于列的过滤之前配置。

1.12.1 基于表的过滤

基于表的过滤中，过滤条件类似命令行，命令空间为http://www.h3c.com/netconf/base:1.0，属性名为filter。关于支持该过滤方式表的详细信息，具体请参见模块的XML API手册。

如下要求返回IPv4路由表中匹配IP地址为1.1.1.0和24位掩码最长的数据：

<get>

<Route>

</Ipv4Routes>

</Route>

</top>

</filter>

</get>

</rpc>

仅基于表的过滤支持该配置，查询条件必须写在行的属性上。

1.12.2 基于列的过滤

1. 严格匹配过滤

严格匹配包括两种匹配方式，一种是元素值方式，还有一种是属性名方式。

用户在XML语言中直接指定对应的元素值，设备将对这些值进行严格匹配。如果指定了多个元素的值，则返回同时符合这几个条件的数据。只有完全匹配条件才返回成功。

如下为一个NETCONF报文示例，用于获取所有状态为UP的接口的配置信息：

<get>

<Ifmgr>

</Interface>

</Interfaces>

</Ifmgr>

</top>

</filter>

</get>

</rpc>

当用户在行的位置上放置的某个属性的名称和当前表的某个列的名称一致，则这个属性的值将与用户下发配置中同名称的列的值进行严格匹配，例如，上面例子用属性名方式的等价XML请求为：

<get>

<Ifmgr>

</Interfaces>

</Ifmgr>

</top>

</filter>

</get>

</rpc>

以上两个NETCONF报文示例说明通过不同的严格匹配方式都可以获取所有状态为UP的接口的索引和指定列信息。

2. 正则表达式匹配过滤

当过滤条件比较复杂时，可以在指定元素上设置regExp属性为一个正则表达式，以完成过滤的目的。

如下为一个NETCONF报文示例，用于获取接口的描述信息，并要求这些描述信息全部为大写字母，不能有其它字符。

<get-config>

</source>

<Ifmgr>

</Interface>

</Interfaces>

</Ifmgr>

</top>

</filter>

</get-config>

</rpc>

3. 条件匹配过滤

由于正则表达仅能够完成字符匹配，对于数值逻辑的判断过滤实现起来比较麻烦，此时，可使用条件匹配过滤功能。

条件匹配通过在元素中增加match属性完成，属性的值（即过滤条件）可以为数字、字符串。

表1-7 条件匹配命令

操作	命令	说明
大于	match="more:value"	值大于value，支持的数据类型为：日期、数字、字符串
小于	match="less:value"	值小于value，支持的数据类型为：日期、数字、字符串
不小于	match="notLess:value"	值不小于value，支持的数据类型为：日期、数字、字符串
不大于	match="notMore:value"	值不大于value，支持的数据类型为：日期、数字、字符串
等于	match="equal:value"	值等于value，支持的数据类型为：日期、数字、字符串、OID、BOOL
不等于	match="notEqual:value"	值不等于value，支持的数据类型为：日期、数字、字符串、OID、BOOL
包含	match="include:string"	包含字符串string，支持的数据类型为：字符串
不包含	match="exclude:string"	不能包含字符串string，支持的数据类型为：字符串
开始于	match="startWith:string"	以字符串string开头，支持的数据类型为：字符串、OID
结束于	match="endWith:string"	以字符串string结束，支持的数据类型为：字符串

如下为一个NETCONF报文示例，用于获取实体扩展信息中CPU利用率大于50%的实体。

<get>

</Entity>

</ExtPhysicalEntities>

</Device>

</top>

</filter>

</get>

</rpc>

1.12.3 正则表达式操作举例

1. 组网需求

取Ifmgr模块下Interfaces表下Description列包含FortyGigE的所有数据。

2. 配置步骤

# 进入XML视图。

# 进行能力交换。

urn:ietf:params:netconf:base:1.0

</capability>

</capabilities>

</hello>

# 取Ifmgr模块Interfaces表下Description列包含FortyGigE的所有数据。

<rpc message-id="100"

xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:h3c="http://www.h3c.com/netconf/base:1.0">

<get>

<Ifmgr>

</Interface>

</Interfaces>

</Ifmgr>

</top>

</filter>

</get>

</rpc>

3. 结果验证

# 如果客户端收到类似如下的报文，则表示操作成功。

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:h3c="http://www.h3c.com/netconf/base:1.0" message-id="100">

<data>

<Ifmgr>

<Description>FortyGigE1/0/1 Interface</Description>

</Interface>

<Description>FortyGigE1/0/2 Interface</Description>

</Interface>

<Description>FortyGigE1/0/3 Interface</Description>

</Interface>

<Description>FortyGigE1/0/4 Interface</Description>

</Interface>

</Interfaces>

</Ifmgr>

</top>

</data>

</rpc-reply>

# 进行能力交换。

urn:ietf:params:netconf:base:1.0

</capability>

</capabilities>

</hello>

#取Ifmgr模块Interfaces表下ifindex值大于等于5000的Name列信息。

xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:h3c="http://www.h3c.com/netconf/base:1.0">

<get>

<Ifmgr>

<Name/>

</Interface>

</Interfaces>

</Ifmgr>

</top>

</filter>

</get>

</rpc>

3. 结果验证

# 如果客户端收到类似如下的报文，则表示操作成功。

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:h3c="http://www.h3c.com/netconf/base:1.0" message-id="100">

<data>

<Ifmgr>

</Interface>

<Name>Register-Tunnel0</Name>

</Interface>

</Interfaces>

</Ifmgr>

</top>

</data>

</rpc-reply>

<CLI>

命令行

</Execution>

</CLI>

</rpc>

一对<Execution>子标签中可以包含多个命令行，一条命令输入完毕，换行，再输入下一条命令即可。

2. 结果验证

设备收到命令行指令后会回应客户端，当客户端收到如下报文时，表示命令行执行成功（注意命令响应被CDATA节点包含）：

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

<CLI>

<![CDATA[对应命令行响应]]>

</Execution>

</CLI>

</rpc-reply>

# 进行能力交换。

urn:ietf:params:netconf:base:1.0

</capability>

</capabilities>

</hello>

# 向设备发送显示当前配置命令。

<CLI>

display current-configuration

</Execution>

</CLI>

</rpc>

3. 结果验证

# 如果客户端收到类似如下的报文，则表示操作成功。

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

<CLI>

<Execution><![CDATA[

<Sysname>display current-configuration

version 7.1.045, ESS 2305

sysname Sysname

telnet server enable

irf mac-address persistent timer

irf auto-update enable

undo irf link-delay

irf member 1 priority 1

]]>

</Execution>

</CLI>

</rpc-reply>

1.14 获取会话信息

使用该功能用户可以获取当前设备的所有NETCONF会话信息。

1.14.1 获取会话信息

1. 客户端发送报文

设备收到命令行指令后会回应客户端，当客户端收到如下报文时，表示命令行执行成功：

<get-sessions/>

</rpc>

2. 结果验证

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

<get-sessions>

<UserName>用户登陆名称</UserName>

<Since>用户登录时间</Since>

<LockHeld>用户是否持有锁</LockHeld>

</Session>

</get-sessions>

</rpc-reply>

# 进行能力交换。

urn:ietf:params:netconf:base:1.0

</capability>

</capabilities>

</hello>

# 获取设备上当前存在的NETCONF会话的信息。

<get-sessions/>

</rpc>

3. 结果验证

# 如果客户端收到类似如下的报文，则表示操作成功。

请将以下报文拷贝、粘贴到客户端，用户即能关闭指定的会话：

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

<get-sessions>

<LockHeld>false</LockHeld>

</Session>

</get-sessions>

</rpc-reply>

以上信息表明：目前有一个NETCONF连接，SessionID是1，登录用户类型vty0,登录时间是2013-01-05T00:24:57，此用户不持有锁。

1.15 关闭另一个会话

NETCONF支持一个用户关闭除自己外的另一个NETCONF会话，被关闭会话的用户退回到用户视图。

1.15.1 Kill-session操作

1. 客户端发送报文

<kill-session>

<session-id>

指定session-ID

</session-id>

</kill-session>

</rpc>

2. 结果验证

设备收到会话关闭请求后会回应客户端，当客户端收到如下报文时，表示指定会话已经被关闭：

<rpc-reply message-id="100"

xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">

<ok/>

</rpc-reply>

1.15.2 Kill-session举例

1. 配置需求

当前有两个NETCONF登录用户，session ID分别是1和2，session ID为1的用户要关闭另一个用户的会话。

2. 配置步骤

# 进入XML视图。

# 进行能力交换。

urn:ietf:params:netconf:base:1.0

</capability>

</capabilities>

</hello>

# 关闭session ID为2的用户会话。

<kill-session>

<session-id>2</session-id>

</kill-session>

</rpc>

3. 结果验证

如果客户端收到如下报文，则表明session ID为2的NETCONF会话已经被关闭。建立该会话的用户会从XML视图退回到用户视图。

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

<ok/>

</rpc-reply>

1.16 退出XML视图

1. 客户端发送报文

对于处于XML视图的用户，要退回到用户视图，使用命令行来配置设备时，需要将以下报文拷贝、粘贴到客户端：

设备收到以上请求后会返回如下报文并退回到用户视图：

<close-session/>

</rpc>

2. 结果验证