Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

<get-configuration>

사용

설명

NETCONF 또는 Junos XML 프로토콜 서버에서 구성 데이터를 요청합니다. 속성은 표시할 데이터의 소스와 형식을 지정합니다.

클라이언트 애플리케이션이 작업을 실행 <get-configuration> 하기 전에 특정 구성 데이터베이스를 열기 위해 Junos XML 프로토콜 <open-configuration> 작업을 실행하는 경우 서버는 개방형 구성 데이터베이스에서 구성 데이터를 반환합니다. 그렇지 않으면 서버는 속성을 포함하여 database="committed" 활성 구성이 명시적으로 요청되지 않는 한 후보 구성에서 구성 데이터를 반환합니다.

클라이언트 애플리케이션은 전체 구성 계층 또는 하위 집합을 요청할 수 있습니다.

  • 전체 구성 계층을 표시하려면 빈 <get-configuration/> 태그를 내보내야 합니다.

  • 구성 요소(계층 수준 또는 구성 객체)를 표시하려면 태그 요소 내에서 <get-configuration> 태그 요소를 방출하여 루트(태그 요소로 <configuration> 표현)에서 표시할 수준 또는 객체까지 구성 계층의 모든 수준을 나타냅니다. 식별자가 없는 계층 수준 또는 구성 객체를 나타내려면 빈 태그로 내모십시오. 하나 이상의 식별자가 있는 객체를 표현하려면 다른 특성을 나타내는 태그 요소가 아니라 컨테이너 태그 요소 및 식별자 태그 요소만 발신합니다.

참고:

임시 구성 데이터베이스의 인스턴스에서 구성 데이터를 검색하려면 클라이언트 애플리케이션이 먼저 작업을 내보내기 전에 해당 자식 태그와 함께 작업을 사용하여 <open-configuration> 임시 인스턴스를 <get-configuration> 열어야 합니다. 작업을 사용하여 <get-configuration> 임시 구성 데이터를 검색할 때 지원되는 속성은 format key

참고:

Junos OS Release 13.1부터 NETCONF 또는 Junos XML 프로토콜 세션 내에서 논리적 시스템 사용자는 Junos XML <get-configuration> 작업을 사용하여 하위 구성 태그를 사용하는 특정 논리적 시스템 구성 계층을 요청하고 전체 논리적 시스템 구성을 요청할 수 있습니다. 전체 논리적 시스템 구성을 요청할 때 RPC 응답에는 루트 태그가 <configuration> 포함됩니다. Junos OS 릴리스 13.1 <configuration> 이전에 루트 태그는 생략됩니다.

특성

changed

junos:changed="changed" 변경된 각 구성 요소의 오프닝 태그에 속성이 나타나야 한다고 지정합니다.

속성은 최상위 오프닝 태그를 포함하여 변경된 구성 요소로 향하는 경로의 모든 상위 태그 요소의 오프닝 <configuration> 태그에 나타납니다. 변경된 구성 요소가 단일(빈) 태그로 표현되면 속성이 junos:changed="changed" 태그에 나타납니다. 변경된 요소가 컨테이너 태그 요소로 표현되는 경우, junos:changed="changed" 속성은 오프닝 컨테이너 태그와 컨테이너 태그 요소에 동봉된 각 자식 태그 요소에도 나타납니다.

속성은 database 후보 또는 활성 구성을 요청하는 속성과 changed="changed" 결합될 수 있습니다.

  • 후보 구성이 요청되면( database="candidate" 속성이 포함되거나 database 속성이 완전히 생략됨), 마지막 커밋 작업이 속성으로 표시된 후 후보 구성에 junos:changed="changed" 추가된 요소.

  • 활성 구성이 요청되면( database="committed" 속성이 포함됨), 가장 최근의 커밋이 활성 구성에 추가된 요소는 해당 속성으로 junos:changed="changed" 표시됩니다.

    참고:

    커밋 작업이 성공하면 서버는 모든 태그 요소에서 속성을 제거합니다 junos:changed="changed" . 그러나 커밋 중에 경고가 생성되면 속성은 제거되지 않습니다. 이 경우 속성은 junos:changed="changed" 커밋 작업 전에 변경된 태그 요소와 커밋 이후 변경된 요소에 나타납니다.

커밋 시간 경고의 예는 장비가 재부팅될 때까지 구성 요소가 실제로 적용되지 않음을 설명하는 메시지입니다. 경고는 태그 문자열에 나타나고 서버는 태그 요소에 동봉된 <xnm:warning> 커밋의 성공을 확인합니다.

커밋 전에 변경된 요소에서 속성을 제거 junos:changed="changed" 하려면 경고의 원인을 제거하는 데 필요한 조치를 취하고 구성을 다시 커밋합니다.

commit-scripts

NETCONF 또는 Junos XML 프로토콜 서버가 커밋 스크립트 스타일의 XML 데이터를 표시할 것을 요청합니다. 속성 값이 출력을 결정합니다. 수용 가능한 값은 다음과 같습니다.

  • apply—임시 및 비-임시 변경 모두를 포함하여 커밋 스크립트 변경이 적용된 구성을 표시합니다. 이 출력은 옵션을 사용할 때 CLI 출력에 해당합니다 | display commit-scripts .

  • apply-no-transients—커밋 스크립트 변경이 적용된 상태로 구성을 표시하지만 임시 변경은 제외합니다. 이 출력은 옵션을 사용할 때 CLI 출력에 해당합니다 | display commit-scripts no-transients .

  • view—커밋 스크립트에 입력된 XML 형식으로 구성을 표시합니다. 이는 속성 inherit="inherit", groups="groups"및 를 사용하여 구성을 보는 것과 changed="changed"같습니다. 이 출력은 옵션을 사용할 때 CLI 출력에 해당합니다 | display commit-scripts view .

compare

NETCONF 또는 Junos XML 프로토콜 서버가 활성 또는 후보 구성과 이전에 커밋된 구성(비교 구성) 간의 차이점을 표시할 것을 요청합니다.

속성은 compare 속성과 database 결합되어 후보 구성 또는 활성 구성이 이전에 커밋된 구성과 비교되는지 여부를 나타낼 수 있습니다. 속성을 생략 database 하면 비교에서 후보 구성을 사용합니다.

속성은 compare 비교 구성을 참조하는 데 사용되는 방법을 나타내는 다음 값을 받습니다.

  • configuration-revision—속성에서 정의한 구성 수정판 식별자 문자열로 비교 구성을 configuration-revision="revision-id" 참조합니다.

  • rollback—속성에서 정의한 롤백 인덱스로 비교 구성을 rollback="rollback-number" 참조합니다.

속성을 포함 compare 하지만 해당 configuration-revision 또는 속성을 생략하거나 rollback 잘못된 구성 수정 식별자를 제공하는 경우 서버는 가장 최근에 커밋된 구성을 비교 구성으로 사용합니다.

후보 구성과 활성 구성을 비교하면 작업이 XML 출력을 compare 반환합니다. 다른 모든 비교에서는 패치 형식을 사용하여 출력을 텍스트로 반환합니다. 후보 구성을 활성 구성과 비교하면 요청에 속성에 적합한 값을 포함하여 텍스트, XML 또는 JSON 형식의 차이점을 format 표시할 수 있습니다. Junos OS 릴리스 15.1R1부터 XML 형식으로 차이점을 표시하고 Junos OS 릴리스 16.1R1부터 JSON 형식으로 차이점을 표시할 수 있습니다.

참고:

Junos OS Release 16.2R2에서 시작해 후보 및 활성 구성을 비교하고 XML 또는 JSON 형식의 차이점을 표시하면 디바이스는 XML 출력에서 태그를 생략 <configuration> 하고 비교에서 차이점이 반환되지 않거나 비교가 비 네이티브 구성 데이터에 대해서만 차이점을 반환하는 경우 JSON 출력에 있는 객체를 생략 configuration 합니다. 예를 들어 OpenConfig 데이터 모델과 관련된 구성 데이터를 예로 들어 보겠습니다.

database

데이터를 표시할 구성을 다음 중 하나로 지정합니다.

  • candidate—후보 구성.

  • committed—활성 구성(가장 최근에 커밋된 구성).

database 둘 다 포함된 경우 속성보다 database-path 속성이 우선합니다.

database-path

커밋 스크립트 내에서 이 속성은 세션의 사전 상속 후보 구성에 대한 경로를 지정합니다. 유일한 수용 가능한 가치는 .$junos-context/commit-context/database-path

일반 구성 세션의 경우 커밋 스크립트가 일반적인 상속 전 후보 구성을 검색합니다. 프라이빗 구성 세션의 경우 커밋 스크립트가 상속 이전의 전용 후보 구성을 검색합니다.

속성과 database-path 속성을 모두 database 포함하면 속성이 database 우선합니다.

format

NETCONF 또는 Junos XML 프로토콜 서버가 구성 데이터를 반환하는 형식을 지정합니다. 수용 가능한 값은 다음과 같습니다.

  • json—JSON(JavaScript Object Notation)을 사용하여 구성 명령문의 형식을 지정합니다. Junos OS 릴리스 16.1부터 Junos OS를 실행하는 디바이스는 직렬화를 위한 새로운 기본 구현을 사용하여 JSON 형식의 구성 데이터를 방출합니다.

    참고:

    Junos OS 릴리스 16.1R4, 16.2R2 및 17.1R1부터 시작하여 JSON 형식으로 방출되는 Junos OS 구성 데이터의 정수는 견적표에 동봉되지 않습니다. 이전 릴리스에서 JSON 구성 데이터의 정수는 문자열로 취급되고 견적 표시로 동봉되었습니다.

  • set—구성 명령문은 Junos OS 구성 모드 set 명령어로 포맷됩니다.

  • text—구성 문은 새로운 문자, 탭 및 기타 공백, 중괄호, 사각형 브래킷을 사용하여 명령문 간의 계층적 관계를 나타내는 ASCII 텍스트로 형식화됩니다. Junos OS를 실행하는 디바이스에 저장되고 CLI show configuration 명령에 의해 표시되는 구성 파일에 사용되는 형식입니다.

  • xml—구성 명령문은 해당 Junos XML 태그 요소로 표현됩니다. 속성이 생략된 경우 format 이는 기본값입니다.

참고:

Junos OS Release 21.1R1 및 Junos OS Evolved Release 22.3R1부터 NETCONF 세션은 불필요한 공간, 탭 및 새라인이 제거된 각 형식을 반환하는 형식과 형식을 추가로 지원 json-minified xml-minified 합니다.

groups

junos:group="group-name" 구성 그룹에서 상속된 각 구성 요소의 오프닝 태그에 속성이 나타나는지 지정합니다. 변수는 group-name 해당 요소가 상속된 구성 그룹의 이름을 지정합니다.

속성groups에 대해 허용되는 값은 groups . 속성을 지정할 groups 때 속성을 지정 inherit 해야 합니다.

inherit

NETCONF 또는 Junos XML 프로토콜 서버가 구성 그룹 및 인터페이스 범위에서 정의된 명령문을 표시하는 방법을 지정합니다. inherit 속성을 생략할 경우, 출력은 , <apply-groups><apply-groups-except> 태그 요소를 사용하여 <groups>사용자 정의 구성 그룹을 나타내고 태그 요소를 사용하여 <interface-range> 사용자 정의 인터페이스 범위를 나타냅니다. junos-defaults 그룹에 정의된 명령문에 대한 태그 요소는 포함하지 않습니다.

수용 가능한 값은 다음과 같습니다.

  • defaults—출력에는 , <apply-groups><apply-groups-except> 태그 요소가 포함되어 <groups>있지 않지만, 상속 태그 요소의 자식으로서 사용자 정의 그룹 및 junos 기본값 그룹에서 상속된 태그 요소를 표시합니다.

  • inherit—출력에는 , <apply-groups><apply-groups-except><interface-range> 태그 요소가 포함되어 <groups>있지 않지만, 사용자 정의 그룹에서 상속되고 상속 태그 요소의 자식으로서 범위가 지정된 태그 요소를 표시합니다. 출력에는 junos 기본값 그룹에 정의된 명령문에 대한 태그 요소가 포함되어 있지 않습니다.

interface-ranges

junos:interface-ranges="source-interface-range" 인터페이스 범위에서 상속된 각 구성 요소의 오프닝 태그에 속성이 나타나는지 지정합니다. 변수는 source-interface-range 인터페이스 범위의 이름을 지정합니다.

속성interface-ranges에 대해 허용되는 값은 interface-ranges . 속성을 지정할 interface-ranges 때 속성을 지정 inherit 해야 합니다.

junos:key | key

속성이 junos:key="key" 구성 객체의 식별자 역할을 하는 각 요소의 오프닝 태그에 나타나는 것을 지정합니다. 유일한 수용 가능한 가치는 .key

릴리스 정보

이것이 바로 Junos XML 관리 프로토콜 작업입니다. Junos XML 프로토콜 세션에서 지원되며, 기능 교환에서 URI http://xml.juniper.net/netconf/junos/1.0 식별하는 Junos OS를 실행하는 장치에서 NETCONF 세션의 주니퍼 네트웍스 전용 확장으로 지원됩니다.

interface-ranges 속성이 Junos OS 릴리스 10.3R1에 추가되었습니다.

commit-scripts 속성 값 applyapply-no-transients Junos OS 릴리스 12.1에 추가

database-path 속성이 Junos OS 릴리스 12.2에 추가되었습니다.

format 속성 부가가치 json 를 추가한 Junos OS 릴리스 14.2.

format 속성 부가가치 set 를 추가한 Junos OS 릴리스 15.1.

Junos OS 릴리스 16.1부터 Junos OS를 실행하는 디바이스는 직렬화를 위한 새로운 기본 구현을 사용하여 JSON 형식의 구성 데이터를 방출합니다.

Junos OS 릴리스 16.1R4, 16.2R2 및 17.1R1부터 시작하여 JSON 형식으로 방출되는 Junos OS 구성 데이터의 정수는 견적표에 동봉되지 않습니다.

compare 속성 부가가치 configuration-revision 를 추가한 Junos OS 릴리스 20.4R1 및 Junos OS Evolved Release 20.4R1.

format 속성 값 json-minifiedxml-minified 추가된 NETCONF 세션은 Junos OS Release 21.1R1 및 Junos OS Evolved Release 22.3R1에서만 가능합니다.