<get-configuration>
使用
<rpc> <get-configuration [changed="changed"] [commit-scripts="( apply | apply-no-transients | view )"] [compare=("configuration-revision" [configuration-revision="revision-id"] | "rollback" [rollback="[0-49]"])] [database="(candidate | committed)"] [database-path=$junos-context/commit-context/database-path] [format="( json | set | text | xml )"] [inherit="( defaults | inherit )" [groups="groups"] [interface-ranges="interface-ranges"]] [(junos:key | key )="key"] > <!-- tag elements for the configuration element to display --> </get-configuration> </rpc>
描述
请求 NETCONF 或 Junos XML 协议服务器的配置数据。属性指定要显示的数据的来源和格式。
如果客户端应用程序发出 Junos XML 协议 <open-configuration>
操作,以便在执行 <get-configuration>
操作前打开特定配置数据库,服务器将从开放配置数据库返回配置数据。否则,服务器将从候选配置返回配置数据,除非通过包含 database="committed"
属性明确请求活动配置。
客户端应用程序可以请求整个配置层次结构或其中的一个子集。
要显示整个配置层次结构,请发出空
<get-configuration/>
标记。要显示配置元素(层次结构级别或配置对象),请在标记元素中
<get-configuration>
发出标记元素,以表示配置层级的所有级别,从 root(由<configuration>
标记元素表示)下降到要显示的级别或对象。要表示层次结构级别或没有标识符的配置对象,请将其作为空标记发出。要表示具有一个或多个标识符的对象,请仅发送其容器标记元素和标识符标记元素,而不是表示其他特性的任何标记元素。
要从临时配置数据库的实例中检索配置数据,客户端应用程序必须先使用 <open-configuration>
带有相应子标记的操作打开临时实例,然后再发出 <get-configuration>
操作。使用 <get-configuration>
操作检索临时配置数据时,唯一支持的属性是 format
和 key
。
从 Junos OS 版本 13.1 开始,在 NETCONF 或 Junos XML 协议会话中,逻辑系统用户可使用 Junos XML <get-configuration>
操作使用儿童配置标记请求特定逻辑系统配置层次结构,并请求整个逻辑系统配置。请求整个逻辑系统配置时,RPC 回复包含 <configuration>
root 标记。在 Junos OS 版本 13.1 之前, <configuration>
将省略根标记。
属性
changed |
该属性出现在到已更改配置元素的路径中每个父层标记元素的打开标记中,包括顶层开放 该
提交时间警告的示例是该消息,该消息解释说,在重新启动设备之前,配置元素实际上不会适用。此警告将显示在标记字符串中,即服务器返回以确认提交成功,该提交包含在标记元素中 要从提交前更改的元素中移除 |
commit-scripts |
请求 NETCONF 或 Junos XML 协议服务器显示提交脚本式 XML 数据。属性的值决定输出。可接受的值包括:
|
compare |
请求 NETCONF 或 Junos XML 协议服务器显示活动或候选配置与先前提交的配置(比较配置)之间的差异。 该 属性
如果包含 将候选配置与活动配置进行比较时,操作
注意:
从 Junos OS 16.2R2 版开始,当您比较候选配置和活动配置并显示 XML 或 JSON 格式的差异时,设备将省略 XML 输出 |
database |
指定要从该配置中显示数据的配置为以下某个配置:
如果两者都包括在内,则 |
database-path |
在提交脚本中,此属性指定了该会话的继承前候选配置的路径。唯一可接受的价值是 对于正常的配置会话,提交脚本将检索正常的继承前候选配置。对于专用配置会话,提交脚本将检索专用的继承前候选配置。 如果同时 |
format |
指定 NETCONF 或 Junos XML 协议服务器返回配置数据的格式。可接受的值包括:
注意:
从 Junos OS 版本 21.1R1 和 Junos OS Evolved 版本 22.3R1 开始,NETCONF 会话还支持 |
groups |
属性的唯一 |
inherit |
指定 NETCONF 或 Junos XML 协议服务器如何显示在配置组和接口范围中定义的语句。 可接受的值包括:
|
interface-ranges |
属性的唯一 |
junos:key | key |
|
发布信息
这是一个 Junos XML 管理协议操作。它在 Junos XML 协议会话中受支持,并且作为在运行 Junos OS 的设备上的 NETCONF 会话中的瞻博网络专有扩展,用于识别功能交换中的 URI http://xml.juniper.net/netconf/junos/1.0。
interface-ranges
属性在 Junos OS 版本 10.3R1 中添加。
commit-scripts
属性值 apply
并在 apply-no-transients
Junos OS 版本 12.1 中添加
database-path
属性在 Junos OS 版本 12.2 中添加。
format
Junos OS 版本 14.2 中添加的属性值 json
。
format
Junos OS 版本 15.1 中添加的属性值 set
。
从 Junos OS 16.1 版开始,运行 Junos OS 的设备会使用新的默认实施进行串行化,发出 JSON 格式的配置数据。
从 Junos OS 16.1R4、16.2R2 和 17.1R1 版本开始,JSON 格式发布的 Junos OS 配置数据中的整数不会以引号括起来。
compare
Junos OS 版本 20.4R1 和 Junos OS Evolved 版本 20.4R1 中的属性增值 configuration-revision
。
format
属性值 json-minified
, xml-minified
仅在 Junos OS 版本 21.1R1 和 Junos OS Evolved 版本 22.3R1 中添加至 NETCONF 会话。