Descripción de los módulos YANG para comandos operativos de Junos
Juniper Networks publica módulos YANG que definen las llamadas a procedimiento remoto (RPC) para los comandos del modo operativo de Junos. Debido a la gran cantidad de comandos operativos, hay varios módulos YANG para cada familia de dispositivos. Hay un módulo para cada grupo de comandos operativos de nivel superior (clear
, , monitor
file
, etc.) en el que hay al menos un comando dentro de esa jerarquía con un equivalente de RPC. También hay un módulo independiente para cada área dentro de la jerarquía de show
comandos.
A partir de Junos OS versión 17.2, los módulos Junos YANG son específicos de una familia de dispositivos y usan una nueva convención para el espacio de nombres del módulo. Además, cada uno de los módulos de comando operativo individuales define su prefijo de espacio de nombres mediante el área de jerarquía de comandos de las RPCs incluidas en ese módulo. Antes de la versión 17.2 de Junos OS, el prefijo para todos los módulos de comando operativo era jrpc
.
A partir de Junos OS versión 17.4R1, los módulos YANG de Junos OS usan una nueva convención de nomenclatura para el nombre, el nombre de archivo y el espacio de nombres del módulo. Para obtener más información, consulte Descripción de los módulos JUnos YANG.
Los módulos de comando operativo definen las RPCs correspondientes a los comandos operativos en el área de jerarquía de comandos indicada en el nombre de archivo. En el ejemplo siguiente se muestra una parte del módulo que contiene las RPCs para comandos en la clear
jerarquía de comandos:
user@host> file show /var/tmp/yang/junos-rpc-clear@2017-01-01.yang /* * Copyright (c) 2017 Juniper Networks, Inc. * All rights reserved. */ module junos-rpc-clear { namespace "http://yang.juniper.net/junos/rpc/clear"; prefix clear; import junos-common-types { prefix jt; } organization "Juniper Networks, Inc."; contact "yang-support@juniper.net"; description "Junos RPC YANG module for clear command(s)"; revision 2017-01-01 { description "Junos: 17.4R1.17"; } rpc clear-cli-logical-system { description "Clear logical system association"; output { leaf output { type string; } } } rpc clear-cli-satellite { description "Clear satellite association"; output { leaf output { type string; } } } ...
YANG define las operaciones mediante la rpc
instrucción. La definición de RPC puede incluir input
y output
subestados que describen los parámetros de entrada y salida de la operación. A partir de Junos OS versión 23.1R1, la instrucción de LAR incluye un esquema de output
salida preciso, y los dispositivos Junos emiten los nuevos esquemas de forma predeterminada.
En versiones anteriores, el esquema de salida de LAR incluye la anyxml
instrucción para representar un fragmento no desconocido de XML en la respuesta de RPC. Para generar los esquemas RPC que contienen la anyxml
instrucción en un dispositivo Junos, configure las device-specific
instrucciones y emit-anyxml-in-rpc-output
en el [edit system services netconf yang-modules]
nivel de jerarquía. Después de configurar las instrucciones, el show system schema
comando genera los esquemas que utilizan anyxml
.
Puede descargar los módulos junos YANG desde el sitio de descargas de Juniper Networks o el depósito de GitHub de Juniper Networks para YANG, o puede generar los módulos en el dispositivo local. Para generar los módulos yang de comando operativo en el dispositivo local, emita el show system schema format yang module module
comando. La versión de Junos OS determina las opciones de comando disponibles.
-
En junos OS versión 17.3 y anteriores, especifique el
juniper-command
módulo para generar todos los módulos de comando operativos.user@host> show system schema format yang module juniper-command
Nota:A partir de Junos OS versión 17.1, cuando se genera el
juniper-command
módulo, los archivos de salida se colocan en el directorio de trabajo actual, que es de forma predeterminada en el directorio principal del usuario. En junos OS versión 16.2 y anteriores, los archivos de salida se colocan en el directorio /var/tmp . -
En la versión 17.4R1 y posteriores de Junos OS, especifique un nombre de módulo individual para devolver un único módulo de comando operativo o especifique que
all-rpc
devuelva todos los módulos de comando operativos.user@host> show system schema format yang module all-rpc output-directory /var/tmp/yang
A partir de Junos OS versión 19.1R2 y 19.2R1, el
show system schema
comando debe incluir laoutput-directory
opción de comando y especificar el directorio en el que se generará el archivo o archivos. En versiones anteriores, puede omitir laoutput-directory
opción al solicitar un solo módulo para mostrarlo en la salida estándar.
Para generar los módulos desde una sesión remota, ejecute Junos <get-yang-schema>
OS RPC o la <get-schema>
operación NETCONF con las opciones adecuadas.
Si especifica module juniper-command
o module all-rpc
, los archivos de salida incluyen tanto módulos de comando operativo nativos de Junos como cualquier módulo de comando operativo estándar o personalizado que se haya agregado al dispositivo. Para usar una RPC en el módulo YANG personalizado, debe importar el módulo que contenga la RPC deseada en su módulo personalizado.
Puede configurar la instrucción en el emit-extensions
[edit system services netconf yang-modules]
nivel de jerarquía para que emita los esquemas YANG con instrucciones de extensión de Junos adicionales. Las extensiones de Junos se definen en Descripción del módulo YANG de extensiones DDL de Junos. El dispositivo emite la junos:command
instrucción de extensión a partir de Junos OS versión 22.4R1 y Junos OS Evolved versión 22.4R1.
A partir de Junos OS versión 17.4R1, los módulos YANG nativos generados en un dispositivo local contienen esquemas específicos de la familia, que son idénticos en todos los dispositivos de la familia de dispositivos dada. En versiones anteriores, los módulos generados contienen esquemas específicos del dispositivo. Para generar módulos específicos del dispositivo en la versión 17.4R1 y posteriores de Junos OS, configure la device-specific
instrucción de configuración en el [edit system services netconf yang-modules]
nivel de jerarquía.
junos:command
instrucción de extensión en esquemas emitidos con extensiones.
show system schema
comando debe incluir la
output-directory
opción de comando y especificar el directorio en el que se generará el archivo o archivos.
juniper-command
módulo, los archivos de salida se colocan en el directorio de trabajo actual, que es de forma predeterminada en el directorio principal del usuario