Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
在此页面上
 

<load-configuration>

使用

描述

请求 NETCONF 或 Junos XML 协议服务器将配置数据加载到候选配置或开放配置数据库中。

如果客户端应用程序发出 Junos XML 协议 <open-configuration> 操作,以便在执行 <load-configuration> 操作前打开特定配置数据库,服务器将配置数据加载到开放配置数据库中。否则,服务器会将配置数据加载到候选配置中。

以以下方式之一提供数据加载:

  • 将空 <load-configuration/> 标记的 configuration-revision 属性设置为先前提交的配置的配置修订标识符。指定的配置完全替换候选配置。

  • 将空 <load-configuration/> 标签的 rescue 属性设置为该值 rescue。救援配置完全替换候选配置。

  • 将空 <load-configuration/> 标记的 rollback 属性设置为先前提交的配置的回滚索引。该设备存储最近提交的配置和多达 49 个先前配置的副本。指定的配置完全替换候选配置。

  • 将空 <load-configuration/> 标记的 url 属性设置为包含要加载的配置数据的文件的路径名。 format 将属性设置为 jsontextxml 以相应的格式 - JavaScript 对象符号 (JSON)、格式化的 ASCII 文本或 Junos XML 标记元素(默认)加载配置。要将配置数据作为配置模式命令提供,请包括 action="set" 属性,并省略 format 属性或将值设置为 text

    在以下示例中 url ,属性标识配置数据应从 /tmp/add.conf 文件加载。

  • 在开口 <load-configuration> 和关闭 </load-configuration> 标记中将配置数据作为数据流括起来。如果以格式化的 ASCII 文本形式提供配置数据,请将数据括入标记元素中 <configuration-text> ,然后将属性设置 formattext。如果将配置数据作为 Junos XML 标记元素提供,请将数据括入标记元素中 <configuration> ,并省略 format 属性或将值设置为 xml。如果将配置数据作为配置模式命令提供,请将数据括入标记元素中 <configuration-set> ,将属性设置 actionset,并省略 format 属性或将值设置为 text。如果在 JSON 中提供配置数据,请将数据括在标记元素中 <configuration-json> ,然后将属性设置 formatjson

属性

action

指定如何加载配置数据,特别是当目标配置数据库和加载的配置包含相互矛盾的语句时。

临时配置数据库在指定版本中支持受支持的设备上的以下 action 属性值:

  • mergeset— Junos OS 16.2R2 和更高版本中支持

  • overridereplace— Junos OS 18.1R1 和更高版本中支持

  • update— Junos OS 21.1R1 和更高版本中支持

以下是可接受的值:

  • merge—将加载配置中的数据与目标配置中的数据相结合。如果加载配置中的语句与目标配置中的语句相冲突,则加载语句将替换目标配置中的语句。如果省略属性, action 则这是默认行为。

  • override— 丢弃整个候选配置,代之以加载配置。在提交配置之后,所有系统进程都将解析新配置。

  • replace—用加载配置中定义的每个层次结构级别或配置对象替换候选配置中的相应级别或对象。

    如果以格式化 ASCII 文本形式提供配置数据(在由 url 属性命名的文件中,或在标记元素中 <configuration-text> 括起来),则在表示层次结构级别或要更换的语句前面的语句前方的行中也放置 replace: 了语句。有关更多信息,请参阅 CLI 用户指南中有关加载配置数据文件的讨论。

    如果将配置数据作为 Junos XML 标记元素提供,请将属性包含 replace="replace" 在表示层次结构级别或要更换的对象的元素的开口标记中。

  • set—负载配置数据格式化为 Junos OS 配置模式命令。此选项将按行执行配置说明,因为它们存储在按 url 属性命名的文件中或在标记元素中 <configuration-set> 括起来。说明中可包含任何配置模式命令,如 setdeleteeditdeactivate。将配置数据作为一组命令提供时,属性的唯一可接受值 format 是“文本”。 action 如果属性值为“set”,并且 format 属性被省略, format 则属性会自动默认为“文本”,而不是 xml

  • update—将满载配置与候选配置进行比较。对于两个配置中不同的每个层次结构级别或配置对象,加载配置中的版本将替换候选配置中的版本。在提交配置之后,只有受更改配置元素影响的系统进程解析新配置。

configuration-revision

通过引用其配置修订版标识符,加载先前提交的配置。指定的配置完全替换候选配置。

format

指定用于配置数据的格式。可接受的值包括:

  • json–表示配置数据使用 JavaScript 对象符号 (JSON) 格式化。

  • text— 指示配置数据格式化为 ASCII 文本或配置模式命令集。

    ASCII 文本格式使用新线字符、选项卡和其他空白、大括号和方括号来指示语句之间的层次结构关系。这是存储在路由平台上的配置文件中使用的格式,是 CLI show configuration 命令显示的格式。命令 set 格式由一系列 Junos OS 配置模式命令组成,由 show configuration | display set CLI 命令显示。要加载一组配置模式命令,必须将属性设置 action 为“set”。

  • xml—指示配置数据是使用 Junos XML 标记元素格式化的。 format 如果遗漏属性,“xml”是属性所有值(“set”除外)的 action 默认格式,默认会对“文本”进行格式化。

rescue

指定救援配置替换当前候选配置。唯一有效的价值是“拯救”。

注意:

从 Junos OS 18.1R1 版开始,您还可以使用 <rollback-config> RPC 加载先前提交的配置,对于不支持执行包含 XML 属性的 RPC 的应用程序,此配置很有用。

rollback

引用其数字回滚索引,加载先前提交的配置。有效值为 0(对于最近提交的配置为零),比之前存储的配置数量少一个(最大为 49)。

注意:

从 Junos OS 18.1R1 版开始,您还可以使用 <rollback-config> RPC 加载先前提交的配置,对于不支持执行包含 XML 属性的 RPC 的应用程序,此配置很有用。

url

指定文件的完整路径名,其中包含要加载的配置数据。该值可以是本地文件路径、FTP 位置或超文本传输协议 (HTTP) URL:

  • 本地文件名可包含以下表单之一:

    • /path/filename—在已安装的文件系统上(本地闪存盘上或硬盘上)上文件。

    • a:filenamepath/filename—在本地驱动器上进行文件。默认路径为 / (root 级目录)。可移动介质可以采用 MS-DOS 或 UNIX (UFS) 格式。

  • FTP 服务器上的文件名具有以下表单:

  • HTTP 服务器上的文件名具有以下表格:

在每个情况下,变量的 path 默认值都是用户名的家庭目录。要指定绝对路径,应用程序将以字符 %2F 开启路径:例如 ftp://usernamepassword@hostname/%2Fpath/filename

发布信息

这是一个 Junos XML 管理协议操作。它在 Junos XML 协议会话中受支持,并且作为在运行 Junos OS 的设备上的 NETCONF 会话中的瞻博网络专有扩展,用于识别功能交换中的 URI http://xml.juniper.net/netconf/junos/1.0。

action Junos OS 版本 11.4 中添加的属性值 set

format Junos OS 版本 16.1 中添加的属性值 json

configuration-revision 属性在 Junos OS 20.4R1 版和 Junos OS Evolved 版本 20.4R1 中添加。