Iniciar una sesión de protocolo XML de Junos

La aplicación cliente comienza emitiendo un <?xml?> PI.

Nota:

En el ejemplo siguiente (y en todos los ejemplos de este documento de elementos de etiqueta emitidos por una aplicación cliente), la fuente negrita se usa para resaltar la parte de la secuencia de etiquetas que se describe en el texto.

Los atributos son los siguientes. Para obtener una lista de los valores de atributo aceptables en la versión actual del protocolo de administración XML de Junos, consulte Comprobación de compatibilidad de software.

• version: la versión de XML con la que cumplen los elementos de etiqueta emitidos por la aplicación cliente

• codificación: el juego de caracteres estandarizado que la aplicación cliente utiliza y puede entender

En el siguiente ejemplo de PI de <?xml?> una aplicación cliente, el version="1.0" atributo indica que la aplicación está emitiendo elementos de etiqueta que cumplen con la especificación XML 1.0. El encoding="us-ascii" atributo indica que la aplicación cliente usa el juego de caracteres ASCII de 7 bits estandarizado por el American National Standards Institute (ANSI). Para obtener más información acerca de los estándares ANSI, consulte http://www.ansi.org/ .

Nota:

Si la aplicación no puede emitir el <?xml?> PI antes de emitir la etiqueta de apertura <junoscript> , el servidor de protocolo XML de Junos emite un mensaje de error y cierra inmediatamente la sesión y la conexión.

A continuación, la aplicación cliente emite su etiqueta de apertura <junoscript> , que tiene la siguiente sintaxis:

Los atributos son los siguientes. Para obtener una lista de los valores de atributo aceptables en la versión actual del protocolo de administración XML de Junos, consulte Comprobación de compatibilidad de software.

version	(Requerido) Especifica la versión del protocolo de administración XML de Junos que utiliza la aplicación cliente.
hostname	(Opcional) Asigna un nombre al equipo en el que se ejecuta la aplicación cliente. La información se utiliza sólo cuando se diagnostican problemas. El protocolo XML de Junos no incluye compatibilidad para establecer relaciones de host de confianza ni para modificar de otro modo el comportamiento del servidor del protocolo XML de Junos en función del nombre de host del cliente.
junos:key	(Opcional) Solicita que el servidor de protocolo XML de Junos indique si un elemento de configuración secundario es un identificador de su elemento primario. El único valor aceptable es "clave". Para obtener más información, consulte Solicitud de indicadores de identificador para elementos de configuración mediante el protocolo XML de Junos.
release	(Opcional) Identifica la versión de Junos OS (y, por implicación, la API XML de Junos) para la que está diseñada la aplicación cliente. El valor de este atributo indica que la aplicación cliente puede interoperar correctamente con un servidor de protocolo XML de Junos que también admita esa versión de la API XML de Junos. En otras palabras, indica que la aplicación cliente emite elementos de etiqueta de solicitud desde esa API y sabe cómo analizar elementos de etiqueta de respuesta de ella. Si la aplicación no incluye este atributo, el servidor de protocolo XML de Junos emite elementos de etiqueta de la API XML de Junos que admite. Para el valor del release atributo, utilice la notación estándar para los números de versión de Junos OS. Por ejemplo, el valor 20.4R1 representa la versión inicial de Junos OS versión 20.4.

En el ejemplo siguiente de la etiqueta de apertura <junoscript> de una aplicación cliente, el atributo indica que está utilizando la version="1.0" versión 1.0 del protocolo XML de Junos. El hostname="client1" atributo indica que la aplicación cliente se está ejecutando en el equipo denominado client1. El release="20.4R1" atributo indica que el conmutador, enrutador o dispositivo de seguridad está ejecutando la versión inicial de Junos OS versión 20.4.

Nota:

Si la aplicación no puede emitir el <?xml?> PI antes de emitir la etiqueta de apertura <junoscript> , el servidor de protocolo XML de Junos emite un mensaje de error similar al siguiente y cierra inmediatamente la sesión y la conexión:

Para obtener más información acerca de la <xnm:error> etiqueta, consulte Control de un error o advertencia en sesiones de protocolo XML de Junos.

Cuando comienza la sesión del protocolo Junos XML, el servidor del protocolo Junos XML emite un <?xml?> PI y una etiqueta de apertura <junoscript> .

La sintaxis del <?xml?> IP es la siguiente:

Los atributos son los siguientes. Para obtener una lista de los valores de atributo aceptables en la versión actual del protocolo de administración XML de Junos, consulte Comprobación de compatibilidad de software.

version	La versión de XML con la que cumplen los elementos de etiqueta emitidos por el servidor de protocolo XML de Junos
encoding	El juego de caracteres estandarizado que el servidor de protocolo XML de Junos utiliza y puede entender

En el ejemplo siguiente de PI de un servidor de protocolo XML de <?xml?> Junos, el version="1.0" atributo indica que el servidor está emitiendo elementos de etiqueta que cumplen con la especificación XML 1.0. El encoding="us-ascii" atributo indica que el servidor está utilizando el juego de caracteres ASCII de 7 bits estandarizado por ANSI. Para obtener más información acerca de los estándares ANSI, consulte http://www.ansi.org/ .

Después de emitir el <?xml?> PI, el servidor emite su etiqueta de apertura <junoscript> , que tiene la siguiente forma (la etiqueta aparece en varias líneas solo para facilitar la legibilidad):

Los atributos son los siguientes:

hostname	Nombre del dispositivo en el que se ejecuta el servidor de protocolo XML de Junos.
os	El sistema operativo del dispositivo en el que se ejecuta el servidor de protocolo XML de Junos. El valor es siempre JUNOS.
release	Identificador de la versión de Junos OS de la que se deriva el servidor de protocolo XML de Junos y que está diseñado para comprender. Presumiblemente, está en uso en el dispositivo donde se ejecuta el servidor de protocolo XML de Junos. El valor del release atributo utiliza la notación estándar para los números de versión del software de Juniper Networks. Por ejemplo, el valor 20.4R1 representa la versión inicial de Junos OS versión 20.4.
schemaLocation	Espacio de nombres XML para la representación en lenguaje de esquema XML de la jerarquía de configuración de Junos OS.
version	Versión del protocolo de administración XML de Junos que utiliza el servidor de protocolo XML de Junos.
xmlns	Espacio de nombres XML para los elementos de etiqueta encerrados por el elemento de <junoscript> etiqueta que no tienen un prefijo en sus nombres (es decir, el espacio de nombres predeterminado para los elementos de etiqueta XML de Junos). El valor es una dirección URL del formato http://xml.juniper.net/xnm/version/xnm, donde version es una cadena como 1.1.
xmlns:junos	Espacio de nombres XML para los elementos de etiqueta encerrados por el elemento de <junoscript> etiqueta que tienen el junos: prefijo en sus nombres. El valor es una URL del formato http://xml.juniper.net/junos/release-code/junos, donde release-code es la cadena estándar que representa una versión de Junos OS. Por ejemplo, el valor 20.4R1 representa la versión inicial de Junos OS versión 20.4.

En el ejemplo siguiente de la etiqueta de apertura <junoscript> de un servidor de protocolo XML de Junos, el version atributo indica que el servidor está utilizando la versión 1.0 del protocolo XML de Junos y el hostname atributo indica que el nombre del enrutador es big-device. Los os atributos y release indican que el dispositivo está ejecutando la versión inicial de Junos OS versión 20.4. El xmlns atributo indica que el espacio de nombres predeterminado para los elementos de etiqueta XML de Junos es http://xml.juniper.net/xnm/1.1/xnm . El xmlns:junos atributo indica que el espacio de nombres para los elementos de etiqueta que tienen el junos: prefijo es http://xml.juniper.net/junos/20.4R1/junos . La etiqueta aparece en varias líneas solo para facilitar la legibilidad.

El intercambio de los <?xml?> elementos y <junoscript> permite que una aplicación cliente y el servidor de protocolo XML de Junos determinen si están ejecutando versiones diferentes del software utilizado durante una sesión de protocolo XML de Junos. A veces, las distintas versiones son incompatibles y, según la convención del protocolo XML de Junos, la parte que ejecuta la versión posterior del software determina cómo manejar cualquier incompatibilidad. Para un rendimiento totalmente automatizado, incluya código en la aplicación cliente que determine si su versión de software es posterior a la del servidor de protocolo XML de Junos. Decida cuál de las siguientes opciones es la adecuada cuando la versión de la aplicación sea más reciente e implemente la respuesta correspondiente:

• Ignore las diferencias en la versión de Junos y no modifique el comportamiento de la aplicación cliente para acomodar el servidor de protocolo XML de Junos. Una diferencia en las versiones de Junos no necesariamente hace que el servidor y el cliente sean incompatibles, por lo que este suele ser un enfoque válido.

• Modifique el comportamiento estándar para que sea compatible con el servidor de protocolo XML de Junos. Si la aplicación cliente ejecuta una versión posterior de Junos OS, por ejemplo, puede optar por emitir solo elementos de etiqueta que representen las características de software disponibles en la versión del servidor de protocolo XML de Junos OS del servidor de protocolo Junos OS.

• Finalice la sesión del protocolo XML de Junos y finalice la conexión. Esto es apropiado si decide que no es práctico acomodar la versión de software del servidor de protocolo XML de Junos. Para obtener instrucciones, consulte Finalización de una sesión del protocolo XML de Junos y Cierre de la conexión.

En la tabla 1 se especifica el PI o la etiqueta de apertura y el atributo utilizados para transmitir información de versión durante la inicialización de la sesión del protocolo Junos XML en la versión 1.0 del protocolo de administración XML de Junos.

Tabla 1: PI y etiqueta de apertura del protocolo XML de Junos versión 1.0

Software y versiones	PI o etiqueta	Atributo
XML 1.0	<?xml?>	version="1.0"
Juego de caracteres ASCII de 7 bits estandarizado por ANSI	<?xml?>	encoding="us-ascii"
Protocolo XML de Junos 1.0	<junoscript>	version="1.0"
Versión de Junos OS	<junoscript>	release="m.nZb"Por ejemplo:release="10.3R1"