Enviar solicitações ao servidor NETCONF
Para iniciar uma solicitação ao servidor NETCONF, um aplicativo cliente emite a etiqueta de abertura, seguido por um ou mais elementos de tags que representam a solicitação específica e a etiqueta de fechamento, nessa <rpc> </rpc> ordem:
<rpc>
<!-- tag elements representing a request -->
</rpc>
]]>]]>
A aplicação inclui cada solicitação em seu próprio par separado de tags de <rpc> abertura e </rpc> fechamento. Cada solicitação deve constituir um documento XML bem formado, incluindo apenas elementos de tags em conformidade e corretamente encomendados. O servidor NETCONF ignora quaisquer caracteres, espaços ou outros caracteres de espaço branco que ocorram entre elementos de tags no fluxo de tags, mas preserva o espaço branco nos elementos de tags.
Opcionalmente, uma aplicação do cliente pode incluir um ou mais atributos do formulário na attribute-name="value" etiqueta de abertura de cada <rpc> solicitação. O servidor NETCONF ecoa cada atributo, inalterado, na etiqueta de abertura na qual <rpc-reply> encerra sua resposta.
Um aplicativo cliente pode usar esse recurso para associar solicitações e respostas, incluindo um atributo em cada etiqueta de solicitação de abertura que <rpc> atribua um identificador exclusivo. O servidor NETCONF ecoa o atributo em sua tag de abertura, facilitando o mapeamento da resposta à <rpc-reply> solicitação de iniciação. A especificação NETCONF especifica o nome message-id desse atributo.
Embora as solicitações operacionais e de configuração pertençam a classes diferentes, uma sessão netconf não tem modos distintos que correspondem aos modos de operação e configuração de CLI. Cada elemento de tags de solicitação está incluído em sua própria etiqueta, para que uma aplicação do cliente possa alternar livremente <rpc> solicitações operacionais e de configuração. Uma aplicação do cliente pode fazer três classes 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 do modo operacional Junos OS CLI. A API Junos XML define um elemento de tags de solicitação para muitos comandos CLI. Por exemplo, o elemento de tags corresponde ao comando, e <get-interface-information> o elemento tag solicita as mesmas informações do show interfaces <get-chassis-inventory> show chassis hardware comando.
O 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 Solicitar informações operacionais usando NETCONF. Para obter informações sobre os elementos de tags de solicitação Junos XML disponíveis na versão atual do Junos OS, consulte o Junos XML API Operational Developer Reference e o XML API Explorer.
Solicitações de informações de configuração
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 (a que está atualmente em uso ativo na plataforma de com switching, roteamento ou segurança). As configurações candidatos e comprometidas divergem quando há alterações não comprometidas na configuração do candidato.
O protocolo NETCONF define a <get-config> operação para recuperação de informações de configuração. A API Junos XML define um elemento de tags para cada instrução de contêiner e folha na hierarquia de configuração.
O exemplo a seguir mostra como solicitar informações do nível [edit system login] de hierarquia da configuração do candidato:
<rpc>
<get-config>
<source>
<candidate/>
</source>
<filter type="subtree">
<configuration>
<system>
<login/>
</system>
</configuration>
</filter>
</get-config>
</rpc>
]]>]]>
Para obter mais informações sobre solicitações de informações de configuração, consulte Dados de configuração de solicitação usando NETCONF. Para um resumo dos elementos de tags de configuração disponíveis, consulte a referência do desenvolvedor de configuração da API Junos XML e o Xml API Explorer.
Solicitações de mudança de configuração
Solicitações de mudança de configuração são solicitações para alterar a configuração ou para comprometer essas alterações para colocá-las em uso ativo no dispositivo que executa o Junos OS. O protocolo NETCONF define as e <edit-config> as operações para alterar as informações de <copy-config> configuração. A API Junos XML define um elemento de tags para cada instrução de configuração CLI descrita nas guias de configuração do Junos OS.
O exemplo a seguir mostra como criar uma nova conta de usuário do Junos OS chamada em nível de hierarquia admin [edit system login] na configuração do candidato:
<rpc>
<edit-config>
<target>
<candidate/>
</target>
<config>
<configuration>
<system>
<login>
<user>
<name>admin</name>
<full-name>Administrator</full-name>
<class>superuser</class>
</user>
</login>
<login/>
</system>
</configuration>
</config>
</edit-config>
</rpc>
]]>]]>
Para obter mais informações sobre solicitações de mudança de configuração, consulte Editar a configuração usando NETCONF. Para ver um resumo dos elementos de tags de configuração Junos XML, consulte a referência do desenvolvedor de configuração da API Junos XML e o Xml API Explorer.