定义在 Junos XML 协议会话中上传的配置数据的格式

在与运行 Junos OS 的设备进行 Junos XML 协议会话中，客户端应用程序可将配置数据以文件方式或作为 Junos XML 协议会话期间发出的数据流上传到设备。在这两种情况下，客户端应用程序都可以使用 Junos XML 标记元素、格式化的 ASCII 文本、Junos OS 配置模式命令或 JavaScript 对象符号 （JSON） 来定义新的配置数据。

如果应用程序使用 Junos XML 标记元素，则其中包含表示从根（ <configuration> 标记元素）到每个新元素或已更改元素的配置层次结构所有级别的标记元素。符号与请求配置信息所用的表示法相同， 在使用 Junos XML 协议请求配置更改中会详细介绍。

如果应用程序以格式化的 ASCII 文本的形式提供配置数据，它将使用标准 Junos OS CLI 符号来指示配置语句（新行字符、制表符和其他空格、大括号和方括号）之间的层次关系。对于每个新元素或已更改的元素，都会从直接显示在层次结构级别下的 [edit] 顶级语句开始指定完整语句路径。

当 ASCII 文本作为数据流提供时，它被括在 <configuration-text> 标记元素中。

在文件中提供 ASCII 文本时， <configuration-text> 标记元素不会包含在文件中。

当配置数据以 ASCII 文本提供时，应用程序还必须在 format="text" 标记中包含属性 <load-configuration> 。

从 Junos OS 11.4 版开始，您可以将配置数据作为配置模式 set 命令加载。当您将配置数据作为配置模式 set 命令提供时，Junos OS 将逐行执行配置指令。您可以针对每个元素在命令中指定完整的语句路径，也可以像在 CLI 配置模式下那样，使用导航命令（例如 edit 和 up）在配置层次结构中移动。

当配置模式 set 命令作为数据流提供时，命令将括在标记元素中 <configuration-set> 。

在文件中提供配置模式 set 命令时， <configuration-set> 标记元素不会包含在文件中。

当以 Junos OS 配置模式命令形式提供配置数据时，应用程序还必须在action="set"标记中包含<load-configuration>和 format="text" 属性。

从 Junos OS 16.1 版开始，您可以在设备上使用 JavaScript Object Notation （JSON） 加载格式化的配置数据。如果应用程序以 JSON 格式提供配置数据，则其中包含表示从根到每个新元素或已更改元素的所有配置层次结构级别的配置数据。

当以 JSON 格式的配置数据作为数据流提供时，数据会封装在标记元素中 <configuration-json> 。

当文件中提供 JSON 格式的配置数据时 <configuration-json> ，标记元素不会包含在文件中。

以 JSON 格式提供配置数据时，应用程序还必须在 format="json" 标记中包含 <load-configuration> 属性。

该 format 属性可以与以下一个或多个属性组合：

• url

• action

  注意：

  仅合并 action 、覆盖和更新值支持 JSON 格式。

有关 、 <configuration>、 <configuration-text><configuration-set>和<configuration-json>标记元素的参考页面，请参阅 Junos XML API 操作开发人员参考。