Defina el formato de los datos de configuración que se cargarán en una sesión de protocolo XML de Junos
Las aplicaciones cliente del protocolo XML de Junos pueden utilizar la <load-configuration> operación con los valores de atributo adecuados para cargar los datos de configuración en el formato solicitado desde un archivo o un flujo de datos.
Una aplicación cliente de protocolo XML de Junos puede cargar datos de configuración en un dispositivo que ejecute Junos OS o que ejecute Junos OS Evolved. La aplicación puede cargar los datos desde un archivo o como un flujo de datos. Los datos de configuración pueden usar cualquiera de los siguientes formatos:
-
Elementos XML de Junos (predeterminados)
-
Texto ASCII formateado
-
Comandos del modo de configuración
-
Notación de objetos JavaScript (JSON)
Para especificar el formato de los datos, una aplicación cliente incluye el format atributo en la etiqueta de apertura <load-configuration> . La <load-configuration> operación puede combinar el format atributo con los siguientes atributos:
-
url -
actionNota:El formato JSON solo admite
actionvalores de fusión, anulación y actualización.
En las siguientes secciones se describe cómo cargar los datos de configuración desde un archivo o como una transmisión de datos con el formato solicitado en una sesión de protocolo XML de Junos.
Elementos XML de Junos
Cuando se proporcionan datos XML de Junos, la aplicación incluye los elementos que representan todos los niveles de la jerarquía de configuración, desde la raíz (el <configuration> elemento) hasta cada elemento nuevo o modificado.
<configuration>
<!-- elements representing the configuration data -->
</configuration>
En la solicitud, la aplicación puede incluir el format="xml" atributo u omitir el format atributo en la <load-configuration> etiqueta, ya que este es el valor predeterminado. Para cargar los datos de configuración desde un archivo, la aplicación también incluye el url atributo. Para cargar los datos de configuración como un flujo de datos, la aplicación envía los datos de la solicitud.
<rpc>
<load-configuration url="file-location"/>
</rpc>
<rpc>
<load-configuration>
<configuration>
<!-- elements representing the configuration data -->
</configuration>
</load-configuration>
</rpc>
Texto ASCII formateado
Si la aplicación proporciona los datos de configuración como texto ASCII formateado, utiliza la notación estándar de la CLI de Junos OS para indicar las relaciones jerárquicas entre las instrucciones de configuración. Esta notación utiliza el carácter de nueva línea, tabulaciones y otros espacios en blanco, llaves y corchetes. Para cada elemento nuevo o modificado, se especifica la ruta de acceso de instrucción completa, comenzando con la instrucción de nivel superior que aparece directamente debajo del nivel de [edit] jerarquía.
Cuando se proporcionan datos de configuración como texto ASCII, la aplicación debe incluir el format="text" atributo en la <load-configuration> etiqueta. Para cargar los datos de configuración desde un archivo, la aplicación también incluye el url atributo. Para cargar los datos de configuración como un flujo de datos, la aplicación encierra los datos en un <configuration-text> elemento.
<rpc>
<load-configuration url="file-location" format="text"/>
</rpc>
<rpc>
<load-configuration format="text">
<configuration-text>
/* formatted ASCII configuration data */
</configuration-text>
</load-configuration>
</rpc>
Comandos del modo de configuración
Una aplicación cliente puede cargar datos de configuración como comandos de modo de configuración. El dispositivo ejecuta las instrucciones de configuración línea por línea. Para cada elemento, puede especificar la ruta de instrucción completa en el comando o puede usar comandos de navegación, como edit y up, para desplazarse por la jerarquía de configuración como lo haría en el modo de configuración de CLI.
Al proporcionar comandos de modo de configuración, la aplicación debe incluir los action="set" atributos y format="text" en la <load-configuration> etiqueta. Para cargar los datos de configuración desde un archivo, la aplicación también incluye el url atributo. Para cargar los datos de configuración como una secuencia de datos, la aplicación encierra los comandos en un <configuration-set> elemento.
<rpc>
<load-configuration url="file-location" action="set" format="text"/>
</rpc>
<rpc>
<load-configuration action="set" format="text">
<configuration-set>
/* configuration mode commands to load */
</configuration-set>
</load-configuration>
</rpc>
JSON
Una aplicación cliente puede cargar datos de configuración JSON en un dispositivo. La aplicación incluye los datos de configuración que representan todos los niveles de la jerarquía de configuración, desde el objeto de configuración raíz hasta cada elemento nuevo o modificado.
Al proporcionar datos de configuración JSON, la aplicación debe incluir el format="json" atributo en la <load-configuration> etiqueta. Para cargar los datos de configuración desde un archivo, la aplicación también incluye el url atributo. Para cargar los datos de configuración como un flujo de datos, la aplicación encierra los datos en un <configuration-json> elemento.
<rpc>
<load-configuration url="file-location" format="json"/>
</rpc>
<rpc>
<load-configuration format="json">
<configuration-json>
/* JSON-formatted configuration data */
</configuration-json>
</load-configuration>
</rpc>