Enviar solicitações ao servidor de protocolo Junos XML
Em uma sessão de protocolo Junos XML com um dispositivo executando o Junos OS, um aplicativo do cliente inicia uma solicitação emitindo a tag de abertura <rpc> , um ou mais elementos de tag que representam a solicitação em particular e a tag de fechamento </rpc> , nessa ordem.
<rpc>
<!--tag elements representing a request-->
</rpc>
O aplicativo inclui cada solicitação em seu próprio par separado de tags de abertura <rpc> e fechamento </rpc> . Cada solicitação deve constituir um documento XML bem formado, incluindo apenas elementos de tag em conformidade e ordenados corretamente. O servidor de protocolo Junos XML ignora quaisquer caracteres, espaços ou outros caracteres de espaço brancos que ocorram entre elementos de tag no fluxo de tags, mas preserva o espaço branco dentro dos elementos da tag.
Opcionalmente, um aplicativo do cliente pode incluir um ou mais atributos do formulário attribute-name="value" na tag de abertura <rpc> para cada solicitação. O servidor de protocolo Junos XML repercute cada atributo, inalterado, na tag de abertura <rpc-reply> em que ele desativa sua resposta.
Um aplicativo do cliente pode usar esse recurso para associar solicitações e respostas, incluindo um atributo em cada tag de solicitação de abertura <rpc> que atribui um identificador único. O servidor de protocolo Junos XML repercute o atributo em sua tag de abertura <rpc-reply> , tornando mais fácil mapear a resposta à solicitação de iniciação. O aplicativo do cliente pode definir livremente os nomes dos atributos, exceto conforme descrito na nota a seguir.
O nome do xmlns:junos atributo está reservado. O servidor de protocolo Junos XML define o atributo a um valor apropriado na tag de abertura <rpc-reply> , de modo que os aplicativos do cliente não devem emitê-lo na tag de abertura <rpc> .
Embora as solicitações operacionais e de configuração pertençam conceitualmente a classes separadas, uma sessão de protocolo Junos XML não tem modos distintos que correspondem aos modos operacionais e de configuração da CLI. Cada tag de solicitação é fechada dentro de sua própria <rpc> tag, de modo que um aplicativo cliente pode alternar livremente solicitações operacionais e de configuração. Um aplicativo do cliente pode fazer três aulas de solicitações:
Solicitações operacionais
Solicitações operacionais são solicitações de informações sobre o status de um dispositivo que executa o Junos OS. As solicitações operacionais correspondem aos comandos de modo operacional Junos OS CLI. A API Junos XML define uma tag de solicitação para muitos comandos CLI. Por exemplo, a <get-interface-information> tag corresponde ao show interfaces comando e a <get-chassis-inventory> tag solicita as mesmas informações que o show chassis hardware comando.
A RPC a seguir solicita informações detalhadas sobre a interface ge-2/3/0:
<rpc>
<get-interface-information>
<interface-name>ge-2/3/0</interface-name>
<detail/>
</get-interface-information>
</rpc>
Para obter mais informações sobre solicitações operacionais, consulte Solicitando informações operacionais usando o Protocolo Junos XML. Para obter informações sobre os elementos de tag de solicitação do Junos XML disponíveis na versão atual do Junos OS, consulte a referência operacional do desenvolvedor operacional de API Junos XML e o XML API Explorer.
Solicitações de informações de configuração
As solicitações de informações de configuração são solicitações de informações sobre a configuração do candidato do dispositivo, uma configuração privada, a configuração efêmera ou a configuração comprometida (aquela atualmente em uso ativo na plataforma de roteamento, comutação ou segurança). As configurações do candidato e comprometidas divergem quando há alterações não comprometidas na configuração do candidato.
O protocolo Junos XML define a <get-configuration> operação para recuperar informações de configuração. A API Junos XML define um elemento de tag para cada declaração de contêiner e leaf na hierarquia de configuração.
O exemplo a seguir mostra como solicitar informações sobre o nível de [edit system login] hierarquia na configuração do candidato:
<rpc>
<get-configuration>
<configuration>
<system>
<login/>
</system>
</configuration>
</get-configuration>
</rpc>
Para obter mais informações sobre solicitações de informações de configuração, consulte Solicitando dados de configuração usando o Protocolo Junos XML. Para obter um resumo dos elementos de tag de configuração do Junos XML, veja a referência do desenvolvedor de configuração de API Junos XML e o XML API Explorer.
Solicitações de mudança de configuração
As solicitações de mudança de configuração são solicitações para alterar a configuração ou para confirmar essas alterações para colocá-las em uso ativo no dispositivo que executa o Junos OS. O protocolo Junos XML define a <load-configuration> operação para alterar as informações de configuração. A API Junos XML define um elemento de tag para cada declaração de configuração CLI descrita nos guias de configuração do Junos OS.
O exemplo a seguir mostra como criar uma nova conta de usuário do Junos OS chamada admin no nível de [edit system login] hierarquia na configuração do candidato:
<rpc>
<load-configuration>
<configuration>
<system>
<login>
<user>
<name>admin</name>
<full-name>Administrator</full-name>
<class>superuser</class>
</user>
</login>
</system>
</configuration>
</load-configuration>
</rpc>
Para obter mais informações sobre solicitações de mudança de configuração, consulte Solicitando mudanças na configuração usando o protocolo Junos XML e comprometendo a configuração do candidato usando o Protocolo Junos XML. Para obter um resumo dos elementos de tag de configuração do Junos XML, veja a referência do desenvolvedor de configuração de API Junos XML e o XML API Explorer.