この文書はRFC6022の日本語訳です。 この文書の翻訳内容の正確さは保障できないため、 正確な知識を求める方は原文を参照してください。 翻訳者はこの文書によって読者が被り得る如何なる損害の責任をも負いません。 この翻訳内容に誤りがある場合、訂正版の公開や、 誤りの指摘は適切です。 この文書の配布は元のＲＦＣ同様に無制限です。
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
NETCONF監視のためのYANGモジュール
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-schema>オペレーションを定めます。
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の２章を参照してください。
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.
著作権（Ｃ）２０１０、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信託のIETF文書に関連
する法的条項（http://trustee.ietf.org/license-info）の対象となりま
す。これらの文書は、この文書に関するあなたの権利と制限を説明してい
るので、注意深く確認してください。この文書内のプログラムコードの利
用には、IETF信託の法的条項の4.e章に記載されているSimplified BSD
Licenseテキストを含める必要があり、Simplified BSD Licenseに記載さ
れている保証なしで提供されます。
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.
この文書には、2008年11月10日より前に公開されたIETF文書またはIETF寄贈
資料が含まれる場合があります。この資料の一部の著作権を管理する人は、
IETF標準手続以外で、IETF信託にこのような資料の変更を許可する権利を付
与していない可能性があります。そのような資料の著作権を管理する人物か
ら適切な許可を取得しない場合、RFCとしての公開や英語以外の言語への翻
訳を除き、この文書はIETF標準手続以外で、修正できず２次的著作物を作れ
ないかもしれません。
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.
NETCONFで明白なスキーマ検索をサポートするために、新しい<get-schema>
オペレーションが定められます。
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"と
"SHALL NOT"と"SHOULD"と"SHOULD NOT"と"RECOMMENDED"と"MAY"と
"OPTIONAL"はBCP 14 [RFC2119]で説明されるように解釈されるべきです。
2. Data Model to Monitor NETCONF
2. NETCONFをモニターするデータモデル
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プロトコル）に
特有の詳細（例えば'in-sessions'の様なプロトコル固有のカウンタ）とス
キーマ検索に関連したデータ（例えば、スキーマ・リスト）を含みます。
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:yang:ietf-netconf-monitoring")を実装するサー
バーは[RFC6020]で定められる能力URIを通知しなければなりません(MUST)。
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-stateサブツリー
The netconf-state container is the root of the monitoring data model.
netconf-stateコンテナはモニタリングデータモデルのルートです。
netconf-state
/capabilities
/datastores
/schemas
/sessions
/statistics
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-state/capabilitiesサブツリー
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-state/datastoresサブツリーは、NETCONFサーバーがサポートす
る能力を含みます。リストは、セッション設定時に交換され、要求時にまだ
有効なすべての能力を含みます。
2.1.2. The /netconf-state/datastores Subtree
2.1.2. /netconf-state/datastoresサブツリー
The /netconf-state/datastores subtree contains the list of available
datastores for the NETCONF server and includes information on their
lock state.
/netconf-state/datastoresサブツリーは、NETCONFサーバーで利用できる
データストアのリストを含み、それらのロック状態に関する情報を含みます。
datastore
/name
/locks
name (leaf, netconf-datastore-type)
(末端, netconfデータストア型)
Enumeration of supported datastores; candidate, running, startup.
サポートするデータストアの列挙; 候補、ランニング、スタートアップ.
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. The /netconf-state/schemasサブツリー
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.
identifierとversionとformatが、スキーマリストのキーとして使われます。
これらは<get-schema>オペレーションで使われます。
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-schema>オペレーションで使
われ、ファイル検索のような他の手段で使われる場合があります。
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サーバー複数のバージョ
ンを同時にサポートするかもしれません (MAY)。各バージョンはスキーマ
リストで個別に報告されなければなりません(MUST)、これは同じ識別子で、
もしかしたら異なる場所で、異なるバージョンです。
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.
YANGデータモデルで、バージョンはモジュールまたはサブモジュールの最
新のYANG'revision'文の値か、'revision'文がなければ空文字列です。
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).
スキーマが書かれるデータモデル化言語。データモデル化言語はYANG識
別子で表現されます。この文書は"xsd"と"yang"と"yin"と"rng"と"rnc"の
識別子を定めます(5章参照)。
namespace (inet:uri)
The Extensible Markup Language (XML) namespace [XML-NAMES] defined
by the schema.
スキーマが定義する拡張マークアップ言語(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.
この特定のスキーマを得られる一つ以上の場所。リストはスキーマ毎に少
なくとも１つの項目を含むべきです(SHOULD)。
2.1.4. The /netconf-state/sessions Subtree
2.1.4. The /netconf-state/sessionsサブツリー
Includes session-specific data for NETCONF management sessions. The
session list MUST include all currently active NETCONF sessions.
NETCONF管理セッションのセッション固有データを含みます。セッションリ
ストは、現在有効なNETCONFセッションの全てを含まなければなりません(MUST)。
session
/session-id (key)
/transport
/username
/source-host
/login-time
/in-rpcs
/in-bad-rpcs
/out-rpc-errors
/out-notifications
session-id (uint32, 1..max)
Unique identifier for the session. This value is the NETCONF
session identifier, as defined in [RFC4741].
セッションを一意に示す識別子。この値は[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).
各セッションのトランスポートを示します。トランスポートYANG識別子で
書かれます。この文書は識別子の"netconf-ssh"と"netconf-soap-over-beep"
と"netconf-soap-over-https"と"netconf-beep"と"netconf-tls"を定めま
す（5章参照）。
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トランスポートプロトコルによって認証された
クライアント識別子です。ユーザー名を得るのに用いられるアルゴリズ
ムは、NETCONFトランスポートプロトコル固有で、NETCONFトランスポー
トプロトコルによって使われる認証メカニズムにも固有です。
source-host (inet:host)
Host identifier (IP address or name) of the NETCONF client.
NETCONFクライアントのホスト識別子（IPアドレスまたは名前）。
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>メッセージの数。
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>メッセージを待つ際に正しくない<rpc>メッセージを受け取った数。
これはXMLパースエラーとrpc層のエラーを含みます。
out-rpc-errors (yang:zero-based-counter32)
Number of <rpc-reply> messages sent that contained an <rpc-error>
element.
<rpc-error>要素をを含んだ<rpc-reply>メッセージの数。
out-notifications (yang:zero-based-counter32)
Number of <notification> messages sent.
送信した<notification>メッセージの数。
2.1.5. The /netconf-state/statistics Subtree
2.1.5. The /netconf-state/statisticsサブツリー
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
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.
管理サブシステムが動作開始した日付と時間。
in-bad-hellos (yang:zero-based-counter32)
Number of sessions silently dropped because an invalid <hello>
message was received.
無効な<hello>メッセージを受信して黙って破棄したセッションの数。
in-sessions (yang:zero-based-counter32)
Number of sessions started.
開始したセッションの数。
dropped-sessions (yang:zero-based-counter32)
Number of sessions that were abnormally terminated, e.g., due to
idle timeout or transport close.
例えば、タイムアウトやトランスポートの終了など異常終了したセッ
ションの数。
in-rpcs (yang:zero-based-counter32)
Number of correct <rpc> messages received.
正しい<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>を待つ際に受信した正しくない<rpc>メッセージの数。
out-rpc-errors (yang:zero-based-counter32)
Number of <rpc-reply> messages sent that contained an <rpc-error>
element.
<rpc-error>要素を含む<rpc-reply>メッセージの送信数。
out-notifications (yang:zero-based-counter32)
Number of <notification> messages sent.
<notification>メッセージの送信数。
3. Schema Specific Operations
3. スキーマ固有のオペレーション
3.1. The <get-schema> Operation
3.1. The <get-schema>オペレーション
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.
スキーマのデータモデル化言語。
指定されないときのデフォルト値は'yang'です。
任意パラメータ。
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'.
要求されたスキーマが存在しないならば、<error-tag>は
'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'.
要求されたパラメータに一致するスキーマが複数の場合、<error-tag>
は'operation-failed'で<error-app-tag>は'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クライアントは、<get>オペレーションで/netconf-state/schemasサ
ブツリーを読み出すことで、NETCONFサーバーからサポートされたスキーマの
リストを読み出せます。
Available schema for the requesting session are returned in the reply
containing the <identifier>, <version>, <format>, and <location>
elements.
要求したセッションで利用できるスキーマは応答で返され、これには
<identifier>と<version>と<format>と<location>要素が含まれます。
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.
反応データは、利用できるスキーマとそのバージョンを決定するのに用いる
ことができます。スキーマ自体（スキーマ内容）は、応答では返されません。
任意で設定される<location>要素は、URIむ場合はスキーマはFTP[RFC0959]
やhttp(s) [RFC2616] [RFC2818]のような他のプロトコルで得られ、特別な
値'NETCONF'を含む場合はスキーマはデバイスから<get-schema>オペレーショ
ンで得られます。
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>
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>
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'と'bar'と'bar-types'のスキー
マを複数の場所で、複数のフォーマットで、複数のロケーションで検索する
例です。
1. foo, version 1.0 in xsd format:
fooのバージョン1.0をxsdフォーマットで:
a. Via FTP using location
ロケーションを使いFTPで
ftp://ftp.example.com/schemas/foo_1.0.xsd
b. Via HTTP using location
ロケーションを使いHTTPで
http://www.example.com/schema/foo_1.0.xsd
c. Via <get-schema> using identifier, version, and
format parameters.
identifierとversionとformaパラメータを使い<get-schema>で
<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-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>
2. bar, version 2008-06-01 in YANG format:
barのバージョン2008-06-01をYANGフォーマットで:
a. Via HTTP using location
ロケーションを使いHTTPで
http://example.com/schema/bar@2008-06-01.yang
b. Via <get-schema> using identifier and version
parameters:
identifierとversionパラメータを使い<get-schema>で
<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-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>
3. bar-types, version 2008-06-01 in default YANG format:
bar-typesのバージョン2008-06-01をデフォルトのYANGフォーマットで:
a. Via <get-schema> using identifer parameter:
identifierパラメータを使い<get-schema>で
<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-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>
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].
このYANGモジュールは[RFC6021]の型定義をインポートし、[RFC4741]と
[RFC4742]と[RFC4743]と[RFC4744]と[RFC5539]と[xmlschema-1]と[RFC6020]
と[ISO/IEC19757-2:2008]と[RFC5717]を参照します。
<CODE BEGINS> file "ietf-netconf-monitoring@2010-10-04.yang"
module ietf-netconf-monitoring {
namespace "urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring";
prefix "ncm";
import ietf-yang-types { prefix yang; }
import ietf-inet-types { prefix inet; }
organization
"IETF NETCONF (Network Configuration) Working Group";
contact
"WG Web: <http://tools.ietf.org/wg/netconf/>
WG List: <mailto:netconf@ietf.org>
WG Chair: Mehmet Ersue
<mailto:mehmet.ersue@nsn.com>
WG Chair: Bert Wijnen
<mailto:bertietf@bwijnen.net>
Editor: Mark Scott
<mailto:mark.scott@ericsson.com>
Editor: Martin 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) 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
許可は、IETF文書に関するIETF信託の法的準備の4.c章で述べられます
(http://trustee.ietf.org/license-info).
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.
可能なNETCONFデータストアタイプの列挙";
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).
セキュアシェル(SSH)上のNETCONF";
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).
ブロック拡張可能交換プロトコル(BEEP)上の単純オブジェクトアクセス
プロトコル(SOAP)上のNETCONF";
reference
"RFC 4743: Using NETCONF over the Simple Object
Access Protocol (SOAP)";
}
identity netconf-soap-over-https {
base transport;
description
"NETCONF over Simple Object Access Protocol (SOAP)
over Hypertext Transfer Protocol Secure (HTTPS).
安全超文書転送プロトコル(HTTP)上の単純オブジェクトアクセス
プロトコル(SOAP)上のNETCONF";
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).
ブロック拡張可能交換プロトコル(BEEP)上のNETCONF";
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).
トランスポートセキュリティ(TLS)上のNETCONF";
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.
W3C XMLスキーマ定義";
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.
NETCONFのためのYANGデータモデリング言語";
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.
YANGのYIN文法";
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).
次世代XMLの正規言語(RELAX NG)";
reference
"ISO/IEC 19757-2:2008: RELAX NG";
}
identity rnc {
base schema-format;
description
"Relax NG Compact Syntax
Relax NG小さい構文";
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.
受信した正しい<rpc>メッセージの数";
}
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.
<rpc>メッセージを待つときに受信した正しくない<rpc>メッセージの
数。これはXMLパースエラーとrpc層のエラーを含みます。";
}
leaf out-rpc-errors {
type yang:zero-based-counter32;
description
"Number of <rpc-reply> messages sent that contained an
<rpc-error> element.
<rpc-error>要素を含む<rpc-reply>メッセージ送信数";
}
leaf out-notifications {
type yang:zero-based-counter32;
description
"Number of <notification> messages sent.
<notification>メッセージ送信数";
}
}
container netconf-state {
config false;
description
"The netconf-state container is the root of the monitoring
data model.
netconf-stateカウンタはモニタリングデータモデルのルートです";
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.
サーバのサポートするNETCONF能力のリスト";
}
}
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.
NETCONFサーバーのサポートするNETCONFコンフィギュレーション
データストアと関連情報";
leaf name {
type netconf-datastore-type;
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).
NETCONFの<lock>と<partial-lock>オペレーションでクライアント
がデータストア特定の資源をロックできます。NETCONFサーバーは、
ロックをしたセッション以外のセッションが、ロックされた資源を
変更するのを防止します。
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.
この資源をロックしたセッションのセッションID。
全体と一部のロックの両方でNETCONFセッションIDを
含まなければなりません(MUST)。
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.
NETCONFサーバーで管理されないセッション（例えば、CLI
セッション）がロックが持つならば、0（ゼロ）のセッション
IDが報告されます。";
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.
これは<partial-lock>で返されるロックIDです";
}
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.
ロックを要求するのに用いられたxpath式。
選択表現は、ロックの最初の意図された範囲を示します。";
}
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-schema>
オペレーションで使用され、ファイル読み込みような他の目的で
使われるかもしれません。
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.
データモデル名（例えば、YANGモジュール名）をサポートするか
必要とするモデル言語で、識別子その名前に一致しなければなり
ません。YANGデータモデルで、識別子はモジュールまたはサブモ
ジュールの名前です。その他の場合、ファイル名のような識別子
が代わりに使われるかもしれません。";
}
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.
サポートされるスキーマのバージョン。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.
YANGデータ・モデルで、バージョンはモジュールまたはサブモ
ジュールの最新の'revision'文の値で、'revision'文がなければ
空文字列です。";
}
leaf format {
type identityref {
base schema-format;
}
description
"The data modeling language the schema is written
in (currently xsd, yang, yin, rng, or rnc).
スキーマが書かれるデータモデル化言語（現在はxsdかyangか
yinかrngかrnc）をしているデータ。
For YANG data models, 'yang' format MUST be supported and
'yin' format MAY also be provided.
YANGデータモデルで、'yang'フォーマットはサポートしなければ
ならず、'yin フォーマットが提供されるかもしれません";
}
leaf namespace {
type inet:uri;
mandatory true;
description
"The XML namespace defined by the data model.
データモデルによって定義されるXML名前空間。
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.
YANGデータモデルで、これはモジュールの名前空間です。
リスト項目がサブモジュールを記述するならば、サブモジュール
が属するモジュールの名前空間を、このフィールドは含みます。";
}
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').
スキーマ項目は遠隔ファイルシステムに置かれるかもしれず
（例えば、ftp検索のためのファイルシステムを参照）、
<get-schema>オペレーションをサポートするサーバから直接
得られるかもしれません(値'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.
NETCONF管理セッションのセッション固有データを含むセッション
コンテナ。セッションリストは現在有効な全てのNETCONFセッショ
ンを含まなければなりません";
list session {
key session-id;
description
"All NETCONF sessions managed by the NETCONF server
MUST be reported in this list.
NETCONFサーバーで管理される全NETCONFセッションが
このリストで報告されます。の間ずっと";
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.
「セッションの一意な識別子。この値はRFC 4741で定義される
NETCONFセッション識別子です。";
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.
セッションが使うトランスポートの識別、例えば'netconf-ssh'
や'netconf-soap'など";
}
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.
usernameは、NETCONFトランスポートプロトコルによって認証さ
れたクライアント識別子です。usernameを得るために用いられる
アルゴリズムは、NETCONFトランスポートプロトコル固有で、
NETCONFトランスポートプロトコルによって使われる認証メカ
ニズムも固有です。";
}
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)
NETCONFクライアントのホスト識別子。返される値は実装依存
です（例えば、ホスト名、IPv4アドレス、IPv6アドレス）";
}
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.
無効な<hello>メッセージの受信で黙って終了したセッションの
数、これは<hello>メッセージに'session-id'属性が含まれていた
場合や間違った名前空間や間違った能力宣言を含みます。";
}
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.
セッションの開始数。このカウンターは<session-id>付きの
<hello>メッセージを送った時に増加します。
'in-sessions' - 'in-bad-hellos' =
'number of correctly started netconf sessions'
'正しく開始したnetconfセッションの数'";
}
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.
例えば、アイドルタイムアウトやトランスポート終了により、異常
終了したセッションの数。セッションが<close-session>できちんと
閉じられるときや、<kill-session>オペレーションで終了する時、
このカウンターは増加しません";
}
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
全セッションで計算する全体カウンター。
以下のリセットの状況でゼロとなる：。
- NETCONFサーバーの再初期化
- 最大価値に達するとき";
}
}
}
rpc get-schema {
description
"This operation is used to retrieve a schema from the
NETCONF server.
このオペレーションは、NETCONFサーバーからスキーマを検索するのに
用いられます。
Positive Response:
The NETCONF server returns the requested schema.
正常応答：
NETCONFサーバーは、要求されたスキーマを返します。
Negative Response:
If requested schema does not exist, the <error-tag> is
'invalid-value'.
エラー応答：
要求されたスキーマが存在しないならば<error-tag>は
'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'.
複数のスキーマが要求されたパラメータに一致するならば、
<error-tag>は'operation-failed'で<error-app-tag>は
'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.
要求されるスキーマのバージョン。このパラメータが存在せず複数
のバージョンのスキーマがサーバーに存在するならば、先に述べた
ように'data-not-unique'エラーが返されます。」";
}
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.
スキーマのデータモデル化言語。このパラメータが存在せず、サー
バーにスキーマの複数のフォーマットが存在するならば、先に述
べたように、'data-not-unique'エラーが返されます。";
}
}
output {
anyxml data {
description
"Contains the schema content.
スキーマコンテンツを含みます。";
}
}
}
}
<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やget-configやnotificationによる)読みアクセス権を管理すること
は重要です。
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.
サーバーで認証する際に使われた識別子情報を含みます。
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.
このusernameはモニタリングのためだけ有効で、この報告されたusername
の制約に関する詳細な議論なしで、アクセス制御の様な、他の目的で使わ
ないべきです(SHOULD NOT)。たとえば、サーバーAとサーバーBが同じ
usernameを報告するかもしれないかもしれないですが、これらは異なる人
かもしれません。
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.
著者はこの文書に重要な入力をした、Andy BiermanとMehmet Ersueと
Washam FanとDavid HarringtonとBalazs LengyelとHideki Okitaと
Juergen SchoenwaelderとBert WijnenとNETCONF WGの多くの他のメンバー
に感謝します。著者は、特に「NETCONF Monitoring Schema」[NETCONF]とこの
文書に対するSharon Chisholmの貢献に関して特に感謝します。
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.
この文書は"The IETF XML Registry"に１つの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.
This document registers one module in the "YANG Module Names"
registry. Following the format in [RFC6020], the following has been
registered.
この文書は"YANG Module Names"登録所で１つのモジュールを登録します。
[RFC6020]のフォーマットに従って、以下は登録されました。
name: ietf-netconf-monitoring
namespace: urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring
prefix: ncm
reference: 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>.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC4741] Enns, R., "NETCONF Configuration Protocol", RFC 4741,
December 2006.
[RFC4742] Wasserman, M. and T. Goddard, "Using the NETCONF
Configuration Protocol over Secure SHell (SSH)", RFC 4742,
December 2006.
[RFC4743] Goddard, T., "Using NETCONF over the Simple Object Access
Protocol (SOAP)", RFC 4743, December 2006.
[RFC4744] Lear, E. and K. Crozier, "Using the NETCONF Protocol over
the Blocks Extensible Exchange Protocol (BEEP)", RFC 4744,
December 2006.
[RFC5539] Badra, M., "NETCONF over Transport Layer Security (TLS)",
RFC 5539, May 2009.
[RFC5717] Lengyel, B. and M. Bjorklund, "Partial Lock Remote
Procedure Call (RPC) for NETCONF", RFC 5717,
December 2009.
[RFC6020] Bjorklund, M., Ed., "YANG - A Data Modeling Language for
the Network Configuration Protocol (NETCONF)",
October 2010.
[RFC6021] Schoenwaelder, J., Ed., "Common YANG Data Types",
October 2010.
[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>.
[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>.
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.
[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.
[RFC2818] Rescorla, E., "HTTP Over TLS", RFC 2818, May 2000.
[RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688,
January 2004.
Authors' Addresses
著者のアドレス
Mark Scott
Ericsson
3500 Carling Ave
Nepean, Ontario K2H 8E9
Canada
EMail: mark.scott@ericsson.com
Martin Bjorklund
Tail-f Systems
Klara Norra Kyrkogata 31
SE-111 22 Stockholm,
Sweden
EMail: mbj@tail-f.com