Solicitar dados de configuração usando o protocolo Junos XML
Em uma sessão de protocolo Junos XML com um dispositivo que executa o Junos OS, para solicitar dados de configuração para uma plataforma de roteamento, comutação ou segurança, um aplicativo do cliente inclui o <get-configuration> elemento em uma <rpc> tag. Ao definir atributos opcionais, o aplicativo do cliente pode especificar a origem e a formatação das informações de configuração devolvidas pelo servidor de protocolo Junos XML. Ao incluir os elementos de tag infantil opcionais apropriados, o aplicativo pode solicitar toda a configuração ou partes específicas da configuração. A sintaxe básica é a seguinte:
<rpc>
<!-- If requesting the complete configuration -->
<get-configuration [optional attributes]/>
<!-- If requesting part of the configuration -->
<get-configuration [optional attributes]>
<configuration>
<!-- tag elements representing the data to return -->
</configuration>
</get-configuration>
</rpc>
Para visualizar dados de configuração em uma instância específica do banco de dados de configuração efêmero, um aplicativo do cliente deve abrir a instância efêmera usando a <open-configuration> operação com as tags infantis apropriadas antes de executar a <get-configuration> solicitação.
A partir do Junos OS Release 13.1, dentro de uma sessão de protocolo Junos XML, um usuário do sistema lógico pode usar a operação de protocolo <get-configuration> Junos XML para solicitar hierarquias de configuração de sistema lógico específicas usando tags de configuração infantil, bem como solicitar toda a configuração lógica do sistema. Ao solicitar toda a configuração lógica do sistema, a resposta do RPC inclui a <configuration> tag raiz. Antes do Junos OS Release 13.1, a <configuration> tag raiz foi omitida.
O servidor de protocolo Junos XML encerra sua resposta em um <rpc-reply> elemento de tag. Ele inclui atributos com o junos: prefixo na tag de abertura <configuration> para indicar quando a configuração foi alterada ou comprometida pela última vez e o usuário que a cometeu (os atributos aparecem em várias linhas na declaração de sintaxe apenas para legibilidade). Para obter mais informações sobre os atributos, consulte Especificando a fonte para solicitações de informações de configuração em uma sessão de protocolo Junos XML.
<rpc-reply xmlns:junos="URL">
<!-- If the application requests Junos XML tag elements -->
<configuration junos:(changed | commit)-seconds="seconds" \
junos:(changed | commit)-localtime="YYYY-MM-DD hh:mm:ss TZ" \
[junos:commit-user="username"]>
<!-- Junos XML tag elements representing configuration elements -->
</configuration>
<!-- If the application requests formatted ASCII text -->
<configuration-text>
<!-- formatted ASCII configuration statements -->
</configuration-text>
<!-- If the application requests configuration mode set commands -->
<configuration-set>
<!-- configuration mode commands -->
</configuration-set>
<!-- If the application requests JSON format -->
<configuration-json>
<!-- JSON configuration data -->
</configuration-json>
</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 entender a codificação de caracteres em dispositivos que executam o Junos OS.
Para obter páginas de referência para os <configuration>elementos, <configuration-json><configuration-text><configuration-set>e <undocumented> tag, consulte a referência do desenvolvedor operacional da API Junos XML.
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 o bloqueio e o desbloqueio da configuração do candidato ou a criação de uma cópia privada usando o protocolo Junos XML.
Os tópicos a seguir descrevem como um aplicativo do cliente especifica a origem, formato e quantidade de informações devolvidas pelo servidor de protocolo Junos XML:
Especificando o formato de saída para dados de configuração em uma sessão de protocolo Junos XML
Especificando o escopo dos dados de configuração para retornar em uma sessão de protocolo Junos XML
Os aplicativos 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. Para obter mais informações, veja o seguinte:
Recuperação de uma configuração anterior (reversão) usando o protocolo Junos XML
Recuperação da configuração de resgate usando o protocolo Junos XML
Comparando a configuração ativa ou de candidato com uma versão anterior usando o protocolo Junos XML
Comparando duas configurações anteriores (reversão) usando o protocolo Junos XML
Solicitando um esquema XML para a hierarquia de configuração usando o protocolo Junos XML