Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

<get-configuration>

Uso

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.

Nota:

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.

Nota:

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 junos:changed="changed" atributo deve aparecer na tag de abertura de cada elemento de configuração alterado.

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 <configuration> de nível superior. Se o elemento de configuração alterado for representado por uma única tag (vazia), o junos:changed="changed" atributo aparece na tag. Se o elemento alterado for representado por um elemento de tag de contêiner, o junos:changed="changed" atributo aparece na tag de contêiner de abertura e também em cada elemento de tag infantil fechado no elemento de tag do contêiner.

O database atributo pode ser combinado com o changed="changed" atributo de solicitar o candidato ou a configuração ativa:

  • Quando a configuração do candidato é solicitada (o database="candidate" atributo está incluído ou o database atributo é omitido completamente), elementos adicionados à configuração do candidato após a última operação de compromisso são marcados com o junos:changed="changed" atributo.

  • Quando a configuração ativa é solicitada (o database="committed" atributo está incluído), os elementos adicionados à configuração ativa pelo compromisso mais recente são marcados com o junos:changed="changed" atributo.

    Nota:

    Quando uma operação de compromisso é bem sucedida, o servidor remove o junos:changed="changed" atributo de todos os elementos de tag. No entanto, se os avisos forem gerados durante o commit, o atributo não será removido. Nesse caso, o junos:changed="changed" atributo aparece em elementos de tag que mudaram antes da operação de compromisso, bem como naqueles que mudaram depois dela.

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 <xnm:warning> elemento de tag.

Para remover o junos:changed="changed" atributo de elementos que mudaram antes do compromisso, tome as medidas necessárias para eliminar a causa do aviso e cometa a configuração novamente.

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:

  • apply— Exibir a configuração com alterações de script de compromisso aplicadas, incluindo alterações transitórias e não transitórias. A saída é equivalente à saída de CLI ao usar a opção | display commit-scripts .

  • apply-no-transients— Exibir a configuração com alterações de script de compromisso aplicadas, mas excluir alterações transitórias. A saída é equivalente à saída de CLI ao usar a opção | display commit-scripts no-transients .

  • view— Exibir a configuração no formato XML que é a entrada para um script de compromisso. Isso é equivalente à visualização da configuração com os atributos inherit="inherit"echanged="changed"groups="groups". A saída é equivalente à saída de CLI ao usar a opção| display commit-scripts view.

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 compare atributo pode ser combinado com o database atributo para indicar se a configuração do candidato ou a configuração ativa são comparadas à configuração previamente comprometida. Se você omitir o database atributo, a comparação usa a configuração do candidato.

O compare atributo aceita os seguintes valores, que indicam o método usado para fazer referência à configuração de comparação:

  • configuration-revision— Faça referência à configuração de comparação por sua cadeia de identificador de revisão de configuração, que você define no configuration-revision="revision-id" atributo.

  • rollback— Faça referência à configuração de comparação pelo índice de reversão, que você define no rollback="rollback-number" atributo.

Se você incluir o compare atributo, mas omitir o correspondente configuration-revision ou rollback atributo ou fornecer um identificador de revisão de configuração inválido, o servidor usa a configuração mais recentemente comprometida como configuração de comparação.

Quando você compara a configuração do candidato com a configuração ativa, a operação retorna a compare saída XML. Para todas as outras comparações, ele retorna a saída como texto usando um formato de patch. Quando você compara a configuração do candidato com a configuração ativa, você pode exibir as diferenças no formato de texto, XML ou JSON, incluindo o valor apropriado para o format atributo na solicitação. Você pode exibir as diferenças no formato XML a partir do Junos OS Release 15.1R1, e você pode exibir as diferenças no formato JSON a partir do Junos OS Release 16.1R1.

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 <configuration> tag na saída XML e omite o configuration objeto na saída JSON se a comparação não retornar diferenças ou se a comparação devolver diferenças para apenas dados de configuração não nativos, por exemplo, dados de configuração associados a um modelo de dados OpenConfig.

database

Especifique a configuração a partir da qual exibir dados como um dos seguintes:

  • candidate— A configuração do candidato.

  • committed— A configuração ativa (a mais recentemente comprometida).

O database atributo tem precedência sobre o database-path atributo, se ambos estiverem incluídos.

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 é $junos-context/commit-context/database-path.

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 database database-path atributos, o database atributo terá precedência.

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:

  • json— As declarações de configuração são formatadas usando o JavaScript Object Notation (JSON). 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.

    Nota:

    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. Em versões anteriores, os inteiros dos dados de configuração JSON foram tratados como strings e fechados entre aspas.

  • set— As declarações de configuração são formatadas como comandos de modo set de configuração do Junos OS.

  • text— As declarações de configuração são formatadas como texto ASCII, usando o novo caráter, guias e outros espaços brancos, aparelhos e suportes quadrados para indicar as relações hierárquicas entre as declarações. Este é o formato usado em arquivos de configuração armazenados em um dispositivo que executa o Junos OS e exibido pelo comando CLI show configuration .

  • xml— As declarações de configuração são representadas pelos elementos de tag Junos XML correspondentes. Esse é o valor padrão se o format atributo for omitido.

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 json-minified formatos e xml-minified aos formatos, que devolvem o respectivo formato com espaços, guias e novas linhas desnecessários removidos.

groups

Especifique que o junos:group="group-name" atributo aparece na tag de abertura para cada elemento de configuração herdado de um grupo de configuração. A group-name variável especifica o nome do grupo de configuração do qual esse elemento foi herdado.

O único valor aceitável para o groups atributo é groups. Quando você especifica o groups atributo, você também deve especificar o inherit atributo.

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 inherit atributo for omitido, a saída usa os <groups>elementos , <apply-groups>e <apply-groups-except> marca para representar grupos de configuração definidos pelo usuário e usa o <interface-range> elemento tag para representar faixas de interface definidas pelo usuário; ele não inclui elementos de tag para declarações definidas no grupo junos-defaults.

Os valores aceitáveis são:

  • defaults— A saída não inclui os <groups>elementos , <apply-groups>e <apply-groups-except> a tag, mas sim exibir elementos de tag herdados de grupos definidos pelo usuário e do grupo junos-defaults como filhos dos elementos de tag herdados.

  • inherit— A saída não inclui os <groups>elementos , <apply-groups-except><apply-groups>e <interface-range> tag, mas sim exibir elementos de tag que são herdados de grupos definidos pelo usuário e faixas como filhos dos elementos de tag herdados. A saída não inclui elementos de tag para declarações definidas no grupo junos-defaults.

interface-ranges

Especifique que o junos:interface-ranges="source-interface-range" atributo aparece na tag de abertura para cada elemento de configuração herdado de uma faixa de interface. A source-interface-range variável especifica o nome da faixa de interface.

O único valor aceitável para o interface-ranges atributo é interface-ranges. Quando você especifica o interface-ranges atributo, você também deve especificar o inherit atributo.

junos:key | key

Especifique que o junos:key="key" atributo aparece na tag de abertura de cada elemento que serve como um identificador para um objeto de configuração. O único valor aceitável é key.

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-scriptsvalores 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.

formatvalores 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.