网络运维自动化入门三：netconf配置说明

一 、
操作用来把配置数据下发到指定的目标配置数据集（或
），设备对中的操作进行鉴权，鉴权通过后，执行相应的修
改。
参数说明

• target：待编辑配置数据集名。基于场景选择对应的数据集名：
  – 立即生效模式，数据集设置为
  – 两阶段生效模式，数据集设置为（此场景需要）
  – 试运行，数据集设置为（此场景需要）
• default-operation：为此请求选择默认操作（如“operation”属性中所
  述）。 参数的默认值为“merge”。
  参数是可选的，但如果提供，它具有以下值之一：
  – merge：参数中的配置数据与目标数据存储中相应级别的配置合并。
  这是默认行为。
  – none：当配置方式未指定，默认操作指定为none的时候，edit-config操作会默
  认为none操作。none操作主要用来检查，下发为none操作的配置仅仅做
  Schema校验，不进行真正的配置下发。语法检查通过，就返回ok成功，否则
  失败。
• error-option：包含如下取值：
  – stop-on-error：操作出现错误即停止执行，这也是默认选项。
  – continue-on-error：出错后继续执行后续配置操作，记录错误信息并生成错误
  响应报文。
  – rollback-on-error：如果发生错误导致生成响应报文，则服务器需要
  停止处理操作，并将此操作已完成配置进行回退。
• config：由设备的数据模型之一定义的配置数据的层次结构。 内容必须放在适当
  的命名空间中，以允许设备检测对于的数据模型，并且内容必须遵循由其能力集
  定义的数据模型的约束。
  属性说明
  子树元素中可能包含一个“operation”属性，该属性NETCONF名字空间中定
  义。该属性标识配置操作如何执行，并且可能出现在整个子树的多个元素上。
  如果未指定“operation”属性，则配置将被合并到配置数据库中。
  “operation”属性包含下面几个值：
• merge：由包含此属性标识的配置数据与由参数标识的配置数据库中相应
  级别配置合并。这是默认属性。
• create：当且仅当配置数据存储中尚不存在配置数据时，由包含此属性标识的配置
  数据才会添加到配置中。 如果配置数据存在，则会返回一个元素，其
  中包含一个值“data-exists”。
• delete：当且仅当配置数据当前存在于配置数据存储中时，才会从配置中删除由包
  含此属性的元素标识的配置数据。 如果配置数据不存在，则返回一个
  元素，其中包含一个值“data-missing”。

二、
操作用来从和配置数据集中查询全部或指定的一部分配置数据。
参数说明：

• source：正在查询的配置数据集的名称。
• filter：此参数用来标识要查询设备配置数据集的部分。 如果此参数不存在，则返
  回整个配置。元素可以包含“type”属性。NETCONF中的默认过滤机制被称为子树过滤（“type”属性值为“subtree”）。

操作成功的回应：
设备支持满足请求操作的能力集，NETCONF server返回一个使用元素封装的消息，元素中创建一个data元素，查询数据全部封装在data元素中。
当查询返回数据量大于30K，如果设备不支持get-next能力，NETCONF server直接反馈错误；否则NETCONF server需要做消息分包处理，用户可以继续使用操作，请求返回多个消息。
操作失败的回应：
如果操作请求由于任何原因不能执行完成，NETCONF server返回一个元素封装的消息，创建一个元素封装在元素中。
三、
操作用来从数据集中查询部分或全部运行的配置数据和设备的状态数据。

操作成功，Server回复的元素中含有元素，元素中封装了获取的结果数据。否则在元素中含有元素。

参数说明：

• filter：此参数用来标识要查询设备配置数据集的部分。 如果此参数不存在，则返回整个配置。
  元素可以包含“type”属性。NETCONF中的默认过滤机制被称为子树过滤（“type”属性值为“subtree”）。

和区别在于：

• 只能从配置数据集中获取数据。所以，不需要参数指定配置数据集。支持通过参数指定或。
• 只能查询配置数据，而既能查询配置数据，又能查询状态数据。

四、
操作主要用来请求设备执行某个动作，并在中返回执行结果。维护操作一般不会直接修改设备上的配置数据，也不会返回业务数据。例如清除一个报文计数器，或复位一块单板。

设备必须宣布支持Action能力，才能使用操作。