NETCONFイベント通知
英文を機械翻訳で日本語訳としています。日本語訳が正しくないことが考えられますので原文をメインとし、参考程度にご利用ください。
日本語訳
Network Working Group S. Chisholm
Request for Comments: 5277 Nortel
Category: Standards Track H. Trevino
Cisco
July 2008
NETCONF Event Notifications
NETCONFイベント通知
Status of This Memo
このメモのステータス
This document specifies an Internet standards track protocol for the Internet community, and requests discussion and suggestions for improvements. Please refer to the current edition of the "Internet Official Protocol Standards" (STD 1) for the standardization state and status of this protocol. Distribution of this memo is unlimited.
このドキュメントは、インターネットコミュニティ用のインターネット標準トラックプロトコルを指定し、改善のための議論と提案を要求します。 このプロトコルの標準化状態とステータスについては、「インターネット公式プロトコル標準」（STD 1）の最新版を参照してください。 このメモの配布は無制限です。
Abstract
This document defines mechanisms that provide an asynchronous message notification delivery service for the Network Configuration protocol (NETCONF). This is an optional capability built on top of the base NETCONF definition. This document defines the capabilities and operations necessary to support this service.
このドキュメントでは、ネットワーク構成プロトコル（NETCONF）に非同期メッセージ通知配信サービスを提供するメカニズムを定義します。 これは、基本NETCONF定義の上に構築されたオプション機能です。 このドキュメントでは、このサービスをサポートするために必要な機能と操作を定義します。
Chisholm & Trevino Standards Track [Page 1]
RFC 5277 NETCONF Event Notifications July 2008
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.1. Definition of Terms . . . . . . . . . . . . . . . . . . . 3
1.2. Motivation . . . . . . . . . . . . . . . . . . . . . . . . 4
1.3. Event Notifications in NETCONF . . . . . . . . . . . . . . 5
2. Notification-Related Operations . . . . . . . . . . . . . . . 5
2.1. Subscribing to Receive Event Notifications . . . . . . . . 5
2.1.1. <create-subscription> . . . . . . . . . . . . . . . . 6
2.2. Sending Event Notifications . . . . . . . . . . . . . . . 9
2.2.1. <notification> . . . . . . . . . . . . . . . . . . . . 9
2.3. Terminating the Subscription . . . . . . . . . . . . . . . 9
3. Supporting Concepts . . . . . . . . . . . . . . . . . . . . . 10
3.1. Capabilities Exchange . . . . . . . . . . . . . . . . . . 10
3.1.1. Capability Identifier . . . . . . . . . . . . . . . . 10
3.1.2. Capability Example . . . . . . . . . . . . . . . . . . 10
3.2. Event Streams . . . . . . . . . . . . . . . . . . . . . . 10
3.2.1. Event Stream Definition . . . . . . . . . . . . . . . 12
3.2.2. Event Stream Content Format . . . . . . . . . . . . . 12
3.2.3. Default Event Stream . . . . . . . . . . . . . . . . . 12
3.2.4. Event Stream Sources . . . . . . . . . . . . . . . . . 12
3.2.5. Event Stream Discovery . . . . . . . . . . . . . . . . 12
3.3. Notification Replay . . . . . . . . . . . . . . . . . . . 15
3.3.1. Overview . . . . . . . . . . . . . . . . . . . . . . . 15
3.3.2. Creating a Subscription with Replay . . . . . . . . . 16
3.4. Notification Management Schema . . . . . . . . . . . . . . 16
3.5. Subscriptions Data . . . . . . . . . . . . . . . . . . . . 20
3.6. Filter Mechanics . . . . . . . . . . . . . . . . . . . . . 20
3.6.1. Filtering . . . . . . . . . . . . . . . . . . . . . . 20
3.7. Message Flow . . . . . . . . . . . . . . . . . . . . . . . 20
4. XML Schema for Event Notifications . . . . . . . . . . . . . . 22
5. Filtering Examples . . . . . . . . . . . . . . . . . . . . . . 26
5.1. Subtree Filtering . . . . . . . . . . . . . . . . . . . . 28
5.2. XPATH Filters . . . . . . . . . . . . . . . . . . . . . . 29
6. Interleave Capability . . . . . . . . . . . . . . . . . . . . 30
6.1. Description . . . . . . . . . . . . . . . . . . . . . . . 30
6.2. Dependencies . . . . . . . . . . . . . . . . . . . . . . . 30
6.3. Capability Identifier . . . . . . . . . . . . . . . . . . 30
6.4. New Operations . . . . . . . . . . . . . . . . . . . . . . 31
6.5. Modifications to Existing Operations . . . . . . . . . . . 31
7. Security Considerations . . . . . . . . . . . . . . . . . . . 31
8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 32
9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 33
10. Normative References . . . . . . . . . . . . . . . . . . . . . 33
1.はじめに. . . . . . . . . . . . . . . . . . . . . . . . . ３
1.1.用語の定義 . . . . . . . . . . . . . . . . . . . ３
1.2.動機 . . . . . . . . . . . . . . . . . . . . . . . . 4
1.3. NETCONFのイベント通知. . . . . . . . . . . . . . 5
2.通知関連の操作. . . . . . . . . . . . . . . 5
2.1.イベント通知の受信をサブスクライブします. . . . . . . . 5
2.1.1. <create-subscription>. . . . . . . . . . . . . . . . 6
2.2.イベント通知の送信. . . . . . . . . . . . . . . 9
2.2.1. <通知>. . . . . . . . . . . . . . . . . . . . 9
2.3.サブスクリプションの終了. . . . . . . . . . . . . . . 9
3.サポートの概念. . . . . . . . . . . . . . . . . . . . . 10
3.1.能力交換. . . . . . . . . . . . . . . . . . 10
3.1.1.能力識別子. . . . . . . . . . . . . . . . 10
3.1.2.能力の例. . . . . . . . . . . . . . . . . . 10
3.2.イベントストリーム. . . . . . . . . . . . . . . . . . . . . . 10
3.2.1.イベントストリーム定義. . . . . . . . . . . . . . . 12
3.2.2.イベントストリームコンテンツフォーマット. . . . . . . . . . . . . 12
3.2.3.デフォルトのイベントストリーム. . . . . . . . . . . . . . . . . 12
3.2.4.イベントストリームソース. . . . . . . . . . . . . . . . . 12
3.2.5.イベントストリームディスカバリー. . . . . . . . . . . . . . . . 12
3.3.通知の再生. . . . . . . . . . . . . . . . . . . 15
3.3.1.概要. . . . . . . . . . . . . . . . . . . . . . . 15
3.3.2.リプレイによるサブスクリプションの作成. . . . . . . . . 16
3.4.通知管理スキーマ. . . . . . . . . . . . . . 16
3.5.サブスクリプションデータ. . . . . . . . . . . . . . . . . . . . 20
3.6.フィルター力学. . . . . . . . . . . . . . . . . . . . . 20
3.6.1.フィルタリング. . . . . . . . . . . . . . . . . . . . . . 20
3.7.メッセージフロー. . . . . . . . . . . . . . . . . . . . . . . 20
4.イベント通知のXMLスキーマ. . . . . . . . . . . . . . 22
5.フィルタリングの例. . . . . . . . . . . . . . . . . . . . . . 26
5.1.サブツリーフィルタリング. . . . . . . . . . . . . . . . . . . . 28
5.2. XPATHフィルター. . . . . . . . . . . . . . . . . . . . . . 29
6.インターリーブ機能. . . . . . . . . . . . . . . . . . . . 30
6.1.説明. . . . . . . . . . . . . . . . . . . . . . . 30
6.2.依存関係. . . . . . . . . . . . . . . . . . . . . . . 30
6.3.能力識別子. . . . . . . . . . . . . . . . . . 30
6.4.新しいオペレーション. . . . . . . . . . . . . . . . . . . . . . 31
6.5.既存のオペレーションの変更. . . . . . . . . . . 31
7.セキュリティに関する考慮事項. . . . . . . . . . . . . . . . . . . 31
8. IANAの考慮事項. . . . . . . . . . . . . . . . . . . . . 32
9.謝辞. . . . . . . . . . . . . . . . . . . . . . . 33
10.規範的な参照. . . . . . . . . . . . . . . . . . . . . 33
Chisholm & Trevino Standards Track [Page 2] RFC 5277 NETCONF Event Notifications July 2008 1. Introduction
[NETCONF] can be conceptually partitioned into four layers:
[NETCONF]は概念的に4つのレイヤーに分割できます。
Layer Example
+-------------+ +-------------------------------------------+
| Content | | Configuration data |
+-------------+ +-------------------------------------------+
| |
+-------------+ +-------------------------------------------+
| Operations | |<get-config>, <edit-config>, <notification>|
+-------------+ +-------------------------------------------+
| | |
+-------------+ +-----------------------------+ |
| RPC | | <rpc>, <rpc-reply> | |
+-------------+ +-----------------------------+ |
| | |
+-------------+ +-------------------------------------------+
| Transport | | BEEP, SSH, SSL, console |
| Protocol | | |
+-------------+ +-------------------------------------------+
Figure 1
This document defines mechanisms that provide an asynchronous message
notification delivery service for the [NETCONF] protocol. This is an
optional capability built on top of the base NETCONF definition.
This memo defines the capabilities and operations necessary to
support this service.
このドキュメントでは、[NETCONF]プロトコルに非同期メッセージ通知配信サービスを提供するメカニズムを定義します。 これは、基本NETCONF定義の上に構築されたオプション機能です。 このメモは、このサービスをサポートするために必要な機能と操作を定義します。
1.1. Definition of Terms
1.1。 用語の定義
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC2119].
Element: An [XML] Element.
Subscription: An agreement and method to receive event notifications
over a NETCONF session. A concept related to the delivery of
notifications (if there are any to send) involving destination and
selection of notifications. It is bound to the lifetime of a
session.
サブスクリプション：NETCONFセッションでイベント通知を受信するための合意と方法。 送信先と通知の選択を含む、通知の配信（送信するものがある場合）に関連する概念。 これは、セッションの存続期間にバインドされています。
Chisholm & Trevino Standards Track [Page 3]
RFC 5277 NETCONF Event Notifications July 2008
Operation: This term is used to refer to NETCONF protocol operations
[NETCONF]. Within this document, operation refers to NETCONF
protocol operations defined in support of NETCONF notifications.
操作：この用語は、NETCONFプロトコル操作[NETCONF]を指すために使用されます。 このドキュメントでは、操作とは、NETCONF通知のサポートで定義されたNETCONFプロトコル操作を指します。
Event: An event is something that happens that may be of interest -
a configuration change, a fault, a change in status, crossing a
threshold, or an external input to the system, for example.
Often, this results in an asynchronous message, sometimes referred
to as a notification or event notification, being sent to
interested parties to notify them that this event has occurred.
イベント：イベントは、たとえば、構成の変更、障害、ステータスの変化、しきい値の超過、システムへの外部入力など、関心のある可能性のある発生するものです。 多くの場合、これにより非同期メッセージ（通知またはイベント通知と呼ばれることもあります）が関係者に送信され、このイベントが発生したことを通知します。
Replay: The ability to send/re-send previously logged notifications
upon request. These notifications are sent asynchronously. This
feature is implemented by the NETCONF server and invoked by the
NETCONF client.
リプレイ：リクエストに応じて、以前にログに記録された通知を送信/再送信する機能。 これらの通知は非同期に送信されます。 この機能は、NETCONFサーバーによって実装され、NETCONFクライアントによって呼び出されます。
Stream: An event stream is a set of event notifications matching
some forwarding criteria and available to NETCONF clients for
subscription.
ストリーム：イベントストリームは、いくつかの転送基準に一致する一連のイベント通知であり、NETCONFクライアントがサブスクリプションに使用できます。
Filter: A parameter that indicates which subset of all possible
events are of interest. A filter is defined as one or more filter
elements [NETCONF], each of which identifies a portion of the
overall filter.
フィルター：すべての可能なイベントのどのサブセットが対象であるかを示すパラメーター。 フィルターは、1つ以上のフィルター要素[NETCONF]として定義され、それぞれがフィルター全体の一部を識別します。
1.2. Motivation
1.2。 動機
The motivation for this work is to enable the sending of asynchronous messages that are consistent with the data model (content) and security model used within a NETCONF implementation.
この作業の動機は、NETCONF実装内で使用されるデータモデル（コンテンツ）およびセキュリティモデルと一致する非同期メッセージの送信を可能にすることです。
The scope of the work aims at meeting the following operational needs:
作業の範囲は、次の運用上のニーズを満たすことを目的としています。
o Initial release should ensure it supports notifications in support
of configuration operations.
初期リリースでは、構成操作をサポートする通知を確実にサポートする必要があります。
o It should be possible to use the same data model for notifications
as for configuration operations.
構成操作と同じデータモデルを通知に使用できるはずです。
o The solution should support a reasonable message size limit (i.e.,
not too short).
ソリューションは、妥当なメッセージサイズの制限をサポートする必要があります（つまり、短すぎません）。
o The notifications should be carried over a connection-oriented
delivery mechanism.
通知は、接続指向の配信メカニズムを介して伝達される必要があります。
Chisholm & Trevino Standards Track [Page 4]
RFC 5277 NETCONF Event Notifications July 2008
o A subscription mechanism for notifications should be provided.
This takes into account that a NETCONF server does not send
notifications before being asked to do so, and that it is the
NETCONF client who initiates the flow of notifications.
通知のサブスクリプションメカニズムを提供する必要があります。 これは、NETCONFサーバーが通知する前に通知を送信しないこと、および通知のフローを開始するのはNETCONFクライアントであることを考慮に入れています。
o A filtering mechanism for sending notifications should be put in
place within the NETCONF server.
通知を送信するためのフィルタリングメカニズムは、NETCONFサーバー内に配置する必要があります。
o The information contained in a notification should be sufficient
so that it can be analyzed independent of the transport mechanism.
In other words, the data content fully describes a notification;
protocol information is not needed to understand a notification.
通知に含まれる情報は、トランスポートメカニズムとは関係なく分析できるように十分なものでなければなりません。 つまり、データコンテンツは通知を完全に記述しています。 通知を理解するためにプロトコル情報は必要ありません。
o The server should have the capability to replay locally logged
notifications.
サーバーには、ローカルでログに記録された通知を再生する機能が必要です。
1.3. Event Notifications in NETCONF
1.3。 NETCONFのイベント通知
This memo defines a mechanism whereby the NETCONF client indicates interest in receiving event notifications from a NETCONF server by creating a subscription to receive event notifications. The NETCONF server replies to indicate whether the subscription request was successful and, if it was successful, begins sending the event notifications to the NETCONF client as the events occur within the system. These event notifications will continue to be sent until either the NETCONF session is terminated or the subscription terminates for some other reason. The event notification subscription allows a number of options to enable the NETCONF client to specify which events are of interest. These are specified when the subscription is created. Note that a subscription cannot be modified once created.
このメモは、NETCONFクライアントがイベント通知を受信するサブスクリプションを作成することにより、NETCONFサーバーからのイベント通知の受信に関心を示すメカニズムを定義します。 NETCONFサーバーは、サブスクリプション要求が成功したかどうかを示すために応答し、成功した場合は、システム内でイベントが発生すると、NETCONFクライアントにイベント通知の送信を開始します。 これらのイベント通知は、NETCONFセッションが終了するか、サブスクリプションが他の何らかの理由で終了するまで送信され続けます。 イベント通知サブスクリプションでは、NETCONFクライアントが関心のあるイベントを指定できるようにする多くのオプションを使用できます。 これらは、サブスクリプションの作成時に指定されます。 作成したサブスクリプションは変更できないことに注意してください。
The NETCONF server MUST accept and process the <close-session> operation, even while the notification subscription is active. The NETCONF server MAY accept and process other commands; otherwise, they will be rejected and the server MUST send a 'resource-denied' error. A NETCONF server advertises support of the ability to process other commands via the :interleave capability.
NETCONFサーバーは、通知サブスクリプションがアクティブな場合でも、<close-session>操作を受け入れて処理する必要があります。 NETCONFサーバーは他のコマンドを受け入れて処理する場合があります。 それ以外の場合は拒否され、サーバーは「リソース拒否」エラーを送信する必要があります。 NETCONFサーバーは、：interleave機能を介して他のコマンドを処理する機能のサポートを通知します。
2. Notification-Related Operations
2.通知関連の操作
2.1. Subscribing to Receive Event Notifications
2.1。 イベント通知の受信をサブスクライブする
The event notification subscription is initiated by the NETCONF client and responded to by the NETCONF server. A subscription is bound to a single stream for the lifetime of the subscription. When the event notification subscription is created, the events of interest are specified.
イベント通知サブスクリプションは、NETCONFクライアントによって開始され、NETCONFサーバーによって応答されます。 サブスクリプションは、サブスクリプションの存続期間中、単一のストリームにバインドされます。 イベント通知サブスクリプションが作成されると、対象のイベントが指定されます。
Chisholm & Trevino Standards Track [Page 5] RFC 5277 NETCONF Event Notifications July 2008 Content for an event notification subscription can be selected by applying user-specified filters.
イベント通知サブスクリプションのコンテンツは、ユーザー指定のフィルターを適用することで選択できます。
2.1.1. <create-subscription>
2.1.1。 <サブスクリプションの作成>
Description:
説明：
This operation initiates an event notification subscription that
will send asynchronous event notifications to the initiator of the
command until the subscription terminates.
この操作は、イベント通知サブスクリプションを開始し、サブスクリプションが終了するまで、コマンドのイニシエーターに非同期イベント通知を送信します。
Parameters:
パラメーター：
Stream:
An optional parameter, <stream>, that indicates which stream of
events is of interest. If not present, events in the default
NETCONF stream will be sent.
ストリーム：対象となるイベントのストリームを示すオプションのパラメーター<stream>。 存在しない場合、デフォルトのNETCONFストリームのイベントが送信されます。
Filter:
An optional parameter, <filter>, that indicates which subset of
all possible events is of interest. The format of this
parameter is the same as that of the filter parameter in the
NETCONF protocol operations. If not present, all events not
precluded by other parameters will be sent. See section 3.6
for more information on filters.
フィルター：可能なすべてのイベントのどのサブセットが対象であるかを示すオプションのパラメーター<filter>。 このパラメーターの形式は、NETCONFプロトコル操作のフィルターパラメーターの形式と同じです。 存在しない場合、他のパラメーターによって除外されていないすべてのイベントが送信されます。 フィルターの詳細については、セクション3.6を参照してください。
Start Time:
A parameter, <startTime>, used to trigger the replay feature
and indicate that the replay should start at the time
specified. If <startTime> is not present, this is not a replay
subscription. It is not valid to specify start times that are
later than the current time. If the <startTime> specified is
earlier than the log can support, the replay will begin with
the earliest available notification. This parameter is of type
dateTime and compliant to [RFC3339]. Implementations must
support time zones.
開始時間：再生機能をトリガーし、指定した時間に再生を開始する必要があることを示すために使用されるパラメーター<startTime>。 <startTime>が存在しない場合、これは再生サブスクリプションではありません。 現在時刻より後の開始時刻を指定することはできません。 指定された<startTime>がログがサポートできるよりも早い場合、再生は利用可能な最も早い通知から始まります。 このパラメーターはdateTimeタイプで、[RFC3339]に準拠しています。 実装はタイムゾーンをサポートする必要があります。
Chisholm & Trevino Standards Track [Page 6]
RFC 5277 NETCONF Event Notifications July 2008
Stop Time:
An optional parameter, <stopTime>, used with the optional
replay feature to indicate the newest notifications of
interest. If <stopTime> is not present, the notifications will
continue until the subscription is terminated. Must be used
with and be later than <startTime>. Values of <stopTime> in
the future are valid. This parameter is of type dateTime and
compliant to [RFC3339]. Implementations must support time
zones.
停止時間：オプションのパラメーター<stopTime>は、オプションの再生機能で使用され、関心のある最新の通知を示します。 <stopTime>が存在しない場合、サブスクリプションが終了するまで通知が継続します。 <startTime>以降で使用する必要があります。 <stopTime>の将来の値は有効です。 このパラメーターはdateTimeタイプで、[RFC3339]に準拠しています。 実装はタイムゾーンをサポートする必要があります。
Positive Response:
If the NETCONF server can satisfy the request, the server sends an
<ok> element.
肯定応答：NETCONFサーバーが要求を満たすことができる場合、サーバーは<ok>要素を送信します。
Negative Response:
An <rpc-error> element is included within the <rpc-reply> if the
request cannot be completed for any reason. Subscription requests
will fail if a filter with invalid syntax is provided or if the
name of a non-existent stream is provided.
否定応答：何らかの理由でリクエストを完了できない場合、<rpc-error>要素が<rpc-reply>に含まれます。 無効な構文のフィルターが指定されている場合、または存在しないストリームの名前が指定されている場合、サブスクリプション要求は失敗します。
If a <stopTime> is specified in a request without having specified
a <startTime>, the following error is returned:
<startTime>を指定せずにリクエストで<stopTime>を指定すると、次のエラーが返されます。
Tag: missing-element
Error-type: protocol
Severity: error
Error-info: <bad-element>: startTime
Description: An expected element is missing.
If the optional replay feature is requested but it is not
supported by the NETCONF server, the following error is returned:
オプションの再生機能が要求されても、NETCONFサーバーでサポートされていない場合は、次のエラーが返されます。
Tag: operation-failed
Error-type: protocol
Severity: error
Error-info: none
Chisholm & Trevino Standards Track [Page 7]
RFC 5277 NETCONF Event Notifications July 2008
Description: Request could not be completed because the
requested operation failed for some reason not covered by any
other error condition.
説明：要求された操作は、他のエラー条件ではカバーされない何らかの理由で失敗したため、要求を完了できませんでした。
If a <stopTime> is requested that is earlier than the specified
<startTime>, the following error is returned:
<startTime>を指定せずにリクエストで<stopTime>を指定すると、次のエラーが返されます。
Tag: bad-element
Error-type: protocol
Severity: error
Error-info: <bad-element>: stopTime
Description: An element value is not correct; e.g., wrong type,
out of range, pattern mismatch.
If a <startTime> is requested that is later than the current time,
the following error is returned:
現在時刻より後の<startTime>が要求されると、次のエラーが返されます。
Tag: bad-element
Error-type: protocol
Severity: error
Error-info: <bad-element>: startTime
Description: An element value is not correct; e.g., wrong type,
out of range, pattern mismatch.
2.1.1.1. Usage Example
2.1.1.1。 使用例
The following demonstrates creating a simple subscription. More complex examples can be found in section 5.
以下は、単純なサブスクリプションの作成を示しています。 より複雑な例はセクション5にあります。
<netconf:rpc message-id="101"
xmlns:netconf="urn:ietf:params:xml:ns:netconf:base:1.0">
<create-subscription
xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0">
</create-subscription>
</netconf:rpc>
Chisholm & Trevino Standards Track [Page 8]
RFC 5277 NETCONF Event Notifications July 2008
2.2. Sending Event Notifications
2.2。 イベント通知の送信
Once the subscription has been set up, the NETCONF server sends the event notifications asynchronously over the connection.
サブスクリプションがセットアップされると、NETCONFサーバーは接続を介して非同期にイベント通知を送信します。
2.2.1. <notification>
2.2.1。 <お知らせ>
Description:
An event notification is sent to the client who initiated a
<create-subscription> command asynchronously when an event of
interest (i.e., meeting the specified filtering criteria) has
occurred. An event notification is a complete and well-formed XML
document. Note that <notification> is not a Remote Procedure Call
(RPC) method but rather the top-level element identifying the one-
way message as a notification.
説明：関心のあるイベント（つまり、指定されたフィルター基準を満たす）が発生したときに、<create-subscription>コマンドを非同期に開始したクライアントにイベント通知が送信されます。 イベント通知は、完全で整形式のXMLドキュメントです。 <notification>はリモートプロシージャコール（RPC）メソッドではなく、一方向メッセージを通知として識別する最上位の要素であることに注意してください。
Parameters:
eventTime
The time the event was generated by the event source. This
parameter is of type dateTime and compliant to [RFC3339].
Implementations must support time zones.
イベントソースによってイベントが生成された時刻。 このパラメーターはdateTimeタイプで、[RFC3339]に準拠しています。 実装はタイムゾーンをサポートする必要があります。
Also contains notification-specific tagged content, if any. With
the exception of <eventTime>, the content of the notification is
beyond the scope of this document.
通知固有のタグ付きコンテンツも含まれます（ある場合）。 <eventTime>を除いて、通知の内容はこのドキュメントの範囲外です。
Response:
No response. Not applicable.
応答：応答なし。 適用できません。
2.3. Terminating the Subscription
2.3。 サブスクリプションの終了
Closing of the event notification subscription can be done by using the <close-session> operation from the subscriptions session or terminating the NETCONF session ( <kill-session> ) or the underlying transport session from another session. If a stop time is provided when the subscription is created, the subscription will terminate after the stop time is reached. In this case, the NETCONF session will still be an active session.
イベント通知サブスクリプションを閉じるには、サブスクリプションセッションから<close-session>操作を使用するか、NETCONFセッション（<kill-session>）または別のセッションからの基になるトランスポートセッションを終了します。 サブスクリプションの作成時に停止時間を指定した場合、サブスクリプションは停止時間に達すると終了します。 この場合、NETCONFセッションはアクティブなセッションのままです。
Chisholm & Trevino Standards Track [Page 9] RFC 5277 NETCONF Event Notifications July 2008 3. Supporting Concepts
3.サポートの概念
3.1. Capabilities Exchange
3.1。 能力交換
The ability to process and send event notifications is advertised during the capability exchange between the NETCONF client and server.
イベント通知を処理して送信する機能は、NETCONFクライアントとサーバー間の機能交換中にアドバタイズされます。
3.1.1. Capability Identifier
3.1.1。 機能識別子
"urn:ietf:params:netconf:capability:notification:1.0" 3.1.2. Capability Example
3.1.2。 機能の例
<hello xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
<capabilities>
<capability>
urn:ietf:params:xml:ns:netconf:base:1.0
</capability>
<capability>
urn:ietf:params:netconf:capability:startup:1.0
</capability>
<capability>
urn:ietf:params:netconf:capability:notification:1.0
</capability>
</capabilities>
<session-id>4</session-id>
</hello>
3.2. Event Streams
3.2。 イベントストリーム
An event stream is defined as a set of event notifications matching some forwarding criteria.
イベントストリームは、いくつかの転送基準に一致する一連のイベント通知として定義されます。
Figure 2 illustrates the notification flow and concepts identified in this document. It does not mandate and/or preclude an implementation. The following is observed from the diagram below: System components (c1..cn) generate event notifications that are passed to a central component for classification and distribution. The central component inspects each event notification and matches the event notification against the set of stream definitions. When a match occurs, the event notification is considered to be a member of that event stream (stream 1..stream n). An event notification may be part of multiple event streams.
図2は、このドキュメントで識別されている通知フローと概念を示しています。 実装を義務付けたり除外したりすることはありません。 以下の図から、次のことがわかります。システムコンポーネント（c1..cn）は、分類と配布のために中央コンポーネントに渡されるイベント通知を生成します。 中央コンポーネントは、各イベント通知を検査し、イベント通知を一連のストリーム定義と照合します。 一致が発生すると、イベント通知はそのイベントストリーム（ストリーム1 ..ストリームn）のメンバーと見なされます。 イベント通知は、複数のイベントストリームの一部である場合があります。
Chisholm & Trevino Standards Track [Page 10] RFC 5277 NETCONF Event Notifications July 2008 At some point after the NETCONF server receives the internal event from a stream, it is converted to an appropriate XML encoding by the server, and a <notification> element is ready to send to all NETCONF sessions subscribed to that stream.
NETCONFサーバーがストリームから内部イベントを受信した後のある時点で、サーバーによって適切なXMLエンコーディングに変換され、そのストリームにサブスクライブされているすべてのNETCONFセッションに<notification>要素を送信する準備が整います。
After generation of the <notification> element, access control is applied by the server. If a session does not have permission to receive the <notification>, then it is discarded for that session, and processing of the internal event is completed for that session.
<notification>要素の生成後、サーバーによってアクセス制御が適用されます。 セッションに<notification>を受信する権限がない場合、そのセッションでは破棄され、そのセッションの内部イベントの処理が完了します。
When a NETCONF client subscribes to a given event stream, user- defined filter elements, if applicable, are applied to the event stream and matching event notifications are forwarded to the NETCONF server for distribution to subscribed NETCONF clients. A filter is transferred from the client to the server during the <create- subscription> operation and applied against each <notification> element generated by the stream. For more information on filtering, see Section 3.6.
NETCONFクライアントが特定のイベントストリームをサブスクライブすると、該当する場合、ユーザー定義のフィルター要素がイベントストリームに適用され、一致するイベント通知がNETCONFサーバーに転送されて、サブスクライブされたNETCONFクライアントに配布されます。 フィルターは、<create-subscription>操作中にクライアントからサーバーに転送され、ストリームによって生成された各<notification>要素に対して適用されます。 フィルタリングの詳細については、セクション3.6を参照してください。
A notification-logging service may also be available, in which case, the central component logs notifications. The NETCONF server may later retrieve logged notifications via the optional replay feature. For more information on replay, see section 3.3.
通知ログサービスも利用できる場合があります。その場合、中央コンポーネントが通知をログに記録します。 NETCONFサーバーは、オプションのリプレイ機能を介して、ログに記録された通知を後で取得する場合があります。 再生の詳細については、セクション3.3を参照してください。
+----+
| c1 |----+ available streams
+----+ | +---------+
+----+ | |central |-> stream 1
| c2 | +--->|event |-> stream 2 filter +-------+
+----+ | |processor|-> NETCONF stream ----->|NETCONF|
... | | |-> stream n |server |
System | +---------+ +-------+
Components| | /\
... | | ||
+----+ | | (------------) ||
| cn |----+ | (notification) ||
+----+ +-----> ( logging ) ||
( service ) ||
(------------) ||
||
||
\/
+-------+
|NETCONF|
|client |
+-------+
Figure 2
Chisholm & Trevino Standards Track [Page 11]
RFC 5277 NETCONF Event Notifications July 2008
3.2.1. Event Stream Definition
3.2.1。 イベントストリームの定義
Event streams are predefined on the managed device. The configuration of event streams is outside the scope of this document. However, it is envisioned that event streams are either pre- established by the vendor (pre-configured), user configurable (e.g., part of the device's configuration), or both. Device vendors may allow event stream configuration via the NETCONF protocol (i.e., <edit-config> operation).
イベントストリームは、管理対象デバイスで事前定義されています。 イベントストリームの構成は、このドキュメントの範囲外です。 ただし、イベントストリームは、ベンダーによって事前に設定されているか（事前設定済み）、ユーザーが設定可能（デバイスの設定の一部など）、またはその両方であることが想定されています。 デバイスベンダーは、NETCONFプロトコル（つまり、<edit-config>操作）を介したイベントストリーム構成を許可する場合があります。
3.2.2. Event Stream Content Format
3.2.2。 イベントストリームのコンテンツ形式
The contents of all event streams made available to a NETCONF client (i.e., the notification sent by the NETCONF server) MUST be encoded in XML.
NETCONFクライアントで利用できるようにされたすべてのイベントストリームの内容（つまり、NETCONFサーバーによって送信された通知）は、XMLでエンコードする必要があります。
3.2.3. Default Event Stream
3.2.3。 デフォルトのイベントストリーム
A NETCONF server implementation supporting the notification capability MUST support the "NETCONF" notification event stream. This stream contains all NETCONF XML event notifications supported by the NETCONF server. The exact string "NETCONF" is used during the advertisement of stream support during the <get> operation on <streams> and during the <create-subscription> operation. Definition of the event notifications and their contents, beyond the inclusion of <eventTime>, for this event stream is outside the scope of this document.
通知機能をサポートするNETCONFサーバー実装は、「NETCONF」通知イベントストリームをサポートする必要があります。 このストリームには、NETCONFサーバーでサポートされているすべてのNETCONF XMLイベント通知が含まれています。 正確な文字列 "NETCONF"は、<streams>での<get>操作中および<create-subscription>操作中に、ストリームサポートのアドバタイズ中に使用されます。 <eventTime>を含めて、このイベントストリームのイベント通知とその内容の定義は、このドキュメントの範囲外です。
3.2.4. Event Stream Sources
3.2.4。 イベントストリームソース
With the exception of the default event stream (NETCONF), specification of additional event stream sources (e.g., Simple Network Management Protocol (SNMP), syslog) is outside the scope of this document. NETCONF server implementations may leverage any desired event stream source in the creation of supported event streams.
デフォルトのイベントストリーム（NETCONF）を除いて、追加のイベントストリームソース（Simple Network Management Protocol（SNMP）、syslogなど）の指定は、このドキュメントの範囲外です。 NETCONFサーバーの実装では、サポートされているイベントストリームの作成において、任意のイベントストリームソースを活用できます。
3.2.5. Event Stream Discovery
3.2.5。 イベントストリームの検出
A NETCONF client retrieves the list of supported event streams from a NETCONF server using the <get> operation.
NETCONFクライアントは、<get>操作を使用して、サポートされているイベントストリームのリストをNETCONFサーバーから取得します。
3.2.5.1. Name Retrieval Using <get> Operation
3.2.5.1。 <get>オペレーションを使用した名前の取得
The list of available event streams is retrieved by requesting the <streams> subtree via a <get> operation. Available event streams for the requesting session are returned in the reply containing the <name> and <description> elements, where the <name> element is Chisholm & Trevino Standards Track [Page 12] RFC 5277 NETCONF Event Notifications July 2008 mandatory, and its value is unique within the scope of a NETCONF server. An empty reply is returned if there are no available event streams, due to user-specified filters on the <get> operation.
使用可能なイベントストリームのリストは、<get>操作を介して<streams>サブツリーを要求することによって取得されます。 要求セッションで使用可能なイベントストリームは、<name>要素と<description>要素を含む応答で返されます。<name>要素は必須であり、その値はNETCONFサーバーのスコープ内で一意です。 <get>操作でユーザー指定のフィルターが原因で使用可能なイベントストリームがない場合は、空の応答が返されます。
Additional information available about a stream includes whether notification replay is available and, if so, the timestamp of the earliest possible notification to replay.
ストリームに関して利用可能な追加情報には、通知の再生が利用可能かどうか、利用可能な場合は、再生する最も早い可能な通知のタイムスタンプが含まれます。
The following example shows retrieving the list of available event stream list using the <get> operation.
次の例は、<get>操作を使用して、使用可能なイベントストリームリストのリストを取得する方法を示しています。
<rpc message-id="101"
xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
<get>
<filter type="subtree">
<netconf xmlns="urn:ietf:params:xml:ns:netmod:notification">
<streams/>
</netconf>
</filter>
</get>
</rpc>
Chisholm & Trevino Standards Track [Page 13]
RFC 5277 NETCONF Event Notifications July 2008
The NETCONF server returns a list of event streams available for
subscription: NETCONF, SNMP, and syslog-critical in this example.
NETCONFサーバーは、サブスクリプションに使用可能なイベントストリームのリストを返します。この例では、NETCONF、SNMP、syslog-criticalです。
<rpc-reply message-id="101"
xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
<data>
<netconf xmlns="urn:ietf:params:xml:ns:netmod:notification">
<streams>
<stream>
<name>NETCONF</name>
<description>default NETCONF event stream
</description>
<replaySupport>true</replaySupport>
<replayLogCreationTime>
2007-07-08T00:00:00Z
</replayLogCreationTime>
</stream>
<stream>
<name>SNMP</name>
<description>SNMP notifications</description>
<replaySupport>false</replaySupport>
</stream>
<stream>
<name>syslog-critical</name>
<description>Critical and higher severity
</description>
<replaySupport>true</replaySupport>
<replayLogCreationTime>
2007-07-01T00:00:00Z
</replayLogCreationTime>
</stream>
</streams>
</netconf>
</data>
</rpc-reply>
3.2.5.2. Event Stream Subscription
3.2.5.2。 イベントストリームのサブスクリプション
A NETCONF client may request from the NETCONF server the list of event streams available to this session and then issue a <create- subscription> request with the desired event stream name. Omitting the event stream name from the <create-subscription> request results in subscription to the default NETCONF event stream.
NETCONFクライアントは、このセッションで使用可能なイベントストリームのリストをNETCONFサーバーに要求してから、目的のイベントストリーム名を指定して<create- subscription>要求を発行できます。 <create-subscription>リクエストからイベントストリーム名を省略すると、デフォルトのNETCONFイベントストリームへのサブスクリプションが発生します。
Chisholm & Trevino Standards Track [Page 14] RFC 5277 NETCONF Event Notifications July 2008 3.2.5.2.1. Filtering Event Stream Contents
3.2.5.2.1。 イベントストリームのコンテンツのフィルタリング
The set of event notifications delivered in an event stream may be further refined by applying a user-specified filter supplied at subscription creation time ( <create-subscription> ). This is a transient filter associated with the event notification subscription and does not modify the event stream configuration. The filter element is applied against the contents of the <notification> wrapper and not the wrapper itself. See section 5 for examples. Either subtree or XPATH filtering can be used.
イベントストリームで配信されるイベント通知のセットは、サブスクリプションの作成時に提供されるユーザー指定のフィルター（<create-subscription>）を適用することによってさらに絞り込むことができます。 これは、イベント通知サブスクリプションに関連付けられた一時的なフィルターであり、イベントストリーム構成を変更しません。 フィルター要素は、ラッパー自体ではなく、<notification>ラッパーのコンテンツに対して適用されます。 例については、セクション5を参照してください。 サブツリーまたはXPATHフィルタリングのいずれかを使用できます。
XPATH support for the Notification capability is advertised as part of the normal XPATH capability advertisement. If XPATH support is advertised via the XPATH capability, then XPATH is supported for notification filtering. If this capability is not advertised, XPATH is not supported for notification filtering.
通知機能のXPATHサポートは、通常のXPATH機能通知の一部として通知されます。 XPATHサポートがXPATH機能を介してアドバタイズされる場合、XPATHは通知フィルタリングでサポートされます。 この機能がアドバタイズされていない場合、XPATHは通知フィルタリングでサポートされません。
3.3. Notification Replay
3.3。 通知の再生
3.3.1. Overview
3.3.1。 概観
Replay is the ability to create an event subscription that will resend recently generated notifications, or in some cases send them for the first time to a particular NETCONF client. These notifications are sent the same way as normal notifications.
リプレイは、最近生成された通知を再送信する、または場合によっては特定のNETCONFクライアントに初めて通知を送信するイベントサブスクリプションを作成する機能です。 これらの通知は、通常の通知と同じ方法で送信されます。
A replay of notifications is specified by including the optional <startTime> parameter to the subscription command, which indicates the start time of the replay. The end time is specified using the optional <stopTime> parameter. If not present, notifications will continue to be sent until the subscription is terminated.
通知の再生は、サブスクリプションコマンドにオプションの<startTime>パラメータを含めることによって指定されます。これは、再生の開始時間を示します。 終了時刻は、オプションの<stopTime>パラメーターを使用して指定されます。 存在しない場合、サブスクリプションが終了するまで通知が送信され続けます。
A notification stream that supports replay is not expected to have an unlimited supply of saved notifications available to accommodate any replay request. Clients can query <replayLogCreationTime> and <replayLogAgedTime> to learn about the availability of notifications for replay.
再生をサポートする通知ストリームは、任意の再生リクエストに対応するために利用可能な保存済み通知を無制限に提供することは想定されていません。 クライアントは、<replayLogCreationTime>および<replayLogAgedTime>をクエリして、再生の通知の可用性を確認できます。
The actual number of stored notifications available for retrieval at any given time is a NETCONF server implementation-specific matter. Control parameters for this aspect of the feature are outside the scope of this document.
いつでも取得できる保存された通知の実際の数は、NETCONFサーバー実装固有の問題です。 機能のこの側面の制御パラメーターは、このドキュメントの範囲外です。
Replay is dependent on a notification stream supporting some form of notification logging, although it puts no restrictions on the size or form of the log, or where it resides within the device. Whether or not a stream supports replay can be discovered by doing a <get> operation on the <streams> element of the Notification Management Chisholm & Trevino Standards Track [Page 15] RFC 5277 NETCONF Event Notifications July 2008 Schema and looking at the value of the <replaySupport> object. This schema also provides the <replayLogCreationTime> element to indicate the earliest available logged notification.
再生は、ログのサイズや形式、またはデバイス内の場所に制限はありませんが、何らかの形で通知ログをサポートする通知ストリームに依存しています。 ストリームが再生をサポートしているかどうかは、通知管理スキーマの<streams>要素で<get>操作を実行し、<replaySupport>オブジェクトの値を確認することで検出できます。 このスキーマは、<replayLogCreationTime>要素も提供して、使用可能な最も早いログ通知を示します。
3.3.2. Creating a Subscription with Replay
3.3.2。 リプレイを使用したサブスクリプションの作成
This feature uses optional parameters to the <create-subscription> command called <startTime> and <stopTime>. <startTime> identifies the earliest date and time of interest for event notifications being replayed and also indicates that a subscription will be providing replay of notifications. Events generated before this time are not matched. <stopTime> specifies the latest date and time of interest for event notifications being replayed. If it is not present, then notifications will continue to be sent until the subscription is terminated.
この機能は、<startTime>および<stopTime>と呼ばれる<create-subscription>コマンドにオプションのパラメーターを使用します。 <startTime>は、再生されるイベント通知の最も早い日付と時刻を識別し、サブスクリプションが通知の再生を提供することも示します。 この時間より前に生成されたイベントは一致しません。 <stopTime>は、再生されるイベント通知の対象となる最新の日付と時刻を指定します。 存在しない場合、サブスクリプションが終了するまで通知が送信され続けます。
Note that <startTime> and <stopTime> are associated with the time an event was generated by the event source.
<startTime>と<stopTime>は、イベントソースによってイベントが生成された時刻に関連付けられていることに注意してください。
A <replayComplete> notification is sent to indicate that all of the replay notifications have been sent and must not be sent for any other reason. If this subscription has a stop time, then this session becomes a normal NETCONF session again. The NETCONF server will then accept <rpc> operations even if the server did not previously accept such operations due to lack of interleave support. In the case of a subscription without a stop time, after the <replayComplete> notification has been sent, it can be expected that any notifications generated since the start of the subscription creation will be sent, followed by notifications as they arise naturally within the system.
<replayComplete>通知が送信され、すべての再生通知が送信されたことを示し、他の理由で送信してはならないことを示します。 このサブスクリプションに停止時間がある場合、このセッションは再び通常のNETCONFセッションになります。 NETCONFサーバーは、インターリーブのサポートがないためにサーバーが以前にそのような操作を受け入れなかった場合でも、<rpc>操作を受け入れます。 停止時間のないサブスクリプションの場合、<replayComplete>通知が送信された後、サブスクリプションの作成の開始以降に生成された通知が送信され、その後、システム内で自然に発生する通知が送信されます。 。
The <replayComplete> and <notificationComplete> notifications cannot be filtered out. They will always be sent on a replay subscription that specified a <startTime> and <stopTime>, respectively.
<replayComplete>および<notificationComplete>通知は除外できません。 それらは常に、それぞれ<startTime>および<stopTime>を指定した再生サブスクリプションで送信されます。
3.4. Notification Management Schema
3.4。 通知管理スキーマ
This Schema is used to learn about the event streams supported on the system. It also contains the definition of the <replayComplete> and <notificationComplete> notifications, which are sent to indicate that an event replay has sent all applicable notifications and that the subscription has terminated, respectively.
このスキーマは、システムでサポートされるイベントストリームについて学習するために使用されます。 また、<replayComplete>および<notificationComplete>通知の定義も含まれています。これらの通知は、イベントの再生によって該当するすべての通知が送信されたこと、およびサブスクリプションがそれぞれ終了したことを示すために送信されます。
Chisholm & Trevino Standards Track [Page 16]
RFC 5277 NETCONF Event Notifications July 2008
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:netconf="urn:ietf:params:xml:ns:netconf:base:1.0"
xmlns:ncEvent="urn:ietf:params:xml:ns:netconf:notification:1.0"
xmlns:manageEvent="urn:ietf:params:xml:ns:netmod:notification"
targetNamespace="urn:ietf:params:xml:ns:netmod:notification"
elementFormDefault="qualified"
attributeFormDefault="unqualified"
xml:lang="en" version="1.0">
<xs:annotation>
<xs:documentation xml:lang="en">
A schema that can be used to learn about current
event streams. It also contains the replayComplete
and notificationComplete notification.
</xs:documentation>
</xs:annotation>
<xs:import namespace="http://www.w3.org/XML/1998/namespace"
schemaLocation="http://www.w3.org/2001/xml.xsd"/>
<xs:import namespace="urn:ietf:params:xml:ns:netconf:base:1.0"
schemaLocation="netconf.xsd"/>
<xs:import namespace=
"urn:ietf:params:xml:ns:netconf:notification:1.0"
schemaLocation="notification.xsd"/>
<xs:element name="netconf" type="manageEvent:Netconf"/>
<xs:complexType name="Netconf">
<xs:sequence>
<xs:element name="streams" >
<xs:annotation>
<xs:documentation>
The list of event streams supported by the
system. When a query is issued, the returned
set of streams is determined based on user
privileges.
</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence minOccurs="1" maxOccurs="unbounded">
<xs:element name="stream">
<xs:annotation>
<xs:documentation>
Stream name, description, and other information.
</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
Chisholm & Trevino Standards Track [Page 17]
RFC 5277 NETCONF Event Notifications July 2008
<xs:element name="name"
type="ncEvent:streamNameType">
<xs:annotation>
<xs:documentation>
The name of the event stream. If this is
the default NETCONF stream, this must have
the value "NETCONF".
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="description"
type="xs:string">
<xs:annotation>
<xs:documentation>
A description of the event stream, including
such information as the type of events that
are sent over this stream.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="replaySupport"
type="xs:boolean">
<xs:annotation>
<xs:documentation>
An indication of whether or not event replay
is available on this stream.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="replayLogCreationTime"
type="xs:dateTime" minOccurs="0">
<xs:annotation>
<xs:documentation>
The timestamp of the creation of the log
used to support the replay function on
this stream.
Note that this might be earlier then
the earliest available
notification in the log. This object
is updated if the log resets
for some reason. This
object MUST be present if replay is
supported.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="replayLogAgedTime"
type="xs:dateTime" minOccurs="0">
Chisholm & Trevino Standards Track [Page 18]
RFC 5277 NETCONF Event Notifications July 2008
<xs:annotation>
<xs:documentation>
The timestamp of the last notification
aged out of the log. This
object MUST be present if replay is
supported and any notifications
have been aged out of the log.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="ReplayCompleteNotificationType">
<xs:complexContent>
<xs:extension base="ncEvent:NotificationContentType"/>
</xs:complexContent>
</xs:complexType>
<xs:element name="replayComplete"
type="manageEvent:ReplayCompleteNotificationType"
substitutionGroup="ncEvent:notificationContent">
<xs:annotation>
<xs:documentation>
This notification is sent to signal the end of a replay
portion of a subscription.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="NotificationCompleteNotificationType">
<xs:complexContent>
<xs:extension base="ncEvent:NotificationContentType"/>
</xs:complexContent>
</xs:complexType>
<xs:element name="notificationComplete"
type="manageEvent:NotificationCompleteNotificationType"
substitutionGroup="ncEvent:notificationContent">
<xs:annotation>
<xs:documentation>
This notification is sent to signal the end of a
Chisholm & Trevino Standards Track [Page 19]
RFC 5277 NETCONF Event Notifications July 2008
notification subscription. It is sent in the case
that stopTime was specified during the creation of
the subscription.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:schema>
3.5. Subscriptions Data
3.5。 サブスクリプションデータ
Subscriptions are non-persistent state information, and their lifetime is defined by their session or by the <stopTime> parameter.
サブスクリプションは非永続的な状態情報であり、その存続期間はセッションまたは<stopTime>パラメータによって定義されます。
3.6. Filter Mechanics
3.6。 フィルター力学
If a filter element is specified to look for data of a particular value, and the data item is not present within a particular event notification for its value to be checked against, the notification will be filtered out. For example, if one were to check for 'severity=critical' in a configuration event notification where this field was not supported, then the notification would be filtered out.
特定の値のデータを検索するようにフィルター要素が指定されており、その値がチェックされる特定のイベント通知内にデータ項目が存在しない場合、通知はフィルターで除外されます。 たとえば、このフィールドがサポートされていない構成イベント通知で 'severity = critical'をチェックする場合、通知はフィルターで除外されます。
For subtree filtering, a non-empty node set means that the filter matches. For XPath filtering, the mechanisms defined in [XPATH] should be used to convert the returned value to boolean.
サブツリーフィルタリングの場合、空でないノードセットは、フィルターが一致することを意味します。 XPathフィルタリングの場合、[XPATH]で定義されたメカニズムを使用して、戻り値をブール値に変換する必要があります。
3.6.1. Filtering
3.6.1。 フィルタリング
Filtering is explicitly stated when the event notification subscription is created. This is specified via the 'filter' parameter. A Filter only exists as a parameter to the subscription.
フィルタリングは、イベント通知サブスクリプションが作成されるときに明示的に示されます。 これは、「filter」パラメーターを介して指定されます。 フィルターは、サブスクリプションへのパラメーターとしてのみ存在します。
3.7. Message Flow
3.7。 メッセージの流れ
The following figure depicts message flow between a NETCONF client (C) and NETCONF server (S) in order to create a subscription and begin the flow of notifications. This subscription specifies a <startTime>, so the server starts by replaying logged notifications. It is possible that many rpc/rpc-reply sequences occur before the subscription is created, but this is not depicted in the figure.
次の図は、サブスクリプションを作成して通知のフローを開始するための、NETCONFクライアント（C）とNETCONFサーバー（S）間のメッセージフローを示しています。 このサブスクリプションは<startTime>を指定するため、サーバーはログに記録された通知を再生することから開始します。 サブスクリプションが作成される前に多くのrpc / rpc-replyシーケンスが発生する可能性がありますが、これは図には示されていません。
Chisholm & Trevino Standards Track [Page 20]
RFC 5277 NETCONF Event Notifications July 2008
C S
| |
| capability exchange |
|-------------------------->|
|<------------------------->|
| |
| <create-subscription> | (startTime)
|-------------------------->|
|<--------------------------|
| <rpc-reply> |
| |
| <notification> |
|<--------------------------|
| |
| <notification> |
|<--------------------------|
| <notification> | (replayComplete)
|<--------------------------|
| |
| |
| |
| <notification> |
|<--------------------------|
| |
| |
| <notification> |
|<--------------------------|
| |
| |
Figure 3
The following figure depicts message flow between a NETCONF client
(C) and NETCONF server (S) in order to create a subscription and
begin the flow of notifications. This subscription specified a
<startTime> and <stopTime> so it starts by replaying logged
notifications and then returns to be a normal command-response
NETCONF session after the <replayComplete> and <notificationComplete>
notifications are sent and it is available to process <rpc> requests.
It is possible that many rpc/rpc-reply sequences occur before the
subscription is created, but this is not depicted in the figure.
次の図は、サブスクリプションを作成して通知のフローを開始するための、NETCONFクライアント（C）とNETCONFサーバー（S）間のメッセージフローを示しています。 このサブスクリプションは<startTime>と<stopTime>を指定したため、ログに記録された通知の再生から始まり、<replayComplete>と<notificationComplete>通知が送信されて<rpcの処理が可能になると、通常のコマンド応答NETCONFセッションに戻ります。 >リクエスト。 サブスクリプションが作成される前に多くのrpc / rpc-replyシーケンスが発生する可能性がありますが、これは図には示されていません。
Chisholm & Trevino Standards Track [Page 21]
RFC 5277 NETCONF Event Notifications July 2008
C S
| |
| capability exchange |
|-------------------------->|
|<------------------------->|
| |
| <create-subscription> | (startTime,
|-------------------------->| stopTime)
|<--------------------------|
| <rpc-reply> |
| |
| <notification> |
|<--------------------------|
| |
| <notification> |
|<--------------------------|
| <notification> | (replayComplete)
|<--------------------------|
| <notification> |(notificationComplete)
|<--------------------------|
| |
| |
| |
| <rpc> |
|-------------------------->|
|<--------------------------|
| <rpc-reply> |
| |
Figure 4
4. XML Schema for Event Notifications
4.イベント通知のXMLスキーマ
The following [XMLSchema] defines NETCONF Event Notifications.
次の[XMLSchema]は、NETCONFイベント通知を定義しています。
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0"
xmlns:netconf="urn:ietf:params:xml:ns:netconf:base:1.0"
targetNamespace=
"urn:ietf:params:xml:ns:netconf:notification:1.0"
elementFormDefault="qualified"
attributeFormDefault="unqualified"
xml:lang="en">
Chisholm & Trevino Standards Track [Page 22]
RFC 5277 NETCONF Event Notifications July 2008
<!-- import standard XML definitions -->
<xs:import namespace="http://www.w3.org/XML/1998/namespace"
schemaLocation="http://www.w3.org/2001/xml.xsd">
<xs:annotation>
<xs:documentation>
This import accesses the xml: attribute groups for the
xml:lang as declared on the error-message element.
</xs:documentation>
</xs:annotation>
</xs:import>
<!-- import base netconf definitions -->
<xs:import namespace="urn:ietf:params:xml:ns:netconf:base:1.0"
schemaLocation="netconf.xsd"/>
<!-- ************** Symmetrical Operations ********************-->
<!-- <create-subscription> operation -->
<xs:complexType name="createSubscriptionType">
<xs:complexContent>
<xs:extension base="netconf:rpcOperationType">
<xs:sequence>
<xs:element name="stream"
type="streamNameType" minOccurs="0">
<xs:annotation>
<xs:documentation>
An optional parameter that indicates
which stream of events is of interest.
If not present, then events in the
default NETCONF stream will be sent.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="filter"
type="netconf:filterInlineType"
minOccurs="0">
<xs:annotation>
<xs:documentation>
An optional parameter that indicates
which subset of all possible events
is of interest. The format of this
parameter is the same as that of the
filter parameter in the NETCONF
protocol operations. If not
present, all events not precluded
by other parameters will be sent.
Chisholm & Trevino Standards Track [Page 23]
RFC 5277 NETCONF Event Notifications July 2008
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="startTime" type="xs:dateTime"
minOccurs="0" >
<xs:annotation>
<xs:documentation>
A parameter used to trigger the replay
feature indicating that the replay
should start at the time specified. If
start time is not present, this is not a
replay subscription.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="stopTime" type="xs:dateTime"
minOccurs="0" >
<xs:annotation>
<xs:documentation>
An optional parameter used with the
optional replay feature to indicate the
newest notifications of interest. If
stop time is not present, the
notifications will continue until the
subscription is terminated. Must be
used with startTime.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:simpleType name="streamNameType">
<xs:annotation>
<xs:documentation>
The name of an event stream.
</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string"/>
</xs:simpleType>
Chisholm & Trevino Standards Track [Page 24]
RFC 5277 NETCONF Event Notifications July 2008
<xs:element name="create-subscription"
type="createSubscriptionType"
substitutionGroup="netconf:rpcOperation">
<xs:annotation>
<xs:documentation>
The command to create a notification subscription. It
takes as argument the name of the notification stream
and filter. Both of those options
limit the content of the subscription. In addition,
there are two time-related parameters, startTime and
stopTime, which can be used to select the time interval
of interest to the notification replay feature.
</xs:documentation>
</xs:annotation>
</xs:element>
<!-- ************** One-way Operations ******************-->
<!-- <Notification> operation -->
<xs:complexType name="NotificationContentType"/>
<xs:element name="notificationContent"
type="NotificationContentType" abstract="true"/>
<xs:complexType name="NotificationType">
<xs:sequence>
<xs:element name="eventTime" type="xs:dateTime">
<xs:annotation>
<xs:documentation>
The time the event was generated by the event source.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element ref="notificationContent"/>
</xs:sequence>
</xs:complexType>
<xs:element name="notification" type="NotificationType"/>
</xs:schema>
Chisholm & Trevino Standards Track [Page 25]
RFC 5277 NETCONF Event Notifications July 2008
5. Filtering Examples
5.フィルタリングの例
The following section provides examples to illustrate the various methods of filtering content on an event notification subscription.
次のセクションでは、イベント通知サブスクリプションでコンテンツをフィルタリングするさまざまな方法を示す例を示します。
In order to illustrate the use of filter expressions, it is necessary to assume some of the event notification content. The examples below assume that the event notification schema definition has an <event> element at the top level consisting of the event class (e.g., fault, state, config), reporting entity, and either severity or operational state.
フィルター式の使用法を説明するために、イベント通知コンテンツの一部を想定する必要があります。 以下の例では、イベント通知スキーマ定義に、イベントクラス（障害、状態、構成など）、レポートエンティティ、および重大度または動作状態のいずれかで構成される最上位に<event>要素があると想定しています。
Examples in this section are generated from the following fictional Schema.
このセクションの例は、次の架空のスキーマから生成されます。
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema targetNamespace="http://example.com/event/1.0"
xmlns="http://example.com/event/1.0"
elementFormDefault="qualified"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:ncEvent="urn:ietf:params:xml:ns:netconf:notification:1.0">
<xs:import namespace=
"urn:ietf:params:xml:ns:netconf:notification:1.0"
schemaLocation="notification.xsd"/>
<xs:complexType name="eventType">
<xs:complexContent>
<xs:extension base="ncEvent:NotificationContentType">
<xs:sequence>
<xs:element name="eventClass" />
<xs:element name="reportingEntity">
<xs:complexType>
<xs:sequence>
<xs:any namespace="##any"
processContents="lax"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:choice>
<xs:element name="severity"/>
<xs:element name="operState"/>
</xs:choice>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
Chisholm & Trevino Standards Track [Page 26]
RFC 5277 NETCONF Event Notifications July 2008
<xs:element name="event"
type="eventType"
substitutionGroup="ncEvent:notificationContent"/>
</xs:schema>
The above fictional notification definition could result in the
following sample notification list, which is used in the examples in
this section.
上記の架空の通知定義により、このセクションの例で使用される次のサンプル通知リストが生成される可能性があります。
<notification
xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0">
<eventTime>2007-07-08T00:01:00Z</eventTime>
<event xmlns="http://example.com/event/1.0">
<eventClass>fault</eventClass>
<reportingEntity>
<card>Ethernet0</card>
</reportingEntity>
<severity>major</severity>
</event>
</notification>
<notification
xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0">
<eventTime>2007-07-08T00:02:00Z</eventTime>
<event xmlns="http://example.com/event/1.0">
<eventClass>fault</eventClass>
<reportingEntity>
<card>Ethernet2</card>
</reportingEntity>
<severity>critical</severity>
</event>
</notification>
<notification
xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0">
<eventTime>2007-07-08T00:04:00Z</eventTime>
<event xmlns="http://example.com/event/1.0">
<eventClass>fault</eventClass>
<reportingEntity>
<card>ATM1</card>
</reportingEntity>
<severity>minor</severity>
</event>
</notification>
Chisholm & Trevino Standards Track [Page 27]
RFC 5277 NETCONF Event Notifications July 2008
<notification
xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0">
<eventTime>2007-07-08T00:10:00Z</eventTime>
<event xmlns="http://example.com/event/1.0">
<eventClass>state</eventClass>
<reportingEntity>
<card>Ethernet0</card>
</reportingEntity>
<operState>enabled</operState>
</event>
</notification>
5.1. Subtree Filtering
5.1。 サブツリーフィルタリング
XML subtree filtering is not well-suited for creating elaborate filter definitions given that it only supports equality comparisons and application of the logical OR operators (e.g., in an event subtree, give me all event notifications that have severity=critical, severity=major, or severity=minor). Nevertheless, it may be used for defining simple event notification forwarding filters as shown below.
XMLサブツリーフィルタリングは、等価比較と論理OR演算子の適用のみをサポートしているため、複雑なフィルター定義の作成にはあまり適していません（たとえば、イベントサブツリーで、severity = critical、severity = major、 またはseverity = minor）。 それでも、以下に示すように、単純なイベント通知転送フィルターを定義するために使用できます。
The following example illustrates how to select fault events which have severities of critical, major, or minor. The filtering criteria evaluation is as follows:
次の例は、クリティカル、メジャー、またはマイナーの重大度を持つ障害イベントを選択する方法を示しています。 フィルタリング基準の評価は次のとおりです。
((fault & severity=critical) | (fault & severity=major) | (fault & severity=minor))
<netconf:rpc netconf:message-id="101"
xmlns:netconf="urn:ietf:params:xml:ns:netconf:base:1.0">
<create-subscription
xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0">
<filter netconf:type="subtree">
<event xmlns="http://example.com/event/1.0">
<eventClass>fault</eventClass>
<severity>critical</severity>
</event>
<event xmlns="http://example.com/event/1.0">
<eventClass>fault</eventClass>
<severity>major</severity>
</event>
<event xmlns="http://example.com/event/1.0">
<eventClass>fault</eventClass>
<severity>minor</severity>
</event>
</filter>
</create-subscription>
</netconf:rpc>
Chisholm & Trevino Standards Track [Page 28]
RFC 5277 NETCONF Event Notifications July 2008
The following example illustrates how to select state or config
EventClasses or fault events that are related to card Ethernet0. The
filtering criteria evaluation is as follows:
次の例は、カードEthernet0に関連する状態または構成のEventClassesまたは障害イベントを選択する方法を示しています。 フィルタリング基準の評価は次のとおりです。
( state | config | ( fault & ( card=Ethernet0)))
<netconf:rpc netconf:message-id="101"
xmlns:netconf="urn:ietf:params:xml:ns:netconf:base:1.0">
<create-subscription
xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0">
<filter netconf:type="subtree">
<event xmlns="http://example.com/event/1.0">
<eventClass>state</eventClass>
</event>
<event xmlns="http://example.com/event/1.0">
<eventClass>config</eventClass>
</event>
<event xmlns="http://example.com/event/1.0">
<eventClass>fault</eventClass>
<reportingEntity>
<card>Ethernet0</card>
</reportingEntity>
</event>
</filter>
</create-subscription>
</netconf:rpc>
5.2. XPATH Filters
5.2。 XPATHフィルター
The following [XPATH] example illustrates how to select fault EventClass notifications that have severities of critical, major, or minor. The filtering criteria evaluation is as follows:
次の[XPATH]の例は、クリティカル、メジャー、またはマイナーの重大度を持つ障害EventClass通知を選択する方法を示しています。 フィルタリング基準の評価は次のとおりです。
((fault) & ((severity=critical) | (severity=major) | (severity =
minor)))
<netconf:rpc netconf:message-id="101"
xmlns:netconf="urn:ietf:params:xml:ns:netconf:base:1.0">
<create-subscription
xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0">
<filter netconf:type="xpath"
xmlns:ex="http://example.com/event/1.0"
select="/ex:event[ex:eventClass='fault' and
(ex:severity='minor' or ex:severity='major'
or ex:severity='critical')]"/>
</create-subscription>
</netconf:rpc>
Chisholm & Trevino Standards Track [Page 29]
RFC 5277 NETCONF Event Notifications July 2008
The following example illustrates how to select state and config
EventClasses or fault events of any severity that come from card
Ethernet0. The filtering criteria evaluation is as follows:
次の例は、カードEthernet0からの重大度の状態と構成のEventClassesまたは障害イベントを選択する方法を示しています。 フィルタリング基準の評価は次のとおりです。
( state | config | (fault & card=Ethernet0))
<netconf:rpc message-id="101"
xmlns:netconf="urn:ietf:params:xml:ns:netconf:base:1.0">
<create-subscription
xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0">
<filter netconf:type="xpath"
xmlns:ex="http://example.com/event/1.0"
select="/ex:event[
(ex:eventClass='state' or ex:eventClass='config') or
((ex:eventClass='fault' and ex:card='Ethernet0'))]"/>
</create-subscription>
</netconf:rpc>
6. Interleave Capability
6.インターリーブ機能
6.1. Description
6.1。 説明文
The :interleave capability indicates that the NETCONF peer supports the ability to interleave other NETCONF operations within a notification subscription. This means the NETCONF server MUST receive, process, and respond to NETCONF requests on a session with an active notification subscription. This capability helps scalability by reducing the total number of NETCONF sessions required by a given operator or management application.
：interleave機能は、NETCONFピアが通知サブスクリプション内の他のNETCONF操作をインターリーブする機能をサポートすることを示します。 これは、NETCONFサーバーが、アクティブな通知サブスクリプションを使用するセッションでNETCONF要求を受信、処理、および応答する必要があることを意味します。 この機能は、特定のオペレーターまたは管理アプリケーションが必要とするNETCONFセッションの総数を減らすことにより、スケーラビリティを支援します。
6.2. Dependencies
6.2。 依存関係
This capability is dependent on the notification capability being supported.
この機能は、サポートされている通知機能に依存しています。
6.3. Capability Identifier
6.3。 機能識別子
The :interleave capability is identified by the following capability string:
：interleave機能は、次の機能文字列によって識別されます。
urn:ietf:params:netconf:capability:interleave:1.0 Chisholm & Trevino Standards Track [Page 30] RFC 5277 NETCONF Event Notifications July 2008 6.4. New Operations
6.4。 新しいオペレーション
None.
無し。
6.5. Modifications to Existing Operations
6.5。 既存の操作の変更
When a <create-subscription> is sent while another subscription is active on that session, the following error will be returned:
そのセッションで別のサブスクリプションがアクティブなときに<create-subscription>が送信されると、次のエラーが返されます。
Tag: operation-failed
Error-type: protocol
Severity: error
Error-info: none
Description: Request could not be completed because the requested
operation failed for some reason not covered by any other error
condition.
7. Security Considerations
7.セキュリティに関する考慮事項
The security considerations from the base [NETCONF] document also apply to the Notification capability.
ベースの[NETCONF]ドキュメントのセキュリティに関する考慮事項は、通知機能にも適用されます。
The access control framework and the choice of transport will have a major impact on the security of the solution.
アクセス制御フレームワークとトランスポートの選択は、ソリューションのセキュリティに大きな影響を与えます。
The <notification> elements are never sent before the transport layer and the NETCONF layer, including capabilities exchange, have been established and the manager has been identified and authenticated.
<notification>要素は、機能交換を含むトランスポート層とNETCONF層が確立され、マネージャーが識別および認証されるまで送信されません。
It is recommended that care be taken to secure execution:
安全な実行に注意することをお勧めします。
o <create-subscription> invocation
<create-subscription>の呼び出し
o <get> on read-only data models
読み取り専用データモデルの<get>
o <notification> content
<通知>内容
Secure execution means ensuring that a secure transport is used as well as ensuring that the user has sufficient authorization to perform the function they are requesting against the specific subset of NETCONF content involved. When a <get> is received that refers to the content defined in this memo, clients should only be able to view the content for which they have sufficient privileges. A create <create-subscription> operation can be considered like a deferred Chisholm & Trevino Standards Track [Page 31] RFC 5277 NETCONF Event Notifications July 2008 <get>, and the content that different users can access may vary. This different access is reflected in the <notification> that different users are able to subscribe to.
安全な実行とは、安全なトランスポートが使用されていること、およびユーザーが関連するNETCONFコンテンツの特定のサブセットに対して要求している機能を実行するための十分な権限があることを確認することを意味します。 このメモで定義されたコンテンツを参照する<get>を受信した場合、クライアントは十分な権限を持つコンテンツのみを表示できます。 create <create-subscription>操作は、遅延<get>のように考えることができ、異なるユーザーがアクセスできるコンテンツは異なる場合があります。 この異なるアクセスは、異なるユーザーがサブスクライブできる<notification>に反映されます。
One potential security issue is the transport of data from non- NETCONF streams, such as syslog and SNMP. This data may be more vulnerable (or less vulnerable) when being transported over NETCONF than when being transported using the protocol normally used for transporting it, depending on the security credentials of the two subsystems. The NETCONF server is responsible for applying access control to stream content.
1つの潜在的なセキュリティ問題は、syslogやSNMPなどの非NETCONFストリームからのデータの転送です。 このデータは、2つのサブシステムのセキュリティ資格情報によっては、NETCONFを介して転送される場合、通常の転送に使用されるプロトコルを使用して転送される場合よりも脆弱性が高い（または脆弱性が低い）場合があります。 NETCONFサーバーは、ストリームコンテンツにアクセス制御を適用する責任があります。
The contents of notifications, as well as the names of event streams, may contain sensitive information and care should be taken to ensure that they are viewed only by authorized users. The NETCONF server MUST NOT include any content in a notification that the user is not authorized to view.
通知の内容とイベントストリームの名前には機密情報が含まれている可能性があり、許可されたユーザーのみがそれらを表示できるように注意する必要があります。 NETCONFサーバーは、ユーザーが表示することを許可されていないという通知にコンテンツを含めてはいけません。
If a subscription is created with a <stopTime>, the NETCONF session will return to being a normal command-response NETCONF session when the replay is completed. It is the responsibility of the NETCONF client to close this session when it is no longer of use.
サブスクリプションが<stopTime>で作成されている場合、再生が完了すると、NETCONFセッションは通常のコマンド応答NETCONFセッションに戻ります。 このセッションが不要になったときにこのセッションを閉じるのは、NETCONFクライアントの責任です。
If a malicious or buggy NETCONF client sends a number of <create- subscription> requests, then these subscriptions accumulate and may use up system resources. In such a situation, subscriptions can be terminated by terminating the suspect underlying NETCONF sessions using the <kill-session> operation.
悪意のある、またはバグの多いNETCONFクライアントが多数の<create- subscription>リクエストを送信すると、これらのサブスクリプションが蓄積し、システムリソースを使い果たす可能性があります。 このような状況では、<kill-session>操作を使用して、疑わしい基礎となるNETCONFセッションを終了することにより、サブスクリプションを終了できます。
8. IANA Considerations
8. IANAに関する考慮事項
This document registers three URIs for the NETCONF XML namespace in the IETF XML registry [RFC3688].
このドキュメントでは、NETCONF XML名前空間の3つのURIをIETF XMLレジストリ[RFC3688]に登録しています。
Following the format in RFC 3688, IANA has made the following registration. Note that the capability URNs are also compliant to section 10.3 of [NETCONF].
RFC 3688のフォーマットに従って、IANAは次の登録を行いました。 機能URNも[NETCONF]のセクション10.3に準拠していることに注意してください。
+--------------------+----------------------------------------------+
| Index | Capability Identifier |
+--------------------+----------------------------------------------+
| :notification | urn:ietf:params:netconf:capability: |
| | notification:1.0 |
| | |
| :interleave | urn:ietf:params:netconf:capability: |
| | interleave:1.0 |
+--------------------+----------------------------------------------+
Chisholm & Trevino Standards Track [Page 32]
RFC 5277 NETCONF Event Notifications July 2008
URI: urn:ietf:params:xml:ns:netmod:notification
URI: urn:ietf:params:xml:ns:netconf:notification:1.0
Registrant Contact: The IESG.
XML: N/A, the requested URI is an XML namespace.
In addition, IANA registered the XML Schema defined in Section 4.
9. Acknowledgements
Thanks to Gilbert Gagnon, Greg Wilbur, and Kim Curran for providing
their input into the early work on this document. In addition, the
editors would like to acknowledge input at the Vancouver editing
session from the following people: Orly Nicklass, James Balestriere,
Yoshifumi Atarashi, Glenn Waters, Alexander Clemm, Dave Harrington,
Dave Partain, Ray Atarashi, David Perkins, and the following
additional people from the Montreal editing session: Balazs Lengyel,
Phil Shafer, Rob Enns, Andy Bierman, Dan Romascanu, Bert Wijnen,
Simon Leinen, Juergen Schoenwaelder, Hideki Okita, Vincent Cridlig,
Martin Bjorklund, Olivier Festor, Radu State, Brian Trammell, and
William Chow. We would also like to thank Li Yan for his numerous
reviews, as well as Suresh Krishnan for his gen-art review of the
document.
10. Normative References
[NETCONF] Enns, R., Ed., "NETCONF Configuration Protocol",
RFC 4741, December 2006.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC3339] Klyne, G., Ed. and C. Newman, "Date and Time on the
Internet: Timestamps", RFC 3339, July 2002.
[RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688,
January 2004.
[XML] World Wide Web Consortium, "Extensible Markup Language
(XML) 1.0", W3C XML, February 1998,
<http://www.w3.org/TR/1998/REC-xml-19980210>.
[XMLSchema] Thompson, H., Beech, D., Maloney, M., and N. Mendelsohn,
"XML Schema Part 1: Structures Second Edition", W3C http
://www.w3.org/TR/2004/REC-xmlschema-1-20041028/
structures.html, October 2004.
Chisholm & Trevino Standards Track [Page 33]
RFC 5277 NETCONF Event Notifications July 2008
[XPATH] Clark, J. and S. DeRose, "XML Path Language (XPath)
Version 1.0",
W3C http://www.w3.org/TR/1999/REC-xpath-19991116,
November 1999.
Authors' Addresses
Sharon Chisholm
Nortel
3500 Carling Ave
Nepean, Ontario K2H 8E9
Canada
EMail: schishol@nortel.com
Hector Trevino
Cisco
Suite 400
9155 E. Nichols Ave
Englewood, CO 80112
USA
EMail: htrevino@cisco.com
Chisholm & Trevino Standards Track [Page 34]
RFC 5277 NETCONF Event Notifications July 2008
Full Copyright Statement
Copyright (C) The IETF Trust (2008).
This document is subject to the rights, licenses and restrictions
contained in BCP 78, and except as set forth therein, the authors
retain all their rights.
This document and the information contained herein are provided on an
"AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST AND
THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF
THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Intellectual Property
The IETF takes no position regarding the validity or scope of any
Intellectual Property Rights or other rights that might be claimed to
pertain to the implementation or use of the technology described in
this document or the extent to which any license under such rights
might or might not be available; nor does it represent that it has
made any independent effort to identify any such rights. Information
on the procedures with respect to rights in RFC documents can be
found in BCP 78 and BCP 79.
Copies of IPR disclosures made to the IETF Secretariat and any
assurances of licenses to be made available, or the result of an
attempt made to obtain a general license or permission for the use of
such proprietary rights by implementers or users of this
specification can be obtained from the IETF on-line IPR repository at
http://www.ietf.org/ipr.
The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary
rights that may cover technology that may be required to implement
this standard. Please address the information to the IETF at
ietf-ipr@ietf.org.
Chisholm & Trevino Standards Track [Page 35]