Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

<load-configuration>

Uso

Descrição

Solicite que os dados de configuração de carga do servidor de protocolo NETCONF ou Junos XML entrem na configuração do candidato ou no banco de dados de configuração aberta.

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 <load-configuration> operação, o servidor carregará os dados de configuração no banco de dados de configuração aberta. Caso contrário, o servidor carrega os dados de configuração na configuração do candidato.

Forneça os dados para carregar de uma das seguintes maneiras:

  • Defina o atributo da tag vazia <load-configuration/> ao identificador de configuration-revision revisão de configuração de uma configuração previamente comprometida. A configuração especificada substitui completamente a configuração do candidato.

  • Defina o atributo da tag vazia <load-configuration/> ao valorrescue.rescue A configuração de resgate substitui completamente a configuração do candidato.

  • Defina o atributo da rollback tag vazia <load-configuration/> ao índice de reversão de uma configuração previamente comprometida. O dispositivo armazena uma cópia da configuração mais recentemente comprometida e até 49 configurações anteriores. A configuração especificada substitui completamente a configuração do candidato.

  • Defina o atributo da url tag vazia <load-configuration/> ao nome de caminho de um arquivo que contém os dados de configuração a carregar. Defina o format atributo ajson, textou xml carregue uma configuração no respectivo formato-JavaScript Object Notation (JSON), texto ASCII formatado ou elementos de tag Junos XML (o padrão). Para fornecer os dados de configuração como comandos de modo de configuração, inclua o action="set" atributo e omite o format atributo ou defina o valor para text.

    No exemplo a seguir, o url atributo identifica que os dados de configuração devem ser carregados do arquivo /tmp/add.conf .

  • Inclua os dados de configuração como um fluxo de dados dentro de uma tag de abertura <load-configuration> e fechamento </load-configuration> . Se fornecer os dados de configuração como texto ASCII formatado, inclua os dados em um <configuration-text> elemento de tag e defina o format atributo para text. Se fornecer os dados de configuração como elementos de tag Junos XML, inclua os dados em um <configuration> elemento de tag e omite o format atributo ou defina o valor para xml. Se fornecer os dados de configuração como comandos de modo de configuração, inclua os dados em um <configuration-set> elemento de tag, defina o action atributo sete omite o format atributo ou defina o valor para text. Se fornecer os dados de configuração no JSON, inclua os dados em um <configuration-json> elemento de tag e defina o format atributo para json.

Atributos

action

Especifique como carregar os dados de configuração, especialmente quando o banco de dados de configuração de alvo e a configuração carregada contêm declarações conflitantes.

O banco de dados de configuração efêmero oferece suporte aos seguintes action valores de atributo em dispositivos suportados nas versões especificadas:

  • merge e set— suportado no Junos OS Release 16.2R2 e posterior

  • override e replace— suportado no Junos OS Release 18.1R1 e posterior

  • update— suportado no Junos OS Release 21.1R1 e posterior

A seguir, valores aceitáveis:

  • merge— Combine os dados na configuração carregada com os dados na configuração alvo. Se as declarações na configuração carregada entrarem em conflito com as declarações na configuração de alvo, as declarações carregadas substituirão as da configuração alvo. Esse é o comportamento padrão se o action atributo for omitido.

  • override— Descarte toda a configuração do candidato e substitua-a pela configuração carregada. Quando a configuração é mais tarde comprometida, todos os processos do sistema analisam a nova configuração.

  • replace— Substitua cada nível de hierarquia ou objeto de configuração definido na configuração carregada para o nível ou objeto correspondente na configuração do candidato.

    Se fornecer os dados de configuração como texto ASCII formatado (seja no arquivo nomeado pelo url atributo ou fechado em um <configuration-text> elemento de tag), também coloque a replace: declaração na linha que precede diretamente as declarações que representam o nível de hierarquia ou o objeto a ser substituído. Para obter mais informações, consulte a discussão sobre o carregamento de um arquivo de dados de configuração no Guia do Usuário da CLI.

    Se fornecer os dados de configuração como elementos de tag Junos XML, inclua o replace="replace" atributo nas tags de abertura dos elementos que representam os níveis de hierarquia ou objetos a substituir.

  • set— Dados de configuração de carga formatados como comandos de modo de configuração do Junos OS. Essa opção executa as instruções de configuração linha por linha conforme elas são armazenadas em um arquivo nomeado pelo url atributo ou fechado em um <configuration-set> elemento de tag. As instruções podem conter qualquer comando de modo de configuração, comoset, delete, ou deactivateedit. Ao fornecer os dados de configuração como um conjunto de comandos, o único valor aceitável para o atributo é "formattexto". Se o valor do action atributo for "definido", e o format atributo for omitido, o format atributo será automaticamente padrão para "texto" em vez de xml.

  • update— Compare uma configuração completa carregada com a configuração do candidato. Para cada nível de hierarquia ou objeto de configuração diferente nas duas configurações, a versão na configuração carregada substitui a versão na configuração do candidato. Quando a configuração é mais tarde comprometida, apenas processos de sistema afetados pelos elementos de configuração alterados analisam a nova configuração.

configuration-revision

Carregue uma configuração previamente comprometida fazendo referência ao identificador de revisão de configuração. A configuração especificada substitui completamente a configuração do candidato.

format

Especifique o formato usado para os dados de configuração. Valores aceitáveis são:

  • json—Indique que os dados de configuração sejam formatados usando a Notação de Objetos JavaScript (JSON).

  • text— Indique que os dados de configuração sejam formatados como texto ASCII ou como um conjunto de comandos de modo de configuração.

    O formato de texto ASCII usa 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 na plataforma de roteamento e é o formato exibido pelo comando CLI show configuration . O set formato de comando consiste em uma série de comandos de modo de configuração do Junos OS e é exibido pelo show configuration | display set comando CLI. Para carregar um conjunto de comandos de modo de configuração, você deve definir o action atributo para "definir".

  • xml— Indique que os dados de configuração sejam formatados usando elementos de tag Junos XML. Se o format atributo for omitido, "xml" é o formato padrão para todos os valores do action atributo, exceto "set", que padrão para formatar "texto".

rescue

Especifique que a configuração de resgate substitua a configuração atual do candidato. O único valor válido é "resgate".

Nota:

A partir do Junos OS Release 18.1R1, você também pode usar o <rollback-config> RPC para carregar uma configuração previamente comprometida, o que é útil para aplicativos que não suportam a execução de RPCs que incluem atributos XML.

rollback

Carregue uma configuração previamente comprometida fazendo referência ao seu índice de reversão numérico. Os valores válidos são 0 (zero, para a configuração mais recentemente comprometida) por meio de um a menos do que o número de configurações anteriores armazenadas (o máximo é 49).

Nota:

A partir do Junos OS Release 18.1R1, você também pode usar o <rollback-config> RPC para carregar uma configuração previamente comprometida, o que é útil para aplicativos que não suportam a execução de RPCs que incluem atributos XML.

url

Especifique o nome completo do arquivo que contém os dados de configuração a carregar. O valor pode ser um caminho de arquivo local, uma localização FTP ou um URL do Hypertext Transfer Protocol (HTTP):

  • Um nome de arquivo local pode ter um dos seguintes formulários:

    • /path/filename— Arquivo em um sistema de arquivo montado, seja no disco flash local ou em disco rígido.

    • Um:filename ou a:path/filename— Arquivo na unidade local. O caminho padrão é / (o diretório de nível raiz). A mídia removível pode estar no formato MS-DOS ou UNIX (UFS).

  • Um nome de arquivo em um servidor FTP tem o seguinte formulário:

  • Um nome de arquivo em um servidor HTTP tem o seguinte formulário:

Em cada caso, o valor padrão para a path variável é o diretório homel para o nome do usuário. Para especificar um caminho absoluto, a aplicação inicia o caminho com os caracteres %2F; por exemplo, ftp://username:password@hostname/%2Fpath/filename.

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.

action valor set agregado no Junos OS Release 11.4.

format valor json agregado no Junos OS Release 16.1.

configuration-revision atributo adicionado no Junos OS Release 20.4R1 e Junos OS Evolved Release 20.4R1.