Internet Engineering Task Force (IETF)                          M. Scott
Request for Comments: 6022                                      Ericsson
Category: Standards Track                                   M. Bjorklund
ISSN: 2070-1721                                           Tail-f Systems
                                                            October 2010
        
                   YANG Module for NETCONF Monitoring
        

Abstract

抽象

This document defines a Network Configuration Protocol (NETCONF) data model to be used to monitor the NETCONF protocol. The monitoring data model includes information about NETCONF datastores, sessions, locks, and statistics. This data facilitates the management of a NETCONF server. This document also defines methods for NETCONF clients to discover data models supported by a NETCONF server and defines a new NETCONF <get-schema> operation to retrieve them.

この文書は、NETCONFプロトコルを監視するために使用するネットワーク構成プロトコル(NETCONF)データモデルを定義します。監視データモデルは、NETCONFデータストア、セッション、ロック、および統計に関する情報が含まれています。このデータは、NETCONFサーバの管理を容易にします。この文書はまた、NETCONFサーバでサポートされているデータモデルを発見するためにNETCONFクライアント用のメソッドを定義し、それらを取得するために、新しいNETCONF <GET-スキーマ>の動作を定義します。

Status of This Memo

このメモのステータス

This is an Internet Standards Track document.

これは、インターネット標準化過程文書です。

This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Further information on Internet Standards is available in Section 2 of RFC 5741.

このドキュメントはインターネットエンジニアリングタスクフォース(IETF)の製品です。これは、IETFコミュニティの総意を表しています。これは、公開レビューを受けており、インターネットエンジニアリング運営グループ(IESG)によって公表のために承認されています。インターネット標準の詳細については、RFC 5741のセクション2で利用可能です。

Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at http://www.rfc-editor.org/info/rfc6022.

このドキュメントの現在の状態、任意の正誤表、そしてどのようにフィードバックを提供するための情報がhttp://www.rfc-editor.org/info/rfc6022で取得することができます。

Copyright Notice

著作権表示

Copyright (c) 2010 IETF Trust and the persons identified as the document authors. All rights reserved.

著作権(C)2010 IETF信託とドキュメントの作成者として特定の人物。全著作権所有。

This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.

この文書では、BCP 78と、この文書の発行日に有効なIETFドキュメント(http://trustee.ietf.org/license-info)に関連IETFトラストの法律の規定に従うものとします。彼らは、この文書に関してあなたの権利と制限を説明するように、慎重にこれらの文書を確認してください。コードコンポーネントは、トラスト法規定のセクションで説明4.eおよび簡体BSDライセンスで説明したように、保証なしで提供されているよう簡体BSDライセンスのテキストを含める必要があり、この文書から抽出されました。

This document may contain material from IETF Documents or IETF Contributions published or made publicly available before November 10, 2008. The person(s) controlling the copyright in some of this material may not have granted the IETF Trust the right to allow modifications of such material outside the IETF Standards Process. Without obtaining an adequate license from the person(s) controlling the copyright in such materials, this document may not be modified outside the IETF Standards Process, and derivative works of it may not be created outside the IETF Standards Process, except to format it for publication as an RFC or to translate it into languages other than English.

この材料の一部がIETFトラストにこのような材料の変更を許可する権利を与えられていない可能性がありますにこの文書は、2008年、IETFドキュメントまたは11月10日以前に発行または公開さIETF貢献から著作権を支配する者(複数可)材料を含んでいてもよいですIETF標準化プロセスの外。そのような材料の著作権を管理者(単数または複数)から適切なライセンスを取得することなく、この文書は、IETF標準化過程の外側修正されないかもしれません、そして、それの派生物は、IETF標準化過程の外側に作成されない場合があり、それをフォーマットする以外出版RFCとして、英語以外の言語に翻訳します。

Table of Contents

目次

   1. Introduction ....................................................3
      1.1. Definition of Terms ........................................3
   2. Data Model to Monitor NETCONF ...................................3
      2.1. The /netconf-state Subtree .................................3
           2.1.1. The /netconf-state/capabilities Subtree .............4
           2.1.2. The /netconf-state/datastores Subtree ...............4
           2.1.3. The /netconf-state/schemas Subtree ..................5
           2.1.4. The /netconf-state/sessions Subtree .................6
           2.1.5. The /netconf-state/statistics Subtree ...............7
   3. Schema Specific Operations ......................................8
      3.1. The <get-schema> Operation .................................8
   4. Examples ........................................................9
      4.1. Retrieving Schema List via <get> Operation .................9
      4.2. Retrieving Schema Instances ...............................11
   5. NETCONF Monitoring Data Model ..................................13
   6. Security Considerations ........................................25
   7. Acknowledgements ...............................................26
   8. IANA Considerations ............................................26
   9. References .....................................................26
      9.1. Normative References ......................................26
      9.2. Informative References ....................................27
        
1. Introduction
1. はじめに

This document defines a YANG [RFC6020] model to be used to monitor the NETCONF protocol. It provides information about NETCONF sessions and supported schema as defined in [RFC4741].

この文書は、NETCONFプロトコルを監視するために使用されるYANG [RFC6020]のモデルを定義します。これは、NETCONFセッションに関する情報を提供し、[RFC4741]で定義されたスキーマをサポート。

Considerations such as different schema formats, feature optionality, and access controls can all impact the applicability and level of detail the NETCONF server sends to a client during session setup. The methods defined in this document address the need for further means to query and retrieve schema and NETCONF state information from a NETCONF server. These are provided to complement existing base NETCONF capabilities and operations and in no way affect existing behaviour.

こうした異なるスキーマフォーマットなどの考慮事項、機能の選択性、およびアクセス制御は、すべての影響細部の適用とレベルは、NETCONFサーバは、セッションセットアップ中にクライアントに送信することができます。この文書で定義されたメソッドが照会し、NETCONFサーバからスキーマとNETCONFの状態情報を取得するためのさらなる手段の必要性に取り組みます。これらは、既存のベースのNETCONFの機能や操作を補完しない方法で、既存の動作に影響を与えるために設けられています。

A new <get-schema> operation is also defined to support explicit schema retrieval via NETCONF.

新しい<GET-スキーマ>操作は、NETCONFを経由して明示的なスキーマの取得をサポートするために定義されています。

1.1. Definition of Terms
1.1. 用語の定義

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC2119].

キーワード "MUST"、 "MUST NOT"、 "REQUIRED"、 "SHALL"、 "SHOULD"、 "ないもの"、 "推奨" "ない(SHOULD NOT)"、 "MAY"、 "推奨NOT"、および「OPTIONAL BCP 14 [RFC2119]に記載されているように「この文書に解釈されるべきです。

2. Data Model to Monitor NETCONF
NETCONFを監視する2.データモデル

The NETCONF monitoring data model defined in this document provides operational information on the NETCONF server. This includes details specific to the NETCONF protocol (e.g., protocol-specific counters such as 'in-sessions') as well as data related to schema retrieval (e.g., schema list).

この文書で定義されたNETCONF監視データモデルは、NETCONFサーバの運用情報を提供します。これは、NETCONFプロトコル(例えば「インセッション」として、例えば、プロトコル固有のカウンタ)ならびにスキーマ検索(例えば、スキーマリスト)に関連するデータへの具体的な詳細を含みます。

A server that implements the data model defined in this document ("urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring") MUST advertise the capability URI as described in [RFC6020].

本書で定義されたデータモデルを実装するサーバ( "URN:IETF:paramsは:XML:NS:陽:IETF-NETCONFモニタリング")は[RFC6020]に記載されているように機能URIをアドバタイズしなければなりません。

This section presents an overview of the monitoring data model. For detailed descriptions, refer to the normative YANG module provided in this document (see Section 5).

このセクションでは、監視データモデルの概要を説明します。詳細な説明については、本文書において提供規範YANGモジュール(セクション5を参照)を参照してください。

2.1. The /netconf-state Subtree
2.1. / NETCONF状態のサブツリー

The netconf-state container is the root of the monitoring data model.

NETCONF状態のコンテナは、監視データ・モデルのルートです。

netconf-state /capabilities /datastores /schemas /sessions /statistics

NETCONF状態/機能/データストア/スキーマ/セッション/統計

capabilities List of NETCONF capabilities supported by the server.

サーバーでサポートされているNETCONF機能の機能一覧。

datastores List of NETCONF configuration datastores (e.g., running, startup, candidate) supported on this device and related information.

NETCONF構成データストアのデータストアのリスト(例えば、実行、起動、候補者)は、この装置と関連情報に支持されています。

schemas List of schemas supported on the server. Includes all the information required to identify the schemas and to support their retrieval.

サーバーでサポートされたスキーマのスキーマのリスト。スキーマを識別するために、その取得をサポートするために必要なすべての情報が含まれています。

sessions List of all active NETCONF sessions on the device. Includes per-session counters for all NETCONF sessions.

デバイス上のすべてのアクティブNETCONFセッションのセッション一覧。すべてのNETCONFセッションのセッションごとのカウンタが含まれています。

statistics Includes global counters for the NETCONF server.

統計は、NETCONFサーバのグローバルカウンタが含まれています。

2.1.1. The /netconf-state/capabilities Subtree
2.1.1. / NETCONF状態/機能のサブツリー

The /netconf-state/capabilities subtree contains the capabilities supported by the NETCONF server. The list MUST include all capabilities exchanged during session setup still applicable at the time of the request.

/ NETCONF状態/機能サブツリーは、NETCONFサーバでサポートされる機能が含まれています。リストには、要求の時点ではまだ適用セッションセットアップ中に交換すべての機能を含まなければなりません。

2.1.2. The /netconf-state/datastores Subtree
2.1.2. / NETCONF状態/データストアサブツリー

The /netconf-state/datastores subtree contains the list of available datastores for the NETCONF server and includes information on their lock state.

/ NETCONF状態/データストアのサブツリーは、NETCONFサーバで利用可能なデータストアのリストが含まれており、そのロック状態に関する情報が含まれています。

datastore /name /locks

データストア/名前/ロック

name (leaf, netconf-datastore-type) Enumeration of supported datastores; candidate, running, startup.

サポートされるデータストアの名前(葉、NETCONF・データストア型)列挙。候補者、ランニング、スタートアップ。

locks (grouping, lock-info) List of locks for the datastore. Information is provided for both global and partial locks [RFC5717]. For partial locks, the list of locked nodes and the select expressions originally used to request the lock are returned.

データストアのロックのロック(グループ化、ロック情報)のリスト。情報は、グローバルおよび部分の両方のロック[RFC5717]のために提供されます。部分的ロックの場合、ロックされたノードと、元々ロックを要求するために使用される選択式のリストが返されます。

2.1.3. The /netconf-state/schemas Subtree
2.1.3. / NETCONF状態/スキーマのサブツリー

The list of supported schema for the NETCONF server.

NETCONFサーバでサポートされているスキーマのリスト。

schema /identifier (key) /version (key) /format (key) /namespace /location

スキーマ/識別子(キー)/バージョン(キー)/フォーマット(キー)/名前空間/位置

The elements identifier, version, and format are used as a key in the schema list. These are used in the <get-schema> operation.

要素識別子、バージョン、およびフォーマットは、スキーマリストのキーとして使用されます。これらは、<GET-スキーマ>操作で使用されています。

identifier (string) Identifier for the schema list entry. The identifier is used in the <get-schema> operation and may be used for other means such as file retrieval.

スキーマ・リスト・エントリの識別子(列)識別子。識別子は、<GET-スキーマ>操作で使用され、そのようなファイル検索などの他の手段のために使用することができます。

version (string) Version of the schema supported. Multiple versions MAY be supported simultaneously by a NETCONF server. Each version MUST be reported individually in the schema list, i.e., with same identifier, possibly different location, but different version.

スキーマのバージョン(文字列)のバージョンはサポートされています。複数のバージョンは、NETCONFサーバで同時にサポートされるかもしれません。各バージョンは、同じ識別子、恐らくは異なる場所、異なるバージョンで、即ち、スキーマリストに個別に報告されなければなりません。

For YANG data models, version is the value of the most recent YANG 'revision' statement in the module or submodule, or the empty string if no 'revision' statement is present.

NO「改正」ステートメントが存在しない場合YANGデータモデルの場合、バージョンは、最新のYANG「改正」モジュールまたはサブモジュール内のステートメント、または空の文字列の値です。

format (identifyref, schema-format) The data modeling language the schema is written in. The data modeling language is represented as a YANG identity. This document defines the identities "xsd", "yang", "yin", "rng", and "rnc" (see Section 5).

フォーマット(identifyref、スキーマフォーマット)スキーマが書き込まれる。データモデリング言語は、YANG IDとして表されたデータモデリング言語。この文書は、アイデンティティ "XSD"、 "陽"、 "陰"、 "RNG"、および "RNCを"(セクション5を参照)を定義します。

namespace (inet:uri) The Extensible Markup Language (XML) namespace [XML-NAMES] defined by the schema.

名前空間(INET:URI)拡張マークアップ言語(XML)スキーマの名前空間によって定義される[XML-NAMES]。

location (union: enum, inet:uri) One or more locations from which this specific schema can be retrieved. The list SHOULD contain at least one entry per schema.

場所(ユニオン:列挙、INET:URI)は、この特定のスキーマを検索することができるからの1つの以上の場所。リストには、スキーマごとに少なくとも1つのエントリが含まれています。

2.1.4. The /netconf-state/sessions Subtree
2.1.4. / NETCONF状態/セッションのサブツリー

Includes session-specific data for NETCONF management sessions. The session list MUST include all currently active NETCONF sessions.

NETCONF管理セッションのセッション固有のデータが含まれています。セッションリストは、現在アクティブなすべてのNETCONFセッションを含まなければなりません。

session /session-id (key) /transport /username /source-host /login-time /in-rpcs /in-bad-rpcs /out-rpc-errors /out-notifications

セッション/セッションID(キー)/輸送/ユーザー名/ソース・ホスト/ログイン時/中-のRPC /イン・不良のRPC /アウト-RPC-エラー/アウト通知

session-id (uint32, 1..max) Unique identifier for the session. This value is the NETCONF session identifier, as defined in [RFC4741].

セッションID(UINT32、1..max)セッションの一意の識別子。 [RFC4741]で定義されるように、この値は、NETCONFセッション識別子です。

transport (identityref, transport) Identifies the transport for each session. The transport is represented as a YANG identity. This document defines the identities "netconf-ssh", "netconf-soap-over-beep", "netconf-soap-over-https", "netconf-beep", and "netconf-tls" (see Section 5).

輸送(identityref、輸送)は、各セッションのトランスポートを指定します。輸送はYANG IDとして表されます。この文書は(セクション5を参照)のアイデンティティ "NETCONF-SSH"、 "NETCONF・石鹸・オーバー・ビープ音"、 "NETCONF石鹸オーバーhttps" の、 "NETCONF-ビープ音"、および "NETCONF-TLS" を定義します。

username (string) The username is the client identity that was authenticated by the NETCONF transport protocol. The algorithm used to derive the username is NETCONF transport protocol specific and in addition specific to the authentication mechanism used by the NETCONF transport protocol.

ユーザ名(文字列)ユーザー名は、NETCONFのトランスポートプロトコルによって認証されたクライアントIDです。ユーザ名を導出するために使用されるアルゴリズムは、特定のとNETCONFのトランスポートプロトコルによって使用される認証メカニズムに固有の他に、NETCONFトランスポートプロトコルです。

source-host (inet:host) Host identifier (IP address or name) of the NETCONF client.

NETCONFクライアントのホスト識別子(IPアドレスまたは名前):ソース・ホスト(ホストINET)。

login-time (yang:date-and-time) Time at the server at which the session was established.

ログイン時(ヤン:日時)時間をセッションが確立されたときのサーバーで。

in-rpcs (yang:zero-based-counter32) Number of correct <rpc> messages received.

内のRPC(陽:ゼロベース-Counter32の)正しい<RPC>メッセージの数が受信。

in-bad-rpcs (yang:zero-based-counter32) Number of messages received when an <rpc> message was expected, that were not correct <rpc> messages. This includes XML parse errors and errors on the rpc layer.

イン不良のRPC(陽:ゼロベース-Counter32の)正しい<RPC>メッセージではなかった。<RPC>メッセージが期待されたときにメッセージの数が受信、。これは、RPC層上のXML解析エラーおよびエラーが含まれています。

out-rpc-errors (yang:zero-based-counter32) Number of <rpc-reply> messages sent that contained an <rpc-error> element.

アウト-RPC-エラー(陽:ゼロベース-Counter32の)<RPC返信>数<RPCエラー>要素が含まれて送信されるメッセージ。

out-notifications (yang:zero-based-counter32) Number of <notification> messages sent.

外通知(ヤン:ゼロベース-Counter32の)送ら<通知>メッセージの数。

2.1.5. The /netconf-state/statistics Subtree
2.1.5. / NETCONF状態/統計サブツリー

Statistical data pertaining to the NETCONF server.

NETCONFサーバに関連する統計データ。

statistics /netconf-start-time /in-bad-hellos /in-sessions /dropped-sessions /in-rpcs /in-bad-rpcs /out-rpc-errors /out-notifications

統計/ NETCONF-開始時間/イン・不良のhellos /イン・セッション/ドロップ・セッション/中-のRPC /イン・不良のRPC /アウト-RPC-エラー/アウト通知

statistics: Contains management-session-related performance data for the NETCONF server.

統計は:NETCONFサーバの管理セッション関連のパフォーマンスデータが含まれています。

netconf-start-time (yang:date-and-time) Date and time at which the management subsystem was started.

NETCONF開始時刻(ヤン:日時)管理サブシステムが開始された日付と時刻。

in-bad-hellos (yang:zero-based-counter32) Number of sessions silently dropped because an invalid <hello> message was received.

イン不良のhello(陽:ゼロベース-Counter32の)無効な<こんにちは>メッセージを受信したため、セッションの数は静かに落下しました。

in-sessions (yang:zero-based-counter32) Number of sessions started.

中・セッション(ヤン:ゼロベース-Counter32の)セッションの数を開始しました。

dropped-sessions (yang:zero-based-counter32) Number of sessions that were abnormally terminated, e.g., due to idle timeout or transport close.

タイムアウトまたは輸送近いアイドルに起因例えば異常終了したセッションの数(ゼロベース-Counter32の陽) - セッションを落としました。

in-rpcs (yang:zero-based-counter32) Number of correct <rpc> messages received.

内のRPC(陽:ゼロベース-Counter32の)正しい<RPC>メッセージの数が受信。

in-bad-rpcs (yang:zero-based-counter32) Number of messages received when an <rpc> message was expected, which were not correct <rpc> messages.

イン不良のRPC(陽:ゼロベース-Counter32の)<RPC>メッセージが期待されたときにメッセージの数が正しい<RPC>メッセージれなかった、受信されました。

out-rpc-errors (yang:zero-based-counter32) Number of <rpc-reply> messages sent that contained an <rpc-error> element.

アウト-RPC-エラー(陽:ゼロベース-Counter32の)<RPC返信>数<RPCエラー>要素が含まれて送信されるメッセージ。

out-notifications (yang:zero-based-counter32) Number of <notification> messages sent.

外通知(ヤン:ゼロベース-Counter32の)送ら<通知>メッセージの数。

3. Schema Specific Operations
3.スキーマの特定の操作
3.1. The <get-schema> Operation
3.1. <GET-スキーマ>運用

Description:

説明:

This operation is used to retrieve a schema from the NETCONF server.

この操作は、NETCONFサーバからスキーマを取得するために使用されます。

Parameters:

パラメーター:

identifier (string): Identifier for the schema list entry. Mandatory parameter.

識別子(文字列):スキーマリストエントリの識別子。必須パラメータ。

version (string): Version of the schema requested. Optional parameter.

バージョン(文字列):要求されたスキーマのバージョン。オプションのパラメータ。

format (identityref, schema-format): The data modeling language of the schema. Default value is 'yang' when not specified. Optional parameter.

フォーマット(identityref、スキーマ形式):スキーマのデータモデリング言語。デフォルト値は指定されていない「陽」です。オプションのパラメータ。

Positive Response:

肯定的な反応:

The NETCONF server returns the requested schema.

NETCONFサーバは、要求されたスキーマを返します。

Negative Response:

否定応答:

If the requested schema does not exist, the <error-tag> is 'invalid-value'.

要求されたスキーマが存在しない場合は、<エラータグ>「は無効な値が」です。

If more than one schema matches the requested parameters, the <error-tag> is 'operation-failed', and <error-app-tag> is 'data-not-unique'.

複数のスキーマが要求されたパラメータと一致する場合、<エラータグ>「の操作に失敗した」、および<エラーアプリ内タグ>である「データ・-一意ではない」です。

4. Examples
4.例
4.1. Retrieving Schema List via <get> Operation
4.1. <GET>操作を経由して取得スキーマ一覧

A NETCONF client retrieves the list of supported schema from a NETCONF server by retrieving the /netconf-state/schemas subtree via a <get> operation.

NETCONFクライアントは、<こちら>の操作を経て/ NETCONF状態/スキーマのサブツリーを取得することで、NETCONFサーバからサポートされているスキーマのリストを取得します。

Available schema for the requesting session are returned in the reply containing the <identifier>, <version>, <format>, and <location> elements.

要求セッションで使用可能なスキーマは、<識別子>、<バージョン>、<フォーマット>を含む応答で返され、そして<場所>要素です。

The response data can be used to determine the available schema and their versions. The schema itself (i.e., schema content) is not returned in the response. The optional <location> element contains a URI, which can be used to retrieve the schema by another protocol such as ftp [RFC0959] or http(s) [RFC2616] [RFC2818], or the special value 'NETCONF', which means that the schema can be retrieved from the device via the <get-schema> operation.

応答データは、利用可能なスキーマとそのバージョンを決定するために使用することができます。スキーマ自体(すなわち、スキーマの内容)が応答で返されていません。オプションの<場所>要素は、FTP [RFC0959]またはHTTP(S)などの別のプロトコルことを意味する[RFC2616]、[RFC2818]、または特別な値「NETCONF」によってスキーマを取得するために使用することができるURIを含んでスキーマは、<GETスキーマ>操作を介してデバイスから取得することができます。

Example:

例:

<rpc message-id="101" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> <get> <filter type="subtree"> <netconf-state xmlns= "urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring"> <schemas/> </netconf-state> </filter> </get> </rpc>

<RPCメッセージID = "101" のxmlns = "URN:IETF:paramsは:XML:NS:NETCONF:塩基:1.0"> <GET> <フィルタタイプ= "サブツリー"> <NETCONF状態のxmlns =「URN:IETF :のparams:XML:NS:ヤンは:「IETF-NETCONF監視> <スキーマ/> </ NETCONF状態> </フィルタ> </取得> </ RPC>

The NETCONF server returns a list of schema available for retrieval.

NETCONFサーバは、検索のために使用可能なスキーマのリストを返します。

<rpc-reply message-id="101" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> <data> <netconf-state xmlns="urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring"> <schemas> <schema> <identifier>foo</identifier> <version>1.0</version> <format>xsd</format> <namespace>http://example.com/foo</namespace> <location>ftp://ftp.example.com/schemas/foo_1.0.xsd</location> <location>http://www.example.com/schema/foo_1.0.xsd</location> <location>NETCONF</location> </schema> <schema> <identifier>foo</identifier> <version>1.1</version> <format>xsd</format> <namespace>http://example.com/foo</namespace> <location>ftp://ftp.example.com/schemas/foo_1.1.xsd</location> <location>http://www.example.com/schema/foo_1.1.xsd</location> <location>NETCONF</location> </schema> <schema> <identifier>bar</identifier> <version>2008-06-01</version> <format>yang</format> <namespace>http://example.com/bar</namespace> <location> http://example.com/schema/bar@2008-06-01.yang </location> <location>NETCONF</location> </schema> <schema> <identifier>bar-types</identifier> <version>2008-06-01</version> <format>yang</format> <namespace>http://example.com/bar</namespace> <location> http://example.com/schema/bar-types@2008-06-01.yang </location> <location>NETCONF</location> </schema> </schemas> </netconf-state> </data> </rpc-reply>

<RPC返信メッセージID = "101" のxmlns = "URN:IETF:paramsは:XML:NS:NETCONF:塩基:1.0"> <データ> <NETCONF状態のxmlns = "URN:IETF:paramsは:XML:NS :陽:「IETF-NETCONF監視> <スキーマ> <スキーマ> <識別子> FOO </識別子> <バージョン> 1.0 </バージョン> <フォーマット> XSD </フォーマット> <名前空間> http://example.com / FOO </名前空間> <場所> ftp://ftp.example.com/schemas/foo_1.0.xsd </場所> <場所> http://www.example.com/schema/foo_1.0.xsd </場所> <場所> NETCONF </場所> </スキーマ> <スキーマ> <識別子> FOO </識別子> <バージョン> 1.1 </バージョン> <フォーマット> XSD </フォーマット> <名前空間>のhttp:// example.com/foo </名前空間> <場所> ftp://ftp.example.com/schemas/foo_1.1.xsd </場所> <場所> http://www.example.com/schema/foo_1。 1.xsd </場所> <場所> NETCONF </場所> </スキーマ> <スキーマ> <識別子>バー</識別子> <バージョン> 2008-06-01 </バージョン> <フォーマット>ヤン</フォーマット> <名前空間> http://example.com/bar </名前空間> <場所> http://example.com/schema/bar@2008-06-01.yang </場所> <場所> NETCONF </場所> </スキーマ> <スキーマ> <識別子>バータイプ</識別子> <バージョン> 2008-06-01 </バージョン> <フォーマット>ヤン</フォーマット> <名前空間> http://example.com/bar </名前空間> <ロケーション> http://example.com/schema/bar-types@2008-06-01.yang </場所> <場所> NETCONF </場所> </スキーマ> </スキーマ> </ NETCONF状態> < /データ> </ RPC返信>

4.2. Retrieving Schema Instances
4.2. スキーマのインスタンスを取得

Given the reply in the previous section, the following examples illustrate the retrieval of 'foo', 'bar', and 'bar-types' schema at multiple locations, with multiple formats, and in multiple locations.

前節の応答を考えると、以下の実施例は、複数のフォーマットと、及び複数の場所に、「foo」で、「バー」、及び複数の位置で「バータイプ」スキーマの検索を示します。

1. foo, version 1.0 in xsd format:
1. FOO、XSD形式でバージョン1.0:

a. Via FTP using location ftp://ftp.example.com/schemas/foo_1.0.xsd

A。 FTP経由で位置ftp://ftp.example.com/schemas/foo_1.0.xsdを使用して

b. Via HTTP using location http://www.example.com/schema/foo_1.0.xsd

B。 HTTP経由で位置を使用してhttp://www.example.com/schema/foo_1.0.xsd

c. Via <get-schema> using identifier, version, and format parameters.

C。 <GET-スキーマ>を経由して識別子、バージョン、およびフォーマットパラメータを使用して。

<rpc message-id="101" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> <get-schema xmlns="urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring"> <identifier>foo</identifier> <version>1.0</version> <format>xsd</format> </get-schema> </rpc>

<RPCメッセージID = "101" のxmlns = "URN:IETF:paramsは:XML:NS:NETCONF:塩基:1.0"> <GET-スキーマのxmlns = "URN:IETF:paramsは:XML:NS:陽:ietf- NETCONF監視 "> <識別子> FOO </識別子> <バージョン> 1.0 </ version>の<フォーマット> XSD </フォーマット> </取得・スキーマ> </ RPC>

<rpc-reply message-id="101" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> <data xmlns="urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring"> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"> <!-- foo 1.0 xsd schema contents here --> </xs:schema> </data> </rpc-reply>

<RPC返信メッセージID = "101" のxmlns = "URN:IETF:paramsは:XML:NS:NETCONF:塩基:1.0"> <データのxmlns = "URN:IETF:paramsは:XML:NS:陽:ietf- NETCONF監視 "> <XS:スキーマのxmlns:XS ="!http://www.w3.org/2001/XMLSchema "> < - fooの1.0 XSDスキーマの内容をここに - > </ XS:スキーマ> </データ> </ RPC-返信>

2. bar, version 2008-06-01 in YANG format:
2.バー、ここでフォーマットバージョン2008-06-01:

a. Via HTTP using location http://example.com/schema/bar@2008-06-01.yang

A。 HTTP経由で位置を使用してhttp://example.com/schema/bar@2008-06-01.yang

b. Via <get-schema> using identifier and version parameters:

B。識別子とバージョンのパラメータを使用して、<GET-スキーマ>経由:

<rpc message-id="102" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> <get-schema xmlns="urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring"> <identifer>bar</identifer> <version>2008-06-01</version> </get-schema> </rpc>

<RPCメッセージID = "102" のxmlns = "URN:IETF:paramsは:XML:NS:NETCONF:塩基:1.0"> <GET-スキーマのxmlns = "URN:IETF:paramsは:XML:NS:陽:ietf- NETCONF監視 "> <識別子です>バー</識別子です> <バージョン> 2008-06-01 </バージョン> </取得・スキーマ> </ RPC>

<rpc-reply message-id="102" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> <data xmlns="urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring"> module bar { //default format (yang) returned //bar version 2008-06-01 yang module //contents here ... } </data> </rpc-reply>

<RPC返信メッセージID = "102" のxmlns = "URN:IETF:paramsは:XML:NS:NETCONF:塩基:1.0"> <データのxmlns = "URN:IETF:paramsは:XML:NS:陽:ietf- 「監視NETCONF>モジュールバー{//デフォルトフォーマット(ヤン)2008-06-01陽モジュール//コンテンツ//ここバーバージョン返さ...} </データ> </ RPC返信>

3. bar-types, version 2008-06-01 in default YANG format:
3.バータイプ、デフォルトYANG形式のバージョンを2008年6月1日:

a. Via <get-schema> using identifer parameter:

A。経由識別子パラメータを使用して、<GET-スキーマ>:

<rpc message-id="103" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> <get-schema xmlns="urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring"> <identifer>bar-types</identifer> </get-schema> </rpc>

<RPCメッセージID = "103" のxmlns = "URN:IETF:paramsは:XML:NS:NETCONF:塩基:1.0"> <GET-スキーマのxmlns = "URN:IETF:paramsは:XML:NS:陽:ietf- NETCONF監視 "> <識別子です>バータイプ</識別子です> </ GET-スキーマ> </ RPC>

<rpc-reply message-id="103" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> <data xmlns="urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring"> module bar-types { //default format (yang) returned //latest revision returned //is version 2008-06-01 yang module //contents here ... } </data> </rpc-reply>

<RPC返信メッセージID = "103" のxmlns = "URN:IETF:paramsは:XML:NS:NETCONF:塩基:1.0"> <データのxmlns = "URN:IETF:paramsは:XML:NS:陽:ietf- NETCONF監視 ">モジュールバー-タイプ</データ> </ RPC- {//デフォルトのフォーマット(陽)が返さ//最新のリビジョンは、// ...ここバージョン2008-06-01陽モジュール//内容で返さ}返信>

5. NETCONF Monitoring Data Model
5. NETCONF監視データモデル

The data model described in this memo is defined in the following YANG module.

このメモで説明したデータモデルは、以下のYANGモジュールで定義されています。

This YANG module imports typedefs from [RFC6021] and references [RFC4741], [RFC4742], [RFC4743], [RFC4744], [RFC5539], [xmlschema-1], [RFC6020], [ISO/IEC19757-2:2008], and [RFC5717].

[RFC6021]および参考文献[RFC4741]、[RFC4742]、[RFC4743]、[RFC4744]、[RFC5539]、からこのYANGモジュールは、インポートのtypedef [XMLSCHEMA-1]、[RFC6020]、[/ IEC19757-2 ISO:2008] 、および[RFC5717]。

<CODE BEGINS> file "ietf-netconf-monitoring@2010-10-04.yang"

ファイル "ietf-netconf-monitoring@2010-10-04.yang" <CODEが開始されます>

module ietf-netconf-monitoring {

モジュールIETF-NETCONF監視{

  namespace "urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring";
  prefix "ncm";
        

import ietf-yang-types { prefix yang; } import ietf-inet-types { prefix inet; }

インポートIETF-ヤン・タイプ{プレフィックス陽。 } IETF-タイプINET {プレフィックスINETインポート。 }

organization "IETF NETCONF (Network Configuration) Working Group";

組織「IETF NETCONF(ネットワーク設定)ワーキンググループ」。

contact "WG Web: <http://tools.ietf.org/wg/netconf/> WG List: <mailto:netconf@ietf.org>

「連絡WGのWeb:<http://tools.ietf.org/wg/netconf/> WG一覧:<mailtoの:netconf@ietf.org>

WG Chair: Mehmet Ersue <mailto:mehmet.ersue@nsn.com>

WG座長:メフメットArsin <mailtoの:mehmet.ersue@nsn.co I>

WG Chair: Bert Wijnen <mailto:bertietf@bwijnen.net>

WG座長:バートWijnen <mailtoの:bertietf@bwijnen.net>

Editor: Mark Scott <mailto:mark.scott@ericsson.com>

編集者:マーク・スコット<mailtoの:mark.scott@ericsson.com>

Editor: Martin Bjorklund <mailto:mbj@tail-f.com>";

エディタ:マーティンBjorklund <mailtoの:mbj@tail-f.com>「;

description "NETCONF Monitoring Module. All elements in this module are read-only.

説明「NETCONF監視モジュール。このモジュール内のすべての要素は読み取り専用です。

Copyright (c) 2010 IETF Trust and the persons identified as authors of the code. All rights reserved.

著作権(C)2010 IETF信託コードの作者として特定の人物。全著作権所有。

Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD

、に基づき許可されており、中に含まれるライセンス条項に従う、簡体BSDされ又は変更せず、ソースおよびバイナリ形式での再配布および使用

License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info).

ライセンスは、IETFドキュメント(http://trustee.ietf.org/license-info)に関連IETFトラストの法律規定のセクション4.Cに記載されて。

This version of this YANG module is part of RFC 6022; see the RFC itself for full legal notices.";

このYANGモジュールのこのバージョンはRFC 6022の一部です。完全な適法な通知についてはRFC自体を参照してください。 ";

  revision 2010-10-04 {
    description
      "Initial revision.";
    reference
      "RFC 6022: YANG Module for NETCONF Monitoring";
  }
        
  typedef netconf-datastore-type {
    type enumeration {
      enum running;
      enum candidate;
      enum startup;
    }
    description
      "Enumeration of possible NETCONF datastore types.";
    reference
      "RFC 4741: NETCONF Configuration Protocol";
  }
        

identity transport { description "Base identity for NETCONF transport types."; }

アイデンティティ輸送{説明「NETCONF輸送型の基本アイデンティティ。」; }

  identity netconf-ssh {
    base transport;
    description
      "NETCONF over Secure Shell (SSH).";
    reference
      "RFC 4742: Using the NETCONF Configuration Protocol
                 over Secure SHell (SSH)";
  }
        
  identity netconf-soap-over-beep {
    base transport;
    description
      "NETCONF over Simple Object Access Protocol (SOAP) over
       Blocks Extensible Exchange Protocol (BEEP).";
        

reference "RFC 4743: Using NETCONF over the Simple Object Access Protocol (SOAP)"; }

参照「RFC 4743:シンプルオブジェクトアクセスプロトコル(SOAP)上にNETCONFを使用します」。 }

  identity netconf-soap-over-https {
    base transport;
    description
      "NETCONF over Simple Object Access Protocol (SOAP)
      over Hypertext Transfer Protocol Secure (HTTPS).";
    reference
      "RFC 4743: Using NETCONF over the Simple Object
                 Access Protocol (SOAP)";
  }
        
  identity netconf-beep {
    base transport;
    description
      "NETCONF over Blocks Extensible Exchange Protocol (BEEP).";
    reference
      "RFC 4744: Using the NETCONF Protocol over the
                 Blocks Extensible Exchange Protocol (BEEP)";
  }
        
  identity netconf-tls {
    base transport;
    description
      "NETCONF over Transport Layer Security (TLS).";
    reference
      "RFC 5539: NETCONF over Transport Layer Security (TLS)";
  }
        

identity schema-format { description "Base identity for data model schema languages."; }

同一スキーマフォーマット{記述「データモデルスキーマ言語の基本アイデンティティ。」; }

  identity xsd {
    base schema-format;
    description
      "W3C XML Schema Definition.";
    reference
      "W3C REC REC-xmlschema-1-20041028:
         XML Schema Part 1: Structures";
  } identity yang {
    base schema-format;
    description
      "The YANG data modeling language for NETCONF.";
    reference
      "RFC 6020:  YANG - A Data Modeling Language for the
                  Network Configuration Protocol (NETCONF)";
  }
        
  identity yin {
    base schema-format;
    description
      "The YIN syntax for YANG.";
    reference
      "RFC 6020:  YANG - A Data Modeling Language for the
                  Network Configuration Protocol (NETCONF)";
  }
        
  identity rng {
    base schema-format;
    description
      "Regular Language for XML Next Generation (RELAX NG).";
    reference
      "ISO/IEC 19757-2:2008: RELAX NG";
  }
        
  identity rnc {
    base schema-format;
    description
      "Relax NG Compact Syntax";
    reference
      "ISO/IEC 19757-2:2008: RELAX NG";
  }
        

grouping common-counters { description "Counters that exist both per session, and also globally, accumulated from all sessions.";

グループ共通カウンタ{説明「すべてのセッションから蓄積もグローバルセッションごとの両方が存在するカウンタ、及び、。」;

    leaf in-rpcs {
      type yang:zero-based-counter32;
      description
        "Number of correct <rpc> messages received.";
    }
    leaf in-bad-rpcs {
      type yang:zero-based-counter32;
        
      description
        "Number of messages received when an <rpc> message was expected,
         that were not correct <rpc> messages.  This includes XML parse
         errors and errors on the rpc layer.";
    }
    leaf out-rpc-errors {
      type yang:zero-based-counter32;
      description
        "Number of <rpc-reply> messages sent that contained an
         <rpc-error> element.";
    }
    leaf out-notifications {
      type yang:zero-based-counter32;
      description
        "Number of <notification> messages sent.";
    }
  }
        
  container netconf-state {
    config false;
    description
      "The netconf-state container is the root of the monitoring
       data model.";
        

container capabilities { description "Contains the list of NETCONF capabilities supported by the server.";

コンテナ機能{記述は、「サーバーがサポートしているNETCONF機能のリストが含まれています。」;

      leaf-list capability {
        type inet:uri;
        description
          "List of NETCONF capabilities supported by the server.";
      }
    }
        

container datastores { description "Contains the list of NETCONF configuration datastores.";

コンテナデータストア{記述は、「NETCONF設定データストアのリストが含まれています。」。

      list datastore {
        key name;
        description
          "List of NETCONF configuration datastores supported by
           the NETCONF server and related information.";
        

leaf name { type netconf-datastore-type;

リーフ名{型NETCONF-データストア型。

          description
            "Name of the datastore associated with this list entry.";
        }
        container locks {
          presence
            "This container is present only if the datastore
             is locked.";
          description
            "The NETCONF <lock> and <partial-lock> operations allow
             a client to lock specific resources in a datastore.  The
             NETCONF server will prevent changes to the locked
             resources by all sessions except the one that acquired
             the lock(s).
        
             Monitoring information is provided for each datastore
             entry including details such as the session that acquired
             the lock, the type of lock (global or partial) and the
             list of locked resources.  Multiple locks per datastore
             are supported.";
        

grouping lock-info { description "Lock related parameters, common to both global and partial locks.";

ロック情報をグルーピング{説明「の両方のグローバルと部分ロックと共通の関連パラメータを、ロックします。」;

            leaf locked-by-session {
              type uint32;
              mandatory true;
              description
                "The session ID of the session that has locked
                 this resource.  Both a global lock and a partial
                 lock MUST contain the NETCONF session-id.
        
                 If the lock is held by a session that is not managed
                 by the NETCONF server (e.g., a CLI session), a session
                 id of 0 (zero) is reported.";
              reference
                "RFC 4741: NETCONF Configuration Protocol";
            }
            leaf locked-time {
              type yang:date-and-time;
              mandatory true;
              description
                "The date and time of when the resource was
                 locked.";
            }
          } choice lock-type {
            description
              "Indicates if a global lock or a set of partial locks
               are set.";
        
            container global-lock {
              description
                "Present if the global lock is set.";
              uses lock-info;
            }
        
            list partial-lock {
              key lock-id;
              description
                "List of partial locks.";
              reference
                "RFC 5717: Partial Lock Remote Procedure Call (RPC) for
                           NETCONF";
        
              leaf lock-id {
                type uint32;
                description
                  "This is the lock id returned in the <partial-lock>
                   response.";
              }
              uses lock-info;
              leaf-list select {
                type yang:xpath1.0;
                min-elements 1;
                description
                  "The xpath expression that was used to request
                   the lock.  The select expression indicates the
                   original intended scope of the lock.";
              }
              leaf-list locked-node {
                type instance-identifier;
                description
                  "The list of instance-identifiers (i.e., the
                   locked nodes).
        
                   The scope of the partial lock is defined by the list
                   of locked nodes.";
              }
            }
          }
        }
      }
    } container schemas {
      description
        "Contains the list of data model schemas supported by the
         server.";
        

list schema { key "identifier version format";

リストスキーマ{キー「識別子バージョンの形式」;

description "List of data model schemas supported by the server.";

説明「サーバによってサポートされるデータモデルスキーマのリスト。」;

leaf identifier { type string; description "Identifier to uniquely reference the schema. The identifier is used in the <get-schema> operation and may be used for other purposes such as file retrieval.

リーフ識別子{型ストリング。説明は「識別子は、スキーマを参照する。識別子は、<GET-スキーマ>操作で使用され、そのようなファイル検索のような他の目的に使用することができます。

             For modeling languages that support or require a data
             model name (e.g., YANG module name) the identifier MUST
             match that name.  For YANG data models, the identifier is
             the name of the module or submodule.  In other cases, an
             identifier such as a filename MAY be used instead.";
        }
        leaf version {
          type string;
          description
            "Version of the schema supported.  Multiple versions MAY be
             supported simultaneously by a NETCONF server.  Each
             version MUST be reported individually in the schema list,
             i.e., with same identifier, possibly different location,
             but different version.
        
             For YANG data models, version is the value of the most
             recent YANG 'revision' statement in the module or
             submodule, or the empty string if no 'revision' statement
             is present.";
        }
        leaf format {
          type identityref {
            base schema-format;
          }
          description
            "The data modeling language the schema is written
             in (currently xsd, yang, yin, rng, or rnc).
        
             For YANG data models, 'yang' format MUST be supported and
             'yin' format MAY also be provided.";
        }
        leaf namespace {
          type inet:uri;
          mandatory true;
          description
            "The XML namespace defined by the data model.
        
             For YANG data models, this is the module's namespace.
             If the list entry describes a submodule, this field
             contains the namespace of the module to which the
             submodule belongs.";
        }
        leaf-list location {
          type union {
            type enumeration {
              enum "NETCONF";
            }
            type inet:uri;
          }
          description
            "One or more locations from which the schema can be
             retrieved.  This list SHOULD contain at least one
             entry per schema.
        
             A schema entry may be located on a remote file system
             (e.g., reference to file system for ftp retrieval) or
             retrieved directly from a server supporting the
             <get-schema> operation (denoted by the value 'NETCONF').";
        }
      }
    } container sessions {
      description
        "The sessions container includes session-specific data for
         NETCONF management sessions.  The session list MUST include
         all currently active NETCONF sessions.";
        
      list session {
        key session-id;
        description
          "All NETCONF sessions managed by the NETCONF server
           MUST be reported in this list.";
        
        leaf session-id {
          type uint32 {
            range "1..max";
          }
          description
            "Unique identifier for the session.  This value is the
             NETCONF session identifier, as defined in RFC 4741.";
          reference
            "RFC 4741: NETCONF Configuration Protocol";
        }
        leaf transport {
          type identityref {
            base transport;
          }
          mandatory true;
          description
            "Identifies the transport for each session, e.g.,
            'netconf-ssh', 'netconf-soap', etc.";
        }
        leaf username  {
          type string;
          mandatory true;
          description
            "The username is the client identity that was authenticated
            by the NETCONF transport protocol.  The algorithm used to
            derive the username is NETCONF transport protocol specific
            and in addition specific to the authentication mechanism
            used by the NETCONF transport protocol.";
        }
        leaf source-host {
          type inet:host;
          description
            "Host identifier of the NETCONF client.  The value
             returned is implementation specific (e.g., hostname,
             IPv4 address, IPv6 address)";
        } leaf login-time {
          type yang:date-and-time;
          mandatory true;
          description
            "Time at the server at which the session was established.";
        }
        uses common-counters {
          description
            "Per-session counters.  Zero based with following reset
             behaviour:
               - at start of a session
               - when max value is reached";
        }
      }
    }
        

container statistics { description "Statistical data pertaining to the NETCONF server.";

コンテナの統計{説明「NETCONFサーバに関連する統計データ。」;

      leaf netconf-start-time {
        type yang:date-and-time;
        description
          "Date and time at which the management subsystem was
           started.";
      }
      leaf in-bad-hellos {
        type yang:zero-based-counter32;
        description
          "Number of sessions silently dropped because an
          invalid <hello> message was received.  This includes <hello>
          messages with a 'session-id' attribute, bad namespace, and
          bad capability declarations.";
      }
      leaf in-sessions {
        type yang:zero-based-counter32;
        description
          "Number of sessions started.  This counter is incremented
           when a <hello> message with a <session-id> is sent.
        
          'in-sessions' - 'in-bad-hellos' =
              'number of correctly started netconf sessions'";
      }
      leaf dropped-sessions {
        type yang:zero-based-counter32;
        
        description
          "Number of sessions that were abnormally terminated, e.g.,
           due to idle timeout or transport close.  This counter is not
           incremented when a session is properly closed by a
           <close-session> operation, or killed by a <kill-session>
           operation.";
      }
      uses common-counters {
        description
          "Global counters, accumulated from all sessions.
           Zero based with following reset behaviour:
             - re-initialization of NETCONF server
             - when max value is reached";
      }
    }
  }
        

rpc get-schema { description "This operation is used to retrieve a schema from the NETCONF server.

RPC取得スキーマ{説明は「この操作は、NETCONFサーバからスキーマを取得するために使用されます。

       Positive Response:
         The NETCONF server returns the requested schema.
        

Negative Response: If requested schema does not exist, the <error-tag> is 'invalid-value'.

負の応答:要求されたスキーマは、<エラータグが>存在しない場合は「無効値」です。

If more than one schema matches the requested parameters, the <error-tag> is 'operation-failed', and <error-app-tag> is 'data-not-unique'.";

複数のスキーマが要求されたパラメータと一致する場合、<エラータグ>「の操作に失敗した」、および<エラーアプリ内タグ>である「データ固有ではない」です。 ";

    input {
      leaf identifier {
        type string;
        mandatory true;
        description
          "Identifier for the schema list entry.";
      }
      leaf version {
        type string;
        description
          "Version of the schema requested.  If this parameter is not
           present, and more than one version of the schema exists on
           the server, a 'data-not-unique' error is returned, as
           described above.";
      } leaf format {
        type identityref {
          base schema-format;
        }
        description
           "The data modeling language of the schema.  If this
            parameter is not present, and more than one formats of
            the schema exists on the server, a 'data-not-unique' error
            is returned, as described above.";
      }
    }
    output {
        anyxml data {
          description
            "Contains the schema content.";
      }
    }
  }
}
        

<CODE ENDS>

<CODEはENDS>

6. Security Considerations
6.セキュリティの考慮事項

The YANG module defined in this memo is designed to be accessed via the NETCONF protocol [RFC4741]. The lowest NETCONF layer is the secure transport layer and the mandatory to implement secure transport is SSH [RFC4742].

このメモで定義されたYANGモジュールはNETCONFプロトコル[RFC4741]を介してアクセスするように設計されています。最低NETCONF層は、セキュアトランスポート層であり、安全な輸送を実現するために必須では、SSH [RFC4742]です。

Some of the readable data nodes in this YANG module may be considered sensitive or vulnerable in some network environments. It is thus important to control read access (e.g., via get, get-config, or notification) to these data nodes.

このYANGモジュールで読み取り可能なデータノードのいくつかは、いくつかのネットワーク環境に敏感又は脆弱と考えることができます。これらのデータノードにアクセスすること(例えば、GETを介して、または通知設定を取得する)読み取り制御することが重要です。

These are the containers, list nodes, and data nodes with their specific sensitivity/vulnerability:

これらは、特定の感度/脆弱性を持つコンテナ、リスト・ノード、およびデータノード以下のとおりです。

/netconf-state/sessions/session/username: Contains identity information that could be used in an attempt to authenticate with the server.

/ NETCONF状態/セッション/セッション/ユーザー名:サーバーで認証しようとする試みに使用できるID情報が含まれています。

This username is only meant for monitoring, and SHOULD NOT be used for other purposes, such as access control, without a detailed discussion of the limitations of this reported username. For example, it is possible that server A and server B might report the same username, but these might be for different persons.

このユーザ名は、監視のためのものであり、この報告のユーザー名の制限の詳細な議論なしに、このようなアクセス制御などの他の目的には使用しないでください。たとえば、サーバーAとサーバーBが同じユーザー名を報告することがありますことは可能であるが、これらは別の人のためかもしれません。

7. Acknowledgements
7.謝辞

The authors would like to thank Andy Bierman, Mehmet Ersue, Washam Fan, David Harrington, Balazs Lengyel, Hideki Okita, Juergen Schoenwaelder, Bert Wijnen, and many other members of the NETCONF WG for providing important input to this document. The authors would also like to specifically acknowledge Sharon Chisholm's work on "NETCONF Monitoring Schema" [NETCONF] and contribution to this document.

作者はこのドキュメントへの重要なインプットを提供するためのアンディBierman、メフメットErsue、Washamファン、デヴィッドハリントン、バラージュLengyel、英樹沖田、ユルゲンSchoenwaelder、バートWijnen、およびNETCONF WGの多くの他のメンバーに感謝したいと思います。著者はまた、特に[NETCONF]「NETCONFの監視スキーマ」のシャロン・チザムの仕事を認め、この文書に貢献したいと思います。

8. IANA Considerations
8. IANAの考慮事項

This document registers one URI in "The IETF XML Registry". Following the format in [RFC3688], the following has been registered.

この文書では、「IETF XMLレジストリ」で1つのURIを登録します。 [RFC3688]でフォーマットした後、次のように登録されています。

URI: urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring Registrant Contact: The IESG. XML: N/A, the requested URI is an XML namespace.

URI:URN:IETF:のparams:XML:NS:ヤン:IETF-NETCONF監視登録者連絡先:IESG。 XML:N / Aは、要求されたURIは、XML名前空間があります。

This document registers one module in the "YANG Module Names" registry. Following the format in [RFC6020], the following has been registered.

この文書は、「YANGモジュール名」レジストリに一つのモジュールを登録します。 [RFC6020]でフォーマットした後、次のように登録されています。

name: ietf-netconf-monitoring namespace: urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring prefix: ncm reference: RFC 6022

名前:IETF-NETCONF監視名前空間:URN:IETF:のparams:XML:NS:ヤン:IETF-NETCONF監視接頭辞:NCM参照:RFC 6022

9. References
9.参考文献
9.1. Normative References
9.1. 引用規格

[ISO/IEC19757-2:2008] ISO/IEC, "Document Schema Definition Language (DSDL) -- Part 2: Regular-grammar-based validation -- RELAX NG", December 2008, <http://www.iso.org/iso/ catalogue_detail.htm?csnumber=37605>.

[ISO / IEC19757-2:2008] ISO / IEC、 "文書スキーマ定義言語(DSDL) - パート2:レギュラー文法ベースの検証 - NGをRELAX"、2008年12月、<のhttp://www.iso。 ORG / ISO / catalogue_detail.htm?csnumber = 37605>。

[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997.

[RFC2119]ブラドナーの、S.、 "要件レベルを示すためにRFCsにおける使用のためのキーワード"、BCP 14、RFC 2119、1997年3月。

[RFC4741] Enns, R., "NETCONF Configuration Protocol", RFC 4741, December 2006.

[RFC4741]エンス、R.、 "NETCONF構成プロトコル"、RFC 4741、2006年12月。

[RFC4742] Wasserman, M. and T. Goddard, "Using the NETCONF Configuration Protocol over Secure SHell (SSH)", RFC 4742, December 2006.

[RFC4742]ワッサーマン、M.とT.ゴダード、 "セキュアシェル上でNETCONF構成プロトコルを使用して(SSH)"、RFC 4742、2006年12月。

[RFC4743] Goddard, T., "Using NETCONF over the Simple Object Access Protocol (SOAP)", RFC 4743, December 2006.

[RFC4743]ゴダード、T.、RFC 4743、2006年12月 "簡易オブジェクトアクセスプロトコル(SOAP)の上にNETCONFを使用します"。

[RFC4744] Lear, E. and K. Crozier, "Using the NETCONF Protocol over the Blocks Extensible Exchange Protocol (BEEP)", RFC 4744, December 2006.

[RFC4744]リア、E.およびK.クロージャー、 "ブロック拡張可能交換プロトコル(BEEP)の上にNETCONFプロトコルの使用"、RFC 4744、2006年12月。

[RFC5539] Badra, M., "NETCONF over Transport Layer Security (TLS)", RFC 5539, May 2009.

[RFC5539] Badra、M.、RFC 5539、2009年5月、 "トランスポート層セキュリティ(TLS)の上にNETCONF"。

[RFC5717] Lengyel, B. and M. Bjorklund, "Partial Lock Remote Procedure Call (RPC) for NETCONF", RFC 5717, December 2009.

[RFC5717] Lengyel、B.とM. Bjorklund、 "NETCONFのための操作ロックリモートプロシージャコール(RPC)"、RFC 5717、2009年12月。

[RFC6020] Bjorklund, M., Ed., "YANG - A Data Modeling Language for the Network Configuration Protocol (NETCONF)", October 2010.

[RFC6020] Bjorklund、M.、エド、 "YANG - ネットワーク構成プロトコルのためのデータモデリング言語(NETCONF)"。2010年10月。

[RFC6021] Schoenwaelder, J., Ed., "Common YANG Data Types", October 2010.

[RFC6021] Schoenwaelder、J.、エド。、 "共通YANGデータ型"、2010年10月。

[XML-NAMES] Hollander, D., Tobin, R., Thompson, H., Bray, T., and A. Layman, "Namespaces in XML 1.0 (Third Edition)", World Wide Web Consortium Recommendation REC-xml-names-20091208, December 2009, <http://www.w3.org/TR/2009/REC-xml-names-20091208>.

[XML-NAMES]オランダ、D.、トービン、R.、トンプソン、H.、ブレイ、T.、およびA.素人、 "XML 1.0での名前空間(第3版)"、ワールドワイドウェブコンソーシアム勧告REC-XML-名前-20091208、2009年12月、<http://www.w3.org/TR/2009/REC-xml-names-20091208>。

[xmlschema-1] Biron, Paul V. and Ashok. Malhotra, "XML Schema Part 1: Structures Second Edition W3C Recommendation 28 October 2004", October 2004, <http://www.w3.org/TR/xmlschema-1>.

[XMLSCHEMA-1]ビロン、ポールV.とアショク。マルホトラ、 "XMLスキーマパート1:構造Second EditionのW3C勧告2004年10月28日"、2004年10月、<http://www.w3.org/TR/xmlschema-1>。

9.2. Informative References
9.2. 参考文献
              [NETCONF]  Chisholm, S. and H. Trevino, "NETCONF
              Monitoring Schema", Work in Progress, February 2007.
        

[RFC0959] Postel, J. and J. Reynolds, "File Transfer Protocol", STD 9, RFC 959, October 1985.

[RFC0959]ポステル、J.、およびJ.レイノルズ、 "ファイル転送プロトコル"、STD 9、RFC 959、1985年10月。

[RFC2616] Fielding, R., Gettys, J., Mogul, J., Frystyk, H., Masinter, L., Leach, P., and T. Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1", RFC 2616, June 1999.

[RFC2616]フィールディング、R.、ゲティス、J.、モーグル、J.、Frystyk、H.、Masinter、L.、リーチ、P.、およびT.バーナーズ - リー、 "ハイパーテキスト転送プロトコル - HTTP / 1.1" 、RFC 2616、1999年6月。

[RFC2818] Rescorla, E., "HTTP Over TLS", RFC 2818, May 2000.

[RFC2818]レスコラ、E.、 "TLSオーバーHTTP"、RFC 2818、2000年5月。

[RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, January 2004.

[RFC3688] Mealling、M.、 "IETF XMLレジストリ"、BCP 81、RFC 3688、2004年1月。

Authors' Addresses

著者のアドレス

Mark Scott Ericsson 3500 Carling Ave Nepean, Ontario K2H 8E9 Canada

マーク・スコット・エリクソン3500カーリングアベニューオタワ、オンタリオK2H 8E9カナダ

EMail: mark.scott@ericsson.com

メールアドレス:mark.scott@ericsson.com

Martin Bjorklund Tail-f Systems Klara Norra Kyrkogata 31 SE-111 22 Stockholm, Sweden

マーティンBjorklundテール-Fシステムの準備北部Kyrkogata 31 SE-111 22ストックホルム、スウェーデン

EMail: mbj@tail-f.com

メールアドレス:mbj@tail-f.com