Cambiar el estado de activación de un elemento de configuración mediante el protocolo XML de Junos
Cuando un elemento de configuración (nivel de jerarquía u objeto de configuración) se desactiva y la configuración se confirma, el elemento desactivado permanece en la configuración, pero el elemento no afecta al funcionamiento del dispositivo. Desactivar los elementos de configuración es útil cuando desea solucionar problemas mediante la supresión del comportamiento de un elemento de configuración sin eliminarlo de la configuración. Además, puede configurar y desactivar nuevos elementos de configuración para preparar la configuración y adaptar el nuevo hardware antes de que esté disponible.
En una sesión de protocolo NETCONF o Junos XML con un dispositivo Junos, una aplicación cliente puede desactivar un elemento existente o crear y desactivar simultáneamente un nuevo elemento. Una aplicación cliente también puede activar un elemento desactivado para que cuando se confirma la configuración, el elemento vuelva a tener un efecto en el funcionamiento del dispositivo. En las siguientes secciones se explica cómo crear y desactivar nuevos elementos de configuración y cómo activar o desactivar elementos existentes:
Desactivar un elemento recién creado
Para crear un elemento e desactivarlo inmediatamente, una aplicación cliente incluye primero los elementos básicos de etiqueta o instrucciones de configuración para el nuevo elemento y cualquier elemento secundario, tal como se describe en Creación, modificación o eliminación de elementos de configuración mediante el protocolo XML de Junos.
XML
Cuando se utilizan elementos de etiqueta XML de Junos para crear y desactivar un nuevo elemento, la aplicación incluye el inactive="inactive" atributo en la etiqueta de apertura para el nuevo elemento. En el ejemplo siguiente, el elemento tag identificador se denomina <name>:
<configuration>
<!-- opening tag for each parent of the element -->
<element inactive="inactive">
<name>identifier</name> <!-- if element has an identifier -->
<!-- tag elements for each child of the element -->
</element>
<!-- closing tag for each parent of the element -->
</configuration>
En una sesión NETCONF compatible con YANG, puede activar o desactivar un elemento de configuración en datos XML incluyendo los xmlns:jcmd="http://yang.juniper.net/junos/jcmd" atributos y jcmd:active="(true | false)" en el elemento tag. Para obtener más información, consulte Anotaciones de metadatos YANG para dispositivos Junos.
Texto
Cuando se utiliza texto ASCII formateado para crear y desactivar un nuevo elemento, la aplicación precede al nuevo elemento con el inactive: operador.
<configuration-text>
/* statements for parent levels */
/* For an object with an identifier */
inactive:
object identifier {
/* Child configuration statements */
}
/* For a hierarchy level or object without an identifier */
inactive:
element {
/* Child configuration statements */
}
/* closing braces for parent levels */
</configuration-text>
Comandos del modo de configuración (Set)
Cuando se utilizan comandos del modo de configuración para crear un elemento inactivo, la aplicación primero crea el elemento con el set comando y, luego, lo desactiva mediante el deactivate comando.
<configuration-set>
set statement-path-to-object object identifier
deactivate statement-path-to-object object identifier
</configuration-set>
JSON
Cuando se utilizan datos de configuración JSON para crear y desactivar un nuevo elemento, la aplicación cliente incluye el "inactive" : true atributo en la lista de atributos para ese elemento. La siguiente configuración genérica de JSON indica la colocación del atributo para desactivar un objeto de jerarquía o contenedor, un objeto que tiene un identificador y una instrucción leaf.
<configuration-json>
{
"configuration" : {
/* JSON objects for parent levels */
"level-or-container" : {
"@" : {
"comment" : "/* deactivate a hierarchy */",
"inactive" : true
},
"object" : [
{
"@" : {
"comment" : "/* deactivate an object with an identifier */",
"inactive" : true
},
"name" : "identifier",
"statement-name" : "statement-value",
"@statement-name" : {
"comment" : "/* deactivate a statement */",
"inactive" : true
},
/* additional data and child objects */ # if any
}
]
}
/* closing braces for parent levels */
}
}
</configuration-json>
En una sesión NETCONF compatible con YANG, puede activar o desactivar un objeto de configuración en datos JSON incluyendo la "junos-configuration-metadata:active" : (true | false) anotación en el objeto metdata de la instrucción. Para obtener más información, consulte Anotaciones de metadatos YANG para dispositivos Junos.
Desactivar o reactivar un elemento existente
Para desactivar un elemento existente o activar un elemento previamente desactivado, una aplicación cliente incluye los elementos de etiqueta básicos o instrucciones de configuración para sus niveles primarios, como se describe en Creación, modificación o eliminación de elementos de configuración mediante el protocolo XML de Junos.
XML
Cuando se utilizan elementos de etiqueta JUnos XML para representar un objeto de configuración que tiene un identificador, la aplicación incluye el inactive="inactive" o active="active" atributo en la etiqueta de contenedor de apertura del objeto y también emite el elemento y el valor de la etiqueta identificador. En el ejemplo siguiente, el elemento tag identificador se denomina <name>. Para representar un nivel de jerarquía o un objeto de contenedor con elementos complementarios pero sin identificador, la aplicación usa una etiqueta vacía:
<configuration>
<!-- opening tag for each parent of the element -->
<!- - For an object with an identifier -->
<object ( inactive="inactive" | active="active" ) >
<name>identifier</name>
</object>
<!-- For a hierarchy level or object without an identifier -->
<level-or-container ( inactive="inactive" | active="active" ) />
<!-- closing tag for each parent of the element -->
</configuration>
En una sesión NETCONF compatible con YANG, puede activar o desactivar un elemento de configuración en datos XML incluyendo los xmlns:jcmd="http://yang.juniper.net/junos/jcmd" atributos y jcmd:active="(true | false)" en el elemento tag. Para obtener más información, consulte Anotaciones de metadatos YANG para dispositivos Junos.
Texto
Cuando se utiliza texto ASCII formateado para representar el elemento, la aplicación precede al elemento con el inactive: operador o active: . El nombre de un nivel de jerarquía o un objeto de contenedor va seguido de un punto y coma (aunque en la configuración existente le siguen corsés curvilín que encierran sus instrucciones secundarias):
<configuration-text>
/* statements for parent levels */
/* For an object with an identifier */
(inactive | active):
object identifier;
/* For a hierarchy level or object without an identifier */
(inactive | active):
object-or-level;
/* closing braces for parent levels */
</configuration-text>
Comandos del modo de configuración (Set)
Cuando se utilizan comandos del modo de configuración para activar o desactivar un objeto, la aplicación especifica el activate o deactivate comando equivalente al comando del modo de configuración de CLI.
<configuration-set>
/* For an object with an identifier */
activate statement-path-to-object object identifier
deactivate statement-path-to-object object identifier
/* For a hierarchy level or object without an identifier */
activate statement-path-to-object-or-level object-or-level
deactivate statement-path-to-object-or-level object-or-level
</configuration-set>
JSON
Cuando se usa JSON para representar el elemento, la aplicación de cliente activa o desactiva el elemento incluyendo el "active" : true o "inactive" : true atributo, respectivamente, en la lista de atributos de ese elemento. La siguiente configuración genérica de JSON indica la ubicación del atributo para activar o desactivar jerarquías u objetos de contenedor existentes, objetos que tienen un identificador y instrucciones leaf.
<configuration-json>
{
"configuration" : {
/* JSON objects for parent levels */
"level-or-container" : {
"@" : {
"comment" : "/* activate or deactivate a hierarchy */",
"(active | inactive)" : true
},
"object" : [
{
"@" : {
"comment" : "/* activate or deactivate an object with an identifier */",
"(active | inactive)" : true
},
"name" : "identifier",
"@statement-name" : {
"comment" : "/* activate or deactivate a statement */",
"(active | inactive)" : true
}
}
]
}
/* closing braces for parent levels */
}
}
</configuration-json>
En una sesión NETCONF compatible con YANG, puede activar o desactivar un objeto de configuración en datos JSON incluyendo la "junos-configuration-metadata:active" : (true | false) anotación en el objeto de metadatos de la instrucción. Para obtener más información, consulte Anotaciones de metadatos YANG para dispositivos Junos.
En el ejemplo siguiente se muestra cómo desactivar el isis nivel de jerarquía en el nivel de [edit protocols] jerarquía en la configuración de candidato mediante elementos de etiqueta XML junos.
En el ejemplo siguiente se muestra cómo desactivar el isis nivel de jerarquía en el [edit protocols] nivel de jerarquía en la configuración del candidato mediante JSON.
<rpc>
<load-configuration format="json">
<configuration-json>
{
"configuration" : {
"protocols" : {
"isis" : {
"@" : {
"inactive" : true
}
}
}
}
}
</configuration-json>
</load-configuration>
</rpc>