Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Asignar instrucciones de configuración a elementos de etiqueta XML de Junos

La API XML de Junos define un elemento de etiqueta para cada contenedor y instrucción leaf en la jerarquía de configuración. En los niveles superiores de la jerarquía de configuración, casi siempre hay una asignación uno a uno entre elementos e instrucciones de etiqueta, y la mayoría de los nombres de etiqueta coinciden con el nombre de la instrucción de configuración. En los niveles más profundos de la jerarquía, la asignación a veces es menos directa, ya que algunas convenciones CLI no se asignan directamente a la sintaxis de etiquetado compatible con XML.

Nota:

Para algunas instrucciones de configuración, la notación utilizada cuando se escribe la instrucción en el símbolo del modo de configuración de CLI difiere de la notación utilizada en un archivo de configuración. El mismo elemento de etiqueta XML de Junos se asigna a ambos tipos de estilo notacional.

En las siguientes secciones se describe la asignación entre instrucciones de configuración y elementos de etiqueta XML de Junos:

Asignación para niveles de jerarquía e instrucciones de contenedor

El <configuration> elemento es el elemento contenedor XML Junos de nivel superior para instrucciones de configuración. Corresponde al nivel de [edit] jerarquía en CLI modo de configuración. La mayoría de las instrucciones en los próximos niveles de la jerarquía de configuración son instrucciones de contenedor. El elemento de etiqueta de contenedor XML de Junos que corresponde a una instrucción container casi siempre tiene el mismo nombre que la instrucción.

En el ejemplo siguiente se muestra los elementos de etiqueta XML de Junos para dos instrucciones en el nivel superior de la jerarquía de configuración. Tenga en cuenta que una llave de CLI de configuración corresponde a una etiqueta XML de Junos de cierre.

Mapping for Hierarchy Levels and Container Statements

Asignación para objetos que tengan un identificador

En algunos niveles de jerarquía, el mismo tipo de objeto de configuración puede ocurrir varias veces. Cada instancia del objeto tiene un identificador único para distinguirlo de las otras instancias. En la CLI, la instrucción principal de dicho objeto consta de una palabra clave y un identificador del siguiente formulario:

keyword es una cadena fija que indica el tipo de objeto que se está definindo y es el nombre único para identifier esta instancia del tipo. En la API XML de Junos, el elemento de etiqueta correspondiente a la palabra clave es un elemento de etiqueta de contenedor para elementos de etiqueta secundaria que representan las características del objeto. El nombre del elemento de etiqueta de contenedor generalmente coincide con la keyword cadena.

La API XML de Junos difiere de la CLI en su tratamiento del identificador. Dado que la API XML de Junos no permite que los elementos de etiqueta de contenedor contengan tanto otros elementos de etiqueta como datos de caracteres sin etiqueta, como un nombre de identificador, el identificador debe incluirse en un elemento de etiqueta propio. Con mayor frecuencia, los elementos de etiqueta de identificador para objetos de configuración se denominan <name> . Algunos objetos tienen varios identificadores, los cuales generalmente tienen nombres distintos a <name> . Para comprobar el nombre de cada elemento de etiqueta de identificador para un objeto de configuración, consulte la entrada para el objeto en la Referencia de desarrollador de configuración de API DE Junos XML.

Nota:

El Junos OS reserva el prefijo para los identificadores de los grupos de configuración junos- definidos dentro del junos-defaults grupo de configuración. Los identificadores definidos por el usuario no pueden comenzar con la cadena junos- .

Los elementos de etiqueta de identificador también constituyen una excepción a la convención XML general de que los elementos de etiqueta en el mismo nivel de jerarquía pueden aparecer en cualquier orden; el elemento de etiqueta de identificador siempre se produce primero en el elemento de etiqueta de contenedor.

La configuración de la mayoría de los objetos que tienen identificadores incluye instrucciones leaf adicionales, las cuales representan otras características del objeto. Por ejemplo, cada grupo de BGP configurado en el nivel de jerarquía tiene un nombre asociado (el identificador) y puede tener instrucciones leaf para otras características como tipo, número de sistema autónomo par (AS) y dirección de [edit protocols bgp group] vecino. Para obtener información acerca de la asignación XML de Junos para instrucciones leaf, consulte Asignación para instrucciones leaf de un solo valor y formato fijo,Asignación para instrucciones leafcon varios valores y Asignación para varias opciones en una o más líneas.

En el ejemplo siguiente se muestra los elementos de etiqueta XML de Junos para instrucciones de configuración que definen dos BGP denominados <name> y <name> . Observe que el elemento XML de Junos que incluye el identificador de cada grupo (y el identificador del vecino dentro de un grupo) no tiene un homólogo en las <name> instrucciones CLI.

Mapping for Objects That Have an Identifier

Asignación para instrucciones leaf de valor único y de formato fijo

Una instrucción leaf es una instrucción CLI de configuración que no contiene ninguna otra instrucción. La mayoría de las instrucciones leaf definen un valor para una característica de un objeto de configuración y tienen el siguiente formato:

En general, el nombre del elemento de etiqueta XML Junos correspondiente a una instrucción leaf es el mismo que la keyword cadena. La cadena entre las etiquetas XML de Junos de apertura y cierre es la misma que la value cadena.

En el siguiente ejemplo, se muestra los elementos de etiqueta XML de Junos para dos instrucciones leaf que tienen una palabra clave y un valor: la instrucción en el nivel de jerarquía y la instrucción en message [edit system login] el nivel de preference [edit protocols ospf] jerarquía.

Mapping for Single-Value and Fixed-Form Leaf Statements

Algunas instrucciones leaf se componen de una palabra clave de formato fijo solo, sin un valor de formato variable asociado. La API XML de Junos representa estas instrucciones con una etiqueta vacía. En el ejemplo siguiente se muestra los elementos de etiqueta XML de Junos para la disable instrucción en el nivel [edit forwarding-options sampling] jerárquido.

Mapping for Single-Value and Fixed-Form Leaf Statements

Asignación para instrucciones leaf con varios valores

Algunas Junos OS leaf aceptan varios valores, los cuales se pueden definir por el usuario o extraerse de un conjunto de valores predefinidos. CLI la notación utiliza corchetes para incluir todos los valores en una sola instrucción, como en la siguiente:

En su lugar, la API XML de Junos incluye cada valor en su propio elemento de etiqueta. En el ejemplo siguiente se muestra los elementos de etiqueta XML de Junos para una instrucción CLI con varios valores definidos por el usuario. La import instrucción importa dos políticas de enrutamiento definidas en otro lugar de la configuración.

Mapping for Leaf Statements with Multiple Values

En el ejemplo siguiente se muestra los elementos de etiqueta XML de Junos para una instrucción CLI con varios valores predefinidos. La permissions instrucción concede tres permisos predefinidos a los miembros de la clase de inicio de user-accounts sesión.

Mapping for Leaf Statements with Multiple Values

Asignación para varias opciones en una o más líneas

Para algunos Junos OS de configuración, la sintaxis estándar de CLI coloca varias opciones en una sola línea, por lo general, para una mayor concisibilidad y concisa. En la mayoría de los casos, la primera opción identifica el objeto y no tiene una palabra clave, pero las opciones posteriores son palabras clave y valores emparejados. La API XML de Junos incluye cada opción en su propio elemento de etiqueta. Dado que la primera opción no tiene palabra clave en la instrucción CLI, la API XML de Junos asigna un nombre a su elemento de etiqueta.

En el ejemplo siguiente se muestra los elementos de etiqueta XML de Junos para CLI instrucción de configuración con varias opciones en una sola línea. La API XML de Junos define un elemento de etiqueta para ambas opciones y asigna un nombre al elemento de etiqueta para la primera opción (10.0.0.1), la cual no tiene ninguna palabra CLI clave.

Mapping for Multiple Options on One or More Lines

La sintaxis de algunos objetos de configuración incluye más de una línea de multiopción. De nuevo, la API XML de Junos define un elemento de etiqueta independiente para cada opción. En el siguiente ejemplo, se muestran los elementos de etiqueta XML de Junos para una traceoptions instrucción en el nivel [edit protocols isis] jerárquido. La instrucción tiene tres instrucciones secundarias, cada una con varias opciones.

Mapping for Multiple Options on One or More Lines

Asignación para comentarios sobre instrucciones de configuración

Una Junos OS configuración puede incluir comentarios que describen instrucciones en la configuración. En CLI modo de configuración, el comando define el comentario para annotate asociarlo a una instrucción en el nivel de jerarquía actual. También puede usar un editor de texto para insertar comentarios directamente en un archivo de configuración. Para obtener más información, consulte la Guía del CLI usuario.

La API XML de Junos incluye comentarios sobre instrucciones de configuración en el <junos:comment> elemento. (Estos comentarios son diferentes de los comentarios que se enciechan en las cadenas y se descartan automáticamente <!-- por el servidor de --> protocolo.)

En la API XML de Junos, <junos:comment> el elemento precede inmediatamente al elemento para la instrucción de configuración asociada. (Si se omite el elemento de etiqueta para la instrucción asociada, el comentario no se registra en la base de datos de configuración.) La cadena de texto del comentario puede incluir uno de los dos delimitadores que indican un comentario en la base de datos de configuración: el carácter antes del comentario o las cadenas emparejadas antes del comentario y # /* */ después. Si la aplicación cliente no incluye el delimitador, el servidor de protocolo agrega el apropiado cuando agrega el comentario a la configuración. El servidor de protocolo también conserva cualquier espacio en blanco incluido en el comentario.

En el ejemplo siguiente se muestra los elementos de etiqueta XML de Junos que asocian comentarios con dos instrucciones en una instrucción de configuración de ejemplo. El primer comentario muestra cómo, al incluir caracteres de línea nueva en el contenido del elemento ( ), el comentario aparece en su propia línea en el archivo <junos:comment> /* New backbone area */ de configuración. No hay caracteres de línea nueva en el contenido del segundo elemento, por lo que en el archivo de configuración el comentario sigue directamente la instrucción asociada <junos:comment> en la misma línea.

Mapping for Comments About Configuration Statements