Solicite um esquema XML para a hierarquia de configuração usando o NETCONF
O esquema representa todos os elementos de configuração disponíveis na versão do Junos OS que está em execução em um dispositivo. (Para determinar a versão do Junos OS, emita o <get-software-information> elemento de tag de solicitação operacional, documentado na Referência operacional do desenvolvedor de API Junos XML.)
Os aplicativos do cliente podem usar o esquema para validar a configuração em um dispositivo ou simplesmente para saber quais declarações de configuração estão disponíveis na versão do Junos OS em execução no dispositivo. O esquema não indica quais elementos estão configurados ou mesmo que um elemento pode ser configurado nesse tipo de dispositivo (algumas declarações de configuração estão disponíveis apenas em determinados tipos de dispositivo). Para solicitar o conjunto de elementos configurados atualmente e suas configurações, emite o <get-config> elemento tag em vez disso, conforme descrito nos dados de configuração de solicitação usando NETCONF.
Explicar a estrutura e as convenções de notação da linguagem XML Schema está além do escopo deste documento. Para obter informações, consulte o XML Schema Parte 0: Primer, disponível no World Wide Web Consortium (W3C) em http://www.w3.org/TR/xmlschema-0/ . O primer fornece uma introdução básica e lista as especificações formais onde você pode encontrar informações detalhadas.
Para obter mais informações, consulte as seguintes seções:
Solicitando um esquema XML para a hierarquia de configuração
Em uma sessão netconf com um dispositivo executando o Junos OS, para solicitar uma representação em linguagem XML Schema de toda a hierarquia de configuração, um aplicativo do cliente emite o elemento de tag Junos XML <get-xnm-information> e seus <type> elementos de <namespace> tag infantil com os valores indicados em um <rpc> elemento de tag:
<rpc> <get-xnm-information> <type>xml-schema</type> <namespace>junos-configuration</namespace> </get-xnm-information> </rpc> ]]>]]>
O servidor NETCONF inclui o esquema <rpc-reply> XML e <xsd:schema> os elementos de tag:
<rpc-reply xmlns="URN" xmlns:junos="URL"> <xsd:schema> <!-- tag elements for the Junos XML schema --> </xsd:schema> </rpc-reply> ]]>]]>
Criação do arquivo junos.xsd
A maioria dos elementos de tag definidos no esquema devolvido na <xsd:schema> tag pertencem ao namespace padrão para elementos de configuração do Junos OS. No entanto, pelo menos uma tag, <junos:comment>pertence a um namespace diferente: http://xml.juniper.net/junos/Junos-version/junos. Pela convenção XML, um esquema descreve apenas um namespace, de modo que os validadores de esquema precisam importar informações sobre quaisquer espaços de nome adicionais antes que possam processar o esquema.
A partir do Junos OS Release 6.4, o <xsd:import> elemento tag é fechado no <xsd:schema> elemento tag e faz referência ao arquivo junos.xsd, que contém as informações necessárias sobre o junos namespace. Por exemplo, o seguinte <xsd:import> elemento de tag especifica o arquivo para o Junos OS Release 20.4R1 (e aparece em duas linhas apenas para legibilidade):
<xsd:import schemaLocation="junos.xsd" \ namespace="http://xml.juniper.net/junos/20.4R1/junos"/>
Para permitir que o validador de esquema interprete o <xsd:import> elemento de tag, você deve criar manualmente um arquivo chamado junos.xsd no diretório onde você coloca o arquivo .xsd que contém o esquema completo de configuração do Junos OS. Inclua o texto a seguir no arquivo. Não use quebras de linha na lista de atributos na tag de abertura <xsd:schema> . Quebras de linha aparecem no exemplo a seguir apenas para legibilidade. Para a Junos-version variável, substitua o número de versão do Junos OS em execução no dispositivo (por exemplo, 20.4R1 para a primeira versão do Junos OS 20.4).
<?xml version="1.0" encoding="us-ascii"?>
<xsd:schema elementFormDefault="qualified" \
attributeFormDefault="unqualified" \
xmlns:xsd="http://www.w3.org/2001/XMLSchema" \
targetNamespace="http://xml.juniper.net/junos/Junos-version/junos">
<xsd:element name="comment" type="xsd:string"/>
</xsd:schema>
Os validadores de schema podem não ser capazes de processar o esquema se não puderem localizar ou abrir o arquivo junos.xsd .
Sempre que você alterar a versão do Junos OS em execução no dispositivo, lembre-se de atualizar a Junos-version variável no arquivo junos.xsd para combinar.
Exemplo: solicitar um esquema XML
Os exemplos a seguir mostram como solicitar o esquema de configuração do Junos OS. Na resposta do servidor NETCONF, a primeira <xsd:element> declaração define o <undocumented> elemento tag Junos XML, que pode ser fechado na maioria dos outros elementos de tag de contêiner definidos no esquema (elementos de tag de contêiner são definidos como <xsd:complexType>).
Os atributos nas tags de abertura da resposta do servidor NETCONF aparecem em várias linhas apenas para legibilidade. O servidor NETCONF não insere caracteres de linha novos dentro de tags ou elementos de tag. Além disso, na saída real, a JUNOS-version variável é substituída por um valor como 20.4R1 para a versão inicial do Junos OS Release 20.4.
Outra <xsd:element> declaração próxima ao início do esquema define o elemento de tag Junos XML <configuration> . Ele encerra a <xsd:element> declaração que define o <system> elemento tag, que corresponde ao nível de [edit system] hierarquia. As declarações correspondentes a outros níveis de hierarquia são omitidas por brevidade.
