Especifique a fonte para solicitações de informações de configuração em uma sessão de protocolo Junos XML
Em uma sessão de protocolo Junos XML com um dispositivo que executa o Junos OS, um aplicativo do cliente usa o <get-configuration>
elemento tag para solicitar dados de configuração do dispositivo. Um aplicativo do cliente pode solicitar informações da configuração do candidato, da configuração ativa (ou seja, a mais recentemente comprometida no dispositivo) ou de uma instância aberta do banco de dados de configuração efêmero.
O aplicativo do cliente pode instruir o dispositivo a devolver as informações de configuração da configuração do candidato ou da configuração ativa, definindo o database
atributo ao valor apropriado. Para solicitar informações da configuração do candidato, uma aplicação do cliente inclui o <get-configuration>
elemento tag e inclui o database="candidate"
atributo ou omite completamente o atributo. O servidor de protocolo Junos XML devolve a saída marcada pelo Junos XML por padrão, exceto quando o compare
atributo está incluído.
<rpc> <get-configuration/> <!-- OR --> <get-configuration> <!-- tag elements for the configuration elements to return --> </get-configuration> </rpc>
Para solicitar informações da configuração ativa, um aplicativo do cliente inclui o <get-configuration>
elemento tag com o database="committed"
atributo fechado dentro do <rpc>
elemento.
<rpc> <get-configuration database="committed"/> <!-- OR --> <get-configuration database="committed"> <!-- tag elements for the configuration elements to return --> </get-configuration> </rpc>
Para obter informações sobre os elementos da tag, <get-configuration>
consulte Especificando o escopo dos dados de configuração para retornar em uma sessão de protocolo Junos XML.
A partir do Junos OS Release 13.1, quando um usuário do sistema lógico solicita toda a configuração lógica do sistema usando a <get-configuration>
operação, a resposta do RPC inclui a <configuration>
tag raiz. Antes do Junos OS Release 13.1, a <configuration>
tag raiz foi omitida.
Para solicitar informações de uma instância específica do banco de dados de configuração efêmero, um aplicativo do cliente primeiro abre a instância efêmera usando a <open-configuration>
operação com as etiquetas infantis apropriadas.
<rpc> <!-- Default instance --> <open-configuration> <ephemeral/> </open-configuration> <!-- Named instance --> <open-configuration> <ephemeral-instance>instance-name</ephemeral-instance> </open-configuration> </rpc>
Embora a instância efêmera esteja aberta, o aplicativo do cliente solicita informações dessa instância usando a <get-configuration>
operação. Após todas as operações na instância efêmera serem concluídas, o aplicativo do cliente encerra a instância com a <close-configuration/>
operação.
<rpc> <get-configuration/> <!-- OR --> <get-configuration> <!-- tag elements for the configuration elements to return --> </get-configuration> </rpc> <rpc> <close-configuration/> </rpc>
O servidor de protocolo Junos XML encerra sua resposta no <rpc-reply>
elemento tag. Dentro do <rpc-reply>
elemento, os dados de configuração da configuração solicitada são fechados dentro do <configuration>
elemento para saída marcada pelo Junos XML, o <configuration-text>
elemento para saída ASCII formatada, o <configuration-set>
elemento para comandos de modo set
de configuração ou o <configuration-json>
elemento para dados de configuração representados usando a Notação de objeto JavaScript (JSON).
Ao devolver informações da configuração do candidato ou de uma instância do banco de dados de configuração efêmero, a saída inclui informações sobre quando a configuração foi alterada pela última vez. Ao exibir a configuração como elementos de tag Junos XML, o servidor de protocolo Junos XML inclui essas informações como atributos na tag de abertura <configuration>
(elas aparecem em várias linhas aqui apenas para legibilidade).
<rpc-reply xmlns:junos="URL"> <configuration junos:changed-seconds="seconds" \ junos:changed-localtime="YYYY-MM-DD hh:mm:ss TZ"> <!-- Junos XML tag elements representing configuration elements --> </configuration> </rpc-reply>
junos:changed-localtime
representa a hora da última mudança como data e hora do fuso horário local do dispositivo.
junos:changed-seconds
representa o tempo da última mudança como o número de segundos desde a meia-noite de 1 de janeiro de 1970.
Ao devolver informações da configuração ativa, a saída inclui informações sobre quando a configuração foi comprometida pela última vez. Ao exibir a configuração como elementos de tag Junos XML, o servidor de protocolo Junos XML inclui essas informações como atributos na tag de abertura <configuration>
(elas aparecem em várias linhas aqui apenas para legibilidade).
<rpc-reply xmlns:junos="URL"> <configuration junos:commit-seconds="seconds" \ junos:commit-localtime="YYYY-MM-DD hh:mm:ss TZ" \ junos:commit-user="username"> <!-- Junos XML tag elements representing configuration elements --> </configuration> </rpc-reply>
junos:commit-localtime
representa o tempo de compromisso como data e hora no fuso horário local do dispositivo.
junos:commit-seconds
representa o tempo de compromisso como o número de segundos desde a meia-noite de 1 de janeiro de 1970.
junos:commit-user
especifica o nome de usuário do Junos OS do usuário que solicitou a operação de compromisso.
O database
atributo na solicitação da aplicação pode ser combinado com um ou mais dos seguintes atributos na <get-configuration/>
tag ou tag de abertura <get-configuration>
:
changed
, descrito na solicitação de indicadores de mudança para elementos de configuração usando o protocolo Junos XMLcommit-scripts
, que é descrito na solicitação de dados de configuração XML estilo commit-script usando o protocolo Junos XMLcompare
, que é descrito na comparação da configuração ativa ou de candidato com uma versão anterior usando o protocolo Junos XMLformat
, que é descrito ao especificar o formato de saída para dados de configuração em uma sessão de protocolo Junos XMLinherit
e opcionalmentegroups
einterface-ranges
, que são descritos na especificação do formato de saída para grupos de configuração e faixas de interface usando o protocolo Junos XML
A aplicação também pode incluir o database
atributo após solicitar um indicador para identificadores (conforme descrito na solicitação de indicadores de identificação para elementos de configuração usando o protocolo Junos XML).
O exemplo a seguir mostra como solicitar toda a configuração comprometida. Na saída real, a Junos-version variável é substituída por um valor como 20.4R1 para a versão inicial do Junos OS Release 20.4.
<get-configuration>
operação, a resposta do RPC inclui a
<configuration>
tag raiz.