Solicitar mudanças de configuração usando o protocolo Junos XML
Em uma sessão de protocolo Junos XML com um dispositivo que executa o Junos OS, você pode usar as operações de protocolo Junos XML junto com o Junos XML, declarações de configuração, set comandos ou dados de configuração de interface de linha de comando (CLI) para alterar a configuração em uma plataforma de roteamento, comutação ou segurança. A operação de protocolo <load-configuration> Junos XML e seus atributos oferecem funcionalidade análoga aos comandos de modo de configuração no Junos OS CLI. Os elementos de tag Junos XML descritos aqui correspondem a declarações de configuração, descritas nos guias de configuração do Junos OS.
Para alterar a configuração em um dispositivo que executa o Junos OS, o aplicativo do cliente executa os procedimentos descritos nas seções indicadas:
Estabelece uma conexão com o servidor de protocolo Junos XML na plataforma de roteamento, comutação ou segurança, conforme descrito no Connecting to the Junos XML Protocol Server.
Inicia uma sessão de protocolo Junos XML, como descrito nas sessões de protocolo Do Junos XML.
Opcionalmente, bloqueia a configuração do candidato, cria uma cópia privada da configuração do candidato ou abre uma instância do banco de dados de configuração efêmero.
Bloquear a configuração impede que outros usuários ou aplicativos a alterem ao mesmo tempo. Criar uma cópia privada permite que o aplicativo faça alterações sem afetar a configuração do candidato até que a cópia seja comprometida. 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.
Para obter informações sobre o banco de dados de configuração efêmero, consulte Entender o banco de dados de configuração efêmero e ativar e configurar instâncias do banco de dados de configuração efêmero.
Inclui o
<load-configuration>elemento tag em um<rpc>elemento de tag. Ao incluir vários atributos na<load-configuration>tag, o aplicativo pode fornecer os dados de configuração em um arquivo ou como um fluxo de tag carregado diretamente, e como elementos de tag Junos XML, texto ASCII formatado, dados formatados por JSON ou comandos de modosetde configuração do Junos OS. O aplicativo do cliente pode especificar que os dados de configuração substituem completamente a configuração do candidato existente, ou o aplicativo pode especificar a maneira como o servidor de protocolo Junos XML carrega os dados na configuração do candidato, cópia privada ou instância aberta do banco de dados de configuração efêmero. A sintaxe básica é a seguinte:<rpc> <!-- If providing configuration data in a file --> <load-configuration url="file" [optional attributes] /> <!-- If providing configuration data in a data stream --> <load-configuration [optional attributes] > <!-- configuration data --> </load-configuration> </rpc>Aceita o fluxo de tag emitido pelo servidor de protocolo Junos XML em resposta a cada solicitação e extrai seu conteúdo, como descrito na análise da resposta do servidor de protocolo Junos XML.
O servidor de protocolo Junos XML confirma que incorporou os dados de configuração devolvendo o
<load-configuration-results>elemento de tag e<load-success/>a<rpc-reply>tag no elemento tag:<rpc-reply xmlns:junos="URL"> <load-configuration-results> <load-success/> </load-configuration-results> </rpc-reply>Se a operação de carga falhar, o
<load-configuration-results>elemento de tag em vez disso inclui o<load-error-count>elemento tag, o que indica o número de erros que ocorreram. Nesse caso, o aplicativo ou um administrador devem eliminar os erros antes de cometer a configuração.<rpc-reply xmlns:junos="URL"> <load-configuration-results> <load-error-count>count</load-error-count> </load-configuration-results> </rpc-reply>(Opcional) Verifica a correção sintática da configuração do candidato ou uma cópia privada antes de tentar empenhá-la, como descrito na verificação da sintaxe de configuração usando o Protocolo Junos XML.
Confirma alterações feitas na configuração do candidato ou cópia privada, conforme descrito no Compromisso da Configuração do Candidato Usando o Protocolo Junos XML, ou comete alterações feitas em uma instância aberta do banco de dados de configuração efêmera, conforme descrito em Comprometer e sincronizar dados de configuração efêmeros usando o protocolo NETCONF ou Junos XML.
Libera a configuração do candidato se ela estiver bloqueada ou fechar uma cópia privada da configuração ou uma instância aberta do banco de dados de configuração efêmero.
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.
Termina a sessão de protocolo Junos XML e fecha a conexão com o dispositivo, como descrito em Encerrar uma sessão de protocolo Junos XML e fechar a conexão.