Solicitar dados de configuração usando o NETCONF
Em uma sessão netconf com um dispositivo executando o Junos OS, para solicitar dados de configuração para uma plataforma de roteamento, comutação ou segurança, um aplicativo do cliente inclui os <get-config>elementos , <source>e <filter> tag em um <rpc> elemento de tag. Ao incluir o elemento de tag infantil apropriado no <source> elemento tag, o aplicativo do cliente solicita informações da configuração ativa ou da configuração do candidato ou do banco de dados de configuração aberta. Ao incluir os elementos de tag infantil apropriados no <filter> elemento de tag, o aplicativo pode solicitar toda a configuração ou partes específicas da configuração.
<rpc>
<get-config>
<source>
<!-- tag specifying the source configuration -->
<( candidate | running )/>
</source>
<filter type="subtree">
<!-- tag elements representing the configuration elements to return -->
</filter>
</get-config>
</rpc>
]]>]]>
O type="subtree" atributo na tag de abertura <filter> indica que o aplicativo do cliente está usando elementos de tag Junos XML para representar os elementos de configuração sobre os quais ele está solicitando informações.
Se um aplicativo cliente emitir a operação de protocolo <open-configuration> Junos XML para abrir um banco de dados de configuração específico antes de executar a <get-config> operação, configure a fonte para <candidate/> recuperar os dados de configuração do banco de dados de configuração aberta. Caso contrário, o servidor devolve os dados de configuração da configuração do candidato.
Se o aplicativo do cliente bloqueia a configuração do candidato antes de fazer solicitações, ele precisa desbloqueá-la depois de fazer suas solicitações de leitura. Outros usuários e aplicativos não podem alterar a configuração enquanto ela permanece bloqueada. Para obter mais informações, consulte Bloquear e desbloquear a configuração do candidato usando o NETCONF.
O servidor NETCONF inclui sua resposta e <rpc-reply><data><configuration> elementos de tag. Ele inclui atributos na tag de abertura <configuration> que indicam o namespace XML para os elementos de tag fechados e quando a configuração foi alterada ou comprometida pela última vez. Para obter informações sobre os atributos da <configuration> tag, consulte Especifique a fonte para solicitações de informações de configuração usando o NETCONF.
<rpc-reply xmlns="URN" xmlns:junos="URL">
<data>
<configuration attributes>
<!-- JUNOS XML tag elements representing configuration elements -->
</configuration>
</data>
</rpc-reply>
]]>]]>
Se um elemento de tag Junos XML for devolvido dentro de um <undocumented> elemento de tag, o elemento de configuração correspondente não está documentado nos guias de configuração do Junos OS ou suportado oficialmente pela Juniper Networks. Na maioria das vezes, o elemento fechado é usado apenas para depuração por pessoal de suporte. Em um número menor de casos, o elemento não é mais suportado ou foi transferido para outra área da hierarquia de configuração, mas aparece no local atual para compatibilidade reversa.
Ao exibir dados operacionais ou de configuração que contêm caracteres fora do conjunto de caracteres ASCII de 7 bits, o Junos OS escapa e codifica esses caracteres usando a referência de caráter decimal UTF-8 equivalente. Para obter mais informações , veja como a codificação de caracteres funciona nos dispositivos da Juniper Networks.
Os aplicativos do cliente também podem solicitar outras informações relacionadas à configuração, incluindo uma representação do esquema XML da hierarquia de configuração ou informações sobre configurações previamente comprometidas.