Junos XML 프로토콜을 사용하여 구성 데이터 요청
라우팅, 스위칭 또는 보안 플랫폼에 대한 구성 데이터를 요청하기 위해 Junos OS를 실행하는 장치가 있는 Junos XML 프로토콜 세션에서 클라이언트 애플리케이션은 태그에 <rpc> 요소를 동봉합니다<get-configuration>. 옵션 속성을 설정함으로써 클라이언트 애플리케이션은 Junos XML 프로토콜 서버가 반환하는 구성 정보의 소스 및 형식을 지정할 수 있습니다. 적절한 하위 태그 요소 옵션을 포함함으로써 애플리케이션은 구성의 전체 구성 또는 특정 부분을 요청할 수 있습니다. 기본 구문은 다음과 같습니다.
<rpc>
<!-- If requesting the complete configuration -->
<get-configuration [optional attributes]/>
<!-- If requesting part of the configuration -->
<get-configuration [optional attributes]>
<configuration>
<!-- tag elements representing the data to return -->
</configuration>
</get-configuration>
</rpc>
임시 구성 데이터베이스의 특정 인스턴스에서 구성 데이터를 보려면 클라이언트 애플리케이션은 요청을 실행하기 전에 해당 하위 태그가 있는 작업을 사용하여 <open-configuration> 임시 인스턴스를 <get-configuration> 열어야 합니다.
Junos OS Release 13.1부터 Junos XML 프로토콜 세션 내에서 논리적 시스템 사용자는 Junos XML 프로토콜 <get-configuration> 작업을 사용하여 하위 구성 태그를 사용하는 특정 논리적 시스템 구성 계층을 요청하고 전체 논리적 시스템 구성을 요청할 수 있습니다. 전체 논리적 시스템 구성을 요청할 때 RPC 응답에는 루트 태그가 <configuration> 포함됩니다. Junos OS 릴리스 13.1 <configuration> 이전에 루트 태그는 생략되었습니다.
Junos XML 프로토콜 서버는 응답 응답을 태그 요소에 <rpc-reply> 동봉합니다. 컨피규레이션이 junos: 마지막으로 변경되거나 커밋된 시기와 커밋한 사용자(속성은 가용성을 위해 구문문의 여러 줄에 표시)를 나타내는 첫 <configuration> 태그의 접두사 속성이 포함됩니다. 속성에 대한 자세한 내용은 Junos XML 프로토콜 세션에서 구성 정보 요청의 소스 지정을 참조하십시오.
<rpc-reply xmlns:junos="URL">
<!-- If the application requests Junos XML tag elements -->
<configuration junos:(changed | commit)-seconds="seconds" \
junos:(changed | commit)-localtime="YYYY-MM-DD hh:mm:ss TZ" \
[junos:commit-user="username"]>
<!-- Junos XML tag elements representing configuration elements -->
</configuration>
<!-- If the application requests formatted ASCII text -->
<configuration-text>
<!-- formatted ASCII configuration statements -->
</configuration-text>
<!-- If the application requests configuration mode set commands -->
<configuration-set>
<!-- configuration mode commands -->
</configuration-set>
<!-- If the application requests JSON format -->
<configuration-json>
<!-- JSON configuration data -->
</configuration-json>
</rpc-reply>
Junos XML 태그 요소가 태그 요소 내에서 <undocumented> 반환되는 경우, 해당 구성 요소는 Junos OS 구성 가이드에 문서화되거나 주니퍼 네트웍스가 공식적으로 지원하지 않습니다. 대부분 동봉된 요소는 지원 인력에 의해서만 디버깅하는 데 사용됩니다. 소수의 경우에서 요소가 더 이상 지원되지 않거나 구성 계층의 다른 영역으로 이동되었지만 하위 호환성을 위해 현재 위치에 나타납니다.
7비트 ASCII 문자 세트 외부의 문자가 포함된 운영 또는 구성 데이터를 표시할 때 Junos OS는 동등한 UTF-8 십진수 문자 참조를 사용하여 이 문자를 이스케이프하고 인코딩합니다. 자세한 내용은 Junos OS를 실행하는 디바이스의 문자 인코딩 이해(Understanding Character Encoding)를 참조하십시오.
, , <configuration-set><configuration-json><configuration-text>및 <undocumented> 태그 요소에 <configuration>대한 참조 페이지는 Junos XML API 운영 개발자 참조를 참조하십시오.
클라이언트 애플리케이션이 요청을 하기 전에 후보 구성을 잠가 두면 읽은 요청을 한 후에 잠금 해제해야 합니다. 다른 사용자와 애플리케이션은 잠겨 있는 동안 구성을 변경할 수 없습니다. 자세한 내용은 Junos XML 프로토콜을 사용하여 후보 구성 잠금 및 잠금 해제 또는 프라이빗 카피 생성을 참조하십시오.
다음 주제는 클라이언트 애플리케이션이 Junos XML 프로토콜 서버가 반환하는 정보의 출처, 형식 및 양을 어떻게 지정하는지 설명합니다.
또한 애플리케이션은 구성 계층의 XML 스키마 표현 또는 이전에 커밋된 구성에 대한 정보를 비롯한 다른 구성 관련 정보를 요청할 수 있습니다. 자세한 내용은 다음을 참조하십시오.