Recuperar una configuración anterior (reversión) mediante el protocolo XML de Junos

En una sesión de protocolo XML de Junos con un dispositivo que ejecuta Junos OS, para solicitar una configuración confirmada previamente (rollback), una aplicación cliente ejecuta la <get-rollback-information> RPC con el <rollback> elemento. Esta operación es equivalente al comando del show system rollback modo operativo. El <rollback> elemento especifica el índice de reversión de la configuración anterior que se va a mostrar; su valor puede ser de 0 (cero, para la configuración confirmada más recientemente) a uno menos que el número de configuraciones anteriores almacenadas (el máximo es 49).

Para solicitar la salida etiquetada XML de Junos, que es la opción predeterminada, la aplicación incluye el <format> elemento con el valor xml u omite el <format> elemento.

El servidor de protocolo XML de Junos incluye su respuesta en <rpc-reply>elementos , <rollback-information>y <configuration> tag. La <load-success/> etiqueta es un efecto secundario de la implementación y no afecta a los resultados. Para obtener información acerca de los atributos de la etiqueta de apertura <configuration> , consulte Especificación del origen de las solicitudes de información de configuración en una sesión de protocolo XML de Junos.

Para solicitar una salida ASCII formateada, la aplicación incluye el <format> elemento con el valor text.

El servidor de protocolo XML de Junos incluye su respuesta en <rpc-reply>, <rollback-information>, <configuration-information>y <configuration-output> elementos de etiqueta. Para obtener más información acerca de la notación ASCII con formato utilizada en las instrucciones de configuración de Junos OS, consulte Especificación del formato de salida para datos de configuración en una sesión de protocolo XML de Junos.

A partir de Junos OS versión 16.1, para solicitar una configuración previamente confirmada (rollback) en formato JSON, la aplicación incluye el <format> elemento con el valor json en el <get-rollback-information> elemento. Antes de Junos OS versión 16.1, los datos con formato JSON se solicitaban incluyendo el format="json" atributo en la etiqueta de apertura <get-rollback-information> .

Cuando se utiliza el format="json" atributo para especificar el formato, el servidor de protocolo XML de Junos encierra su respuesta en un <rpc-reply> elemento, el nombre de campo del miembro "rollback-information"JSON de nivel superior es , y los datos de configuración emitidos utilizan una implementación anterior para la serialización. Cuando se utiliza el <format>json</format> elemento para solicitar datos con formato JSON, el servidor de protocolo XML de Junos encierra su respuesta en <rpc-reply>elementos , <rollback-information>, <configuration-information>y <json-output> de etiqueta, el nombre de campo del miembro JSON de nivel superior es "configuration", y los datos de configuración emitidos utilizan una implementación más reciente para la serialización.

En el ejemplo siguiente se muestra cómo solicitar resultados con etiquetas XML de Junos para la configuración de reversión que tiene un índice de 2. En la salida real, la JUNOS-version variable se sustituye por un valor como 20.4R1 para la versión inicial de Junos OS versión 20.4.

Cuando confirma correctamente una configuración, Junos OS asigna a esa configuración un identificador único de revisión de configuración. Mientras que el índice de reversión de una configuración confirmada anteriormente se incrementa con cada confirmación, el identificador de revisión de la configuración permanece estático para la misma configuración.

A partir de Junos OS versión 20.4R1, una aplicación cliente de protocolo XML de Junos puede utilizar el <get-configuration-by-revision> RPC para recuperar la configuración correspondiente a un identificador de revisión de configuración determinado. Por ejemplo:

El servidor devuelve la configuración solicitada incluida en el <configuration-revision-information> elemento.

De forma predeterminada, la <get-configuration-by-revision> RPC devuelve la configuración en formato XML. Para devolver la configuración como texto o JSON, incluya el <format> elemento en el RPC y especifique text o json.

Puede determinar la asignación entre un identificador de revisión de configuración y el índice de reversión actual para una configuración determinada. Recuerde que el identificador de revisión de configuración para una configuración confirmada determinada es estático, mientras que el índice de reversión aumenta con cada confirmación.

Para determinar el número de reversión correspondiente a un identificador de revisión de configuración específico, ejecute el <get-configuration-by-revision> RPC, especifique el identificador de revisión e incluya la etiqueta vacía <rollback-number/> .

El dispositivo devuelve el índice de reversión asociado actualmente con ese identificador de revisión de configuración.

Del mismo modo, para determinar el identificador de revisión de configuración asociado actualmente a un número de reversión específico, ejecute el <get-rollback-information> RPC, especifique el índice de reversión e incluya la etiqueta vacía <configuration-revision/> .

El dispositivo devuelve el identificador de revisión de configuración asociado actualmente con ese índice de reversión.

Una aplicación cliente también puede recuperar la asignación de identificadores de revisión de configuración a índices de reversión viendo el historial de confirmaciones del dispositivo. Para ver el historial de confirmaciones e incluir los identificadores de revisión de configuración, una aplicación cliente ejecuta la <get-commit-information> RPC con el <include-configuration-revision/> elemento secundario. El servidor devuelve una salida XML equivalente a la salida del comando del show system commit include-configuration-revision modo operativo.