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.
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.
Declaración |
Descripción |
Colocación dentro de la declaración de RPC |
---|---|---|
|
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. |
|
|
Escriba en mayúscula la primera palabra del valor de un nodo en un campo de salida. |
|
|
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 |
contenedor de formato (nivel superior) |
|
Inserte dos puntos siguiendo la etiqueta del nodo en un campo de salida. Esta instrucción solo se usa junto con la |
|
|
Inserte una coma después del valor de un nodo en un campo de salida. |
|
|
Especifique el texto que se mostrará cuando falta el nodo correspondiente a un campo de salida. |
|
|
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. |
– |
|
Asigne un nodo leaf en el árbol de salida a un campo en la salida ASCII formateada. |
|
|
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. |
|
|
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 |
|
|
Defina la etiqueta que precede al valor de un nodo en un campo de salida siempre que el campo de ese nodo incluya la |
|
|
Defina el formato de CLI para el contenedor principal dentro de la instrucción RPC A partir de Junos OS versión 17.3, el formato de la CLI se define dentro de la |
contenedor de salida o como subestado a la |
|
Defina una fila de encabezado en la salida de la CLI. |
|
|
Exija que solo se emita la primera cadena de encabezado definida por la |
|
|
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. |
|
|
Inserte una etiqueta, que está definida por la |
|
|
Defina el grupo de campos que comprende una sola línea de salida. |
|
|
Muestra varios valores en la misma línea en el caso de que se emita varias entidades con los mismos nombres de etiqueta. |
|
|
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. |
|
|
Inserte un espacio después del valor del nodo en un campo de salida. Si la |
|
|
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 |
|
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 Si una instrucción leaf define tanto una |
|
|
Truncar el valor de un nodo para que se ajuste al ancho de campo definido por la |
|
|
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. |
|
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.
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.