NESTA PÁGINA
<get-configuration>
Uso
<rpc> <get-configuration [changed="changed"] [commit-scripts="( apply | apply-no-transients | view )"] [compare=("configuration-revision" [configuration-revision="revision-id"] | "rollback" [rollback="[0-49]"])] [database="(candidate | committed)"] [database-path=$junos-context/commit-context/database-path] [format="( json | set | text | xml )"] [inherit="( defaults | inherit )" [groups="groups"] [interface-ranges="interface-ranges"]] [(junos:key | key )="key"] > <!-- tag elements for the configuration element to display --> </get-configuration> </rpc>
Descrição
Solicite dados de configuração do servidor de protocolo NETCONF ou Junos XML. Os atributos especificam a origem e a formatação dos dados para exibir.
Se um aplicativo do cliente emitir a operação de protocolo <open-configuration>
Junos XML para abrir um banco de dados de configuração específico antes de executar a <get-configuration>
operação, o servidor devolve os dados de configuração do banco de dados de configuração aberta. Caso contrário, o servidor devolve os dados de configuração da configuração do candidato, a menos que a configuração ativa seja solicitada explicitamente, incluindo o database="committed"
atributo.
Um aplicativo do cliente pode solicitar toda a hierarquia de configuração ou um subconjunto dela.
Para exibir toda a hierarquia de configuração, emite a tag vazia
<get-configuration/>
.Para exibir um elemento de configuração (nível de hierarquia ou objeto de configuração), emite elementos de tag dentro do
<get-configuration>
elemento tag para representar todos os níveis da hierarquia de configuração desde a raiz (representada pelo<configuration>
elemento de tag) até o nível ou objeto a ser exibido. Para representar um nível de hierarquia ou um objeto de configuração que não tenha um identificador, emite-o como uma tag vazia. Para representar um objeto que tenha um ou mais identificadores, emite seu elemento de tag de contêiner e identifique apenas elementos de tag, não quaisquer elementos de tag que representem outras características.
Para recuperar dados de configuração de uma instância do banco de dados de configuração efêmero, um aplicativo do cliente deve primeiro abrir a instância efêmera usando a <open-configuration>
operação com as tags infantis apropriadas antes de emitir a <get-configuration>
operação. Ao recuperar dados de configuração efêmeros usando a <get-configuration>
operação, os únicos atributos suportados são format
e key
.
A partir do Junos OS Release 13.1, dentro de uma sessão de protocolo NETCONF ou Junos XML, um usuário de sistema lógico pode usar a operação Junos XML <get-configuration>
para solicitar hierarquias específicas de configuração de sistema lógico 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 é omitida.
Atributos
changed |
Especifique que o O atributo aparece na tag de abertura de cada elemento de tag dos pais no caminho até o elemento de configuração alterado, incluindo a tag de abertura O
Um exemplo de aviso de tempo de compromisso é a mensagem explicando que um elemento de configuração não será efetivamente aplicado até que o dispositivo seja reiniciado. O aviso aparece na seqüência de tags que o servidor retorna para confirmar o sucesso do commit, fechado em um Para remover o |
commit-scripts |
Solicite que o servidor de protocolo NETCONF ou Junos XML exibir dados XML no estilo de script de compromisso. O valor do atributo determina a saída. Valores aceitáveis são:
|
compare |
Solicite que o servidor de protocolo NETCONF ou Junos XML exerça as diferenças entre a configuração ativa ou de candidato e uma configuração previamente comprometida (a configuração de comparação). O O
Se você incluir o Quando você compara a configuração do candidato com a configuração ativa, a operação retorna a
Nota:
A partir do Junos OS Release 16.2R2, quando você compara as configurações ativas e candidatas e exibe as diferenças no formato XML ou JSON, o dispositivo omite a |
database |
Especifique a configuração a partir da qual exibir dados como um dos seguintes:
O |
database-path |
Em um script de compromisso, este atributo especifica o caminho para a configuração do candidato pré-herança da sessão. O único valor aceitável é Para sessões de configuração normais, o script de compromisso recupera a configuração normal do candidato pré-herança. Para sessões de configuração privadas, o script de compromisso recupera a configuração privada do candidato pré-herança. Se você incluir os atributos e os |
format |
Especifique o formato em que o servidor de protocolo NETCONF ou Junos XML devolve os dados de configuração. Valores aceitáveis são:
Nota:
A partir do Junos OS Release 21.1R1 e do Junos OS Evolved Release 22.3R1, as sessões do NETCONF oferecem suporte adicional aos |
groups |
Especifique que o O único valor aceitável para o |
inherit |
Especifique como o servidor de protocolo NETCONF ou Junos XML exibe declarações definidas em grupos de configuração e faixas de interface. Se o Os valores aceitáveis são:
|
interface-ranges |
Especifique que o O único valor aceitável para o |
junos:key | key |
Especifique que o |
Informações de lançamento
Esta é uma operação de protocolo de gerenciamento Junos XML. Ele é suportado em sessões de protocolo Junos XML, e é suportado como uma extensão proprietária da Juniper Networks em sessões NETCONF em dispositivos que executam o Junos OS que identificam o URI http://xml.juniper.net/netconf/junos/1.0 na troca de recursos.
interface-ranges
atributo adicionado no Junos OS Release 10.3R1.
commit-scripts
valores de atributo e apply-no-transients
adicionados apply
no Junos OS Release 12.1
database-path
atributo adicionado no Junos OS Release 12.2.
format
valor json
agregado no Junos OS Release 14.2.
format
valor set
agregado no Junos OS Release 15.1.
A partir do Junos OS Release 16.1, os dispositivos que executam o Junos OS emitem dados de configuração em formato JSON usando uma nova implementação padrão para serialização.
A partir das versões Junos OS 16.1R4, 16.2R2 e 17.1R1, os inteiros dos dados de configuração do Junos OS emitidos no formato JSON não estão incluídos nas cotações.
compare
valor configuration-revision
agregado no Junos OS Release 20.4R1 e Junos OS Evolved Release 20.4R1.
format
valores de atributo e xml-minified
adicionados json-minified
para sessões NETCONF apenas no Junos OS Release 21.1R1 e Junos OS Evolved Release 22.3R1.