Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Descripción de las extensiones YANG de Junos OS para formatear la salida DE LA RPC

Junos OS admite XML de forma nativa para el funcionamiento y la configuración de dispositivos que ejecutan Junos OS. La infraestructura de Junos OS y la CLI se comunican mediante XML. Cuando se emite un comando operativo en la CLI, la CLI convierte el comando en XML para su procesamiento. Después del procesamiento, Junos OS devuelve el resultado en forma de un documento XML, que la CLI convierte de nuevo en formato de texto para su visualización. Las aplicaciones de cliente remoto también usan codificación de datos basada en XML para solicitudes operativas y de configuración en dispositivos que ejecutan Junos OS.

El lenguaje de definición de salida (ODL) de Junos OS define la transformación de los datos etiquetados con XML en la salida ASCII formateada que se muestra cuando ejecuta un comando en la CLI o solicita la salida DECI en formato de texto. El módulo de extensiones ODL de Junos OS define extensiones YANG para la ODL, que puede incluir en RPCs yang personalizadas para traducir la respuesta XML DE RPC en una salida ASCII formateada.

La instrucción YANG RPC output define los parámetros de salida para la operación DE RPC. Dentro de la instrucción RPC output , puede incluir instrucciones de extensión ODL para personalizar la salida de LA. En la Tabla 1 se describen las instrucciones disponibles, se proporciona una breve descripción del impacto del formato de cada instrucción y se especifican las ubicaciones en las que se puede definir la instrucción dentro de la instrucción RPC output .

Se incluyen algunas instrucciones de extensión ODL en la instrucción leaf que define los datos y se incluyen otras dentro del contenedor de salida o en varios niveles dentro de la format instrucción, que define el formato de CLI. La colocación de una instrucción dentro de la format instrucción determina el ámbito de la instrucción, que puede aplicarse a un único campo, a todos los campos en una línea o a todos los campos en todas las líneas de salida. Las instrucciones que se pueden definir en cualquier nivel de la format instrucción se pueden incluir en el nivel superior como un secundario directo de la format instrucción, directamente debajo de la line instrucción o dentro de una field instrucción.

Nota:

A partir de Junos OS versión 17.3, el formato de cli para una RPC personalizada se define dentro de la junos-odl:format instrucción extension. En versiones anteriores, el formato de la CLI se define mediante un contenedor que incluye la junos-odl:cli-format instrucción.

Tabla 1: Instrucciones en el módulo de extensiones ODL de Junos OS

Declaración

Descripción

Colocación dentro de la declaración de RPC output

blank-line

Inserte una línea en blanco entre cada repetición de datos cuando la respuesta de RPC devuelva el mismo conjunto de información para varias entidades.

format instrucción (nivel superior )

capitalize

Escriba en mayúscula la primera palabra del valor de un nodo en un campo de salida.

format instrucción (cualquier nivel)

cli-format

Indique que el contenedor de encierro define el formato de la CLI para el contenedor principal. El contenedor de formato no se incluye como nodo en la respuesta XML RPC.

Esta instrucción es obsoleta a partir de Junos OS versión 17.3. Utilice la format instrucción en su lugar.

contenedor de formato (nivel superior)

colon

Inserte dos puntos siguiendo la etiqueta del nodo en un campo de salida.

Esta instrucción solo se usa junto con la leading instrucción para insertar el nombre formal del nodo, como se define en la formal-name instrucción, y un colon antes del valor del nodo en el campo de salida.

format instrucción (cualquier nivel)

comma

Inserte una coma después del valor de un nodo en un campo de salida.

format instrucción (cualquier nivel)

default-text

Especifique el texto que se mostrará cuando falta el nodo correspondiente a un campo de salida.

field Declaración

explicit

Dirija el renderizador para que muestre un valor que no esté relacionado con el nombre del nodo o su contenido. Esta instrucción se usa solo en las RPC de Junos OS y no se puede incluir en las RPCs personalizadas.

field

Asigne un nodo leaf en el árbol de salida a un campo en la salida ASCII formateada.

line Declaración

fieldwrap

Ajuste el contenido completo de un campo en la siguiente línea cuando la línea actual sea más ancha que la pantalla. Omitir esta instrucción hace que el resultado se ajuste sin tener en cuenta las interrupciones de palabras adecuadas o el margen predominante.

field Declaración

float

Habilite el valor de un campo para desplazarse a la izquierda hacia un campo vacío.

Utilice esta instrucción para indicar valores subsiguientes mutuamente exclusivos para un conjunto de campos adyacentes, de modo que solo el campo izquierdo incluya uno de estos valores posibles. Si el primer valor no completa el campo izquierdo, un valor asignado a un campo posterior que incluya la float instrucción puede moverse al campo vacío.

field Declaración

formal-name

Defina la etiqueta que precede al valor de un nodo en un campo de salida siempre que el campo de ese nodo incluya la leading instrucción en las instrucciones de formato.

leaf Nodo

format

Defina el formato de CLI para el contenedor principal dentro de la instrucción RPC output .

A partir de Junos OS versión 17.3, el formato de la CLI se define dentro de la format instrucción en lugar de dentro de un contenedor que incluye la cli-format instrucción.

contenedor de salida o como subestado a la style instrucción.

header

Defina una fila de encabezado en la salida de la CLI.

format instrucción (nivel superior)

header-group

Exija que solo se emita la primera cadena de encabezado definida por la header instrucción en la salida de cli para ese grupo de encabezados.

format instrucción (nivel superior)

indent

Sangría todas las líneas distintas de la fila de encabezado por el número especificado de espacios en la salida de la CLI.

format instrucción (nivel superior)

leading

Inserte una etiqueta, que está definida por la formal-name instrucción en la definición de un nodo leaf, antes del valor del nodo en un campo de salida.

format instrucción (cualquier nivel)

line

Defina el grupo de campos que comprende una sola línea de salida.

format instrucción (nivel superior)

no-line-break

Muestra varios valores en la misma línea en el caso de que se emita varias entidades con los mismos nombres de etiqueta.

format instrucción (nivel superior)

picture

Especifique gráficamente la ubicación, la justificación y el ancho de las columnas en una tabla en la salida ASCII formateada de LAR.

format instrucción (nivel superior)

space

Inserte un espacio después del valor del nodo en un campo de salida.

Si la space instrucción se usa junto con la comma instrucción, el resultado inserta una coma y, luego, un espacio después del valor del nodo, en ese orden.

format instrucción (cualquier nivel)

style

Defina un formato, o un estilo, para la salida de LAR.

Use esta instrucción junto con un parámetro de entrada enumerado que define los nombres para cada estilo. Defina esta instrucción con el nombre de estilo adecuado para especificar el formato de la CLI para ese estilo.

contenedor de salida

template

Defina explícitamente el formato de un campo de salida, incluida la cadena de salida y la colocación del valor del nodo dentro de esa cadena. Utilice %s o %d indique la colocación de la cadena o el valor entero del nodo, respectivamente, dentro de la cadena de salida.

Si una instrucción leaf define tanto una template como una formal-name instrucción, y las instrucciones de formato del campo correspondiente incluyen la leading instrucción, el resultado muestra el texto definido para la formal-name instrucción y no el texto definido para la template instrucción.

leaf Nodo

truncate

Truncar el valor de un nodo para que se ajuste al ancho de campo definido por la picture instrucción si el contenido del nodo superaría de otro modo el ancho del campo.

field Declaración

wordwrap

Ajuste parte del campo en la siguiente línea cuando la línea actual sea más ancha que la pantalla. Esta instrucción solo se debe usar para los campos de la columna derecha de una tabla.

field Declaración

Para obtener más información acerca de la estructura de las RPCs yang, consulte Crear RPCs personalizadas en YANG para dispositivos que ejecutan Junos OS.

Tabla de historial de versiones
Lanzamiento
Descripción
17.3R1
A partir de Junos OS versión 17.3, el formato de cli para una RPC personalizada se define dentro de la junos-odl:format instrucción extension. En versiones anteriores, el formato de la CLI se define mediante un contenedor que incluye la junos-odl:cli-format instrucción.