Solicite subconjuntos de objetos de configuração usando expressões regulares
Em uma sessão de protocolo Junos XML com um dispositivo que executa o Junos OS, para solicitar informações apenas sobre essas instâncias de um tipo de objeto de configuração que tenham um conjunto especificado de caracteres em seus nomes de identificador, um aplicativo do cliente inclui o matching atributo com uma expressão regular que corresponda ao nome do identificador. Por exemplo, o aplicativo pode solicitar informações sobre apenas as interfaces SONET/SDH no nível de [edit interfaces] hierarquia, especificando os caracteres assim, no início da expressão regular.
O uso do matching atributo permite que o aplicativo represente os objetos para retornar em uma forma semelhante à representação XML Path Language (XPath), que é descrita na XML Path Language (XPath) Versão 1.0, disponível no World Wide Web Consortium (W3C) em http://www.w3.org/TR/xpath . Em uma representação XPath, um objeto e seus níveis-mãe são uma série ordenada de nomes de elementos de tag separados por cortes avançados. Os suportes de ângulo em torno de nomes de elementos de tag são omitidos, e a tag de abertura é usada para representar todo o elemento de tag. Por exemplo, o seguinte XPath:
configuration/system/radius-server/name
equivale à seguinte representação com tags:
<configuration>
<system>
<radius-server>
<name/>
</radius-server>
</system>
</configuration>
O aplicativo inclui o matching atributo na tag vazia que representa um nível pai para o tipo de objeto. Como acontece com todas as solicitações de informações de configuração, o cliente emite um <get-configuration> elemento de tag que inclui os elementos de tag que representam todos os níveis da hierarquia de configuração da raiz (representado pelo <configuration> elemento tag) até o nível em que o matching atributo está incluído. Toda a solicitação está fechada em um <rpc> elemento de tag:
<rpc>
<get-configuration>
<configuration>
<!-- opening tags for each parent of the level -->
<level matching="matching-expression"/>
<!-- closing tags for each parent of the level -->
</configuration>
</get-configuration>
</rpc>
No valor do matching atributo, cada nível na representação semelhante ao XPath pode ser um nome de nível completo ou uma expressão regular que corresponda ao nome identificador de uma ou mais instâncias de um tipo de objeto:
object-type[name='regular-expression']"
A expressão regular usa a notação definida no PADRÃO POSIX 1003.2 para expressões regulares do UNIX estendidas (modernas). Explicar a sintaxe de expressão regular está além do escopo deste documento, mas a Tabela 1 especifica quais caracteres ou caracteres são combinados por alguns dos operadores de expressão regulares que podem ser usados na expressão. Nas descrições, o termo refere-se a um único caractere alfanumérico ou a um conjunto de caracteres fechados em parênteses quadrados, parênteses ou aparelhos.
O matching atributo não é sensível ao caso.
Operador |
Corresponde |
|---|---|
|
Uma instância de qualquer caractere, exceto o espaço. |
|
Zero ou mais instâncias do termo imediatamente anterior. |
|
Uma ou mais instâncias do termo imediatamente anterior. |
|
Zero ou uma instância do termo imediatamente anterior. |
|
Um dos termos que aparecem em ambos os lados do operador de tubulação. |
|
O início de uma linha, quando o caret aparece fora de parênteses quadrados. Uma instância de qualquer personagem que não o acompanha dentro de parênteses quadrados, quando o caret é o primeiro caractere dentro de parênteses quadrados. |
|
O fim da linha. |
|
Uma instância de um dos caracteres alfanuméricos fechados. Para indicar uma variedade de caracteres, use um hífen (-) para separar os caracteres de início e final da gama. Por exemplo, |
|
Uma instância do valor avaliado do termo fechado. Parênteses são usados para indicar a ordem de avaliação na expressão regular. |
Quando o aplicativo solicita a saída com tags Junos XML (o padrão), o servidor de protocolo Junos XML devolva o objeto <configuration> solicitado e <rpc-reply> os elementos de tag. Para obter informações sobre os atributos na tag de abertura <configuration> , consulte Especifique a fonte para solicitações de informações de configuração em uma sessão de protocolo Junos XML.
<rpc-reply xmlns:junos="URL">
<configuration attributes>
<!-- opening tags for each parent of the parent level -->
<parent-level>
<first-matching-object>
<!-- child tag elements for the first object -->
</first-matching-object>
<second-matching-object>
<!-- child tag elements for the second object -->
</second-matching-object>
<!-- additional instances of the object -->
</parent-level>
<!-- closing tags for each parent of the object type -->
</configuration>
</rpc-reply>
O aplicativo pode combinar um ou mais atributoscountstart, e recurse atributos, juntamente com o matching atributo, para limitar o conjunto de possíveis correspondências a uma gama específica de objetos, para solicitar apenas identificadores ou ambos. Para obter mais informações sobre esses atributos, consulte Solicitando um número específico de objetos de configuração usando o protocolo Junos XML e solicitando identificadores para objetos de configuração de um tipo específico usando o protocolo Junos XML.
Para especificar a origem da saída (candidato ou configuração ativa) e solicitar formatação especial da saída (por exemplo, ASCII ou JSON formatados ou um indicador para identificadores), o aplicativo pode incluir atributos na tag de abertura <get-configuration> , sua tag de abertura <junoscript> ou ambos. Para obter mais informações, veja Especificando a fonte para solicitações de informações de configuração em uma sessão de protocolo Junos XML e especificando o formato de saída para dados de configuração em uma sessão de protocolo Junos XML.
O aplicativo pode solicitar elementos de configuração adicionais dos mesmos ou outros tipos no mesmo <get-configuration> elemento de tag, incluindo os elementos de tag apropriados. Para obter mais informações, veja solicitação de vários elementos de configuração usando o protocolo Junos XML.
O exemplo a seguir mostra como solicitar apenas o identificador para as duas primeiras interfaces SONET/SDH configuradas no nível de [edit interfaces] hierarquia.
