contact
"WG Web: <https:/datatracker.ietf.org/wg/netconf/>
WG List: <mailto:netconf@ietf.org>
-
Author: Alexander Clemm
<mailto:ludwig@clemm.org>
-
Author: Eric Voit
<mailto:evoit@cisco.com>
-
Author: Alberto Gonzalez Prieto
<mailto:alberto.gonzalez@microsoft.com>
-
Author: Einar Nilsen-Nygaard
<mailto:einarnn@cisco.com>
-
Author: Ambika Prasad Tripathy
<mailto:ambtripa@cisco.com>";
description
"This module defines a YANG data model for subscribing to event
records and receiving matching content in notification messages.
-
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 (RFC 2119) (RFC 8174) when, and only when,
they appear in all capitals, as shown here.
-
Copyright (c) 2019 IETF Trust and the persons identified as
authors of the code. All rights reserved.
-
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 License set
forth in Section 4.c of the IETF Trust's Legal Provisions
Relating to IETF Documents
(https://trustee.ietf.org/license-info).
-
This version of this YANG module is part of RFC 8639; see the
RFC itself for full legal notices.";
description
"Event stream evaluation criteria encoded in the syntax of
a subtree filter as defined in RFC 6241, Section 6.
-
The subtree filter is applied to the representation of
individual, delineated event records as contained in the
event stream.
-
If the subtree filter returns a non-empty node set, the
filter matches the event record, and the event record is
included in the notification message sent to the
description
"Event stream evaluation criteria encoded in the syntax of
an XPath 1.0 expression.
-
The XPath expression is evaluated on the representation of
individual, delineated event records as contained in
the event stream.
-
The result of the XPath expression is converted to a
boolean value using the standard XPath 1.0 rules. If the
boolean value is 'true', the filter matches the event
record, and the event record is included in the
notification message sent to the receivers.
-
The expression is evaluated in the following XPath
context:
-
o The set of namespace declarations is the set of
prefix and namespace pairs for all YANG modules
implemented by the server, where the prefix is the
YANG module name and the namespace is as defined by
the 'namespace' statement in the YANG module.
-
If the leaf is encoded in XML, all namespace
declarations in scope on the 'stream-xpath-filter'
leaf element are added to the set of namespace
declarations. If a prefix found in the XML is
already present in the set of namespace
declarations, the namespace in the XML is used.
-
o The set of variable bindings is empty.
-
o The function library is comprised of the core
function library and the XPath functions defined in
Section 10 in RFC 7950.
-
o The context node is the root node.";
reference
"XML Path Language (XPath) Version 1.0
In other words, there should be no streaming of objects from
the current subscription if the parent has something ready
to push.
-
If a dependency is asserted via configuration or via an RPC
but the referenced 'subscription-id' does not exist, the
dependency is silently discarded. If a referenced
"This RPC allows a subscriber to delete a subscription that
was previously created by that same subscriber using the
'establish-subscription' RPC.
-
If an error occurs, the server replies with an 'rpc-error'
where the 'error-info' field MAY contain a
'delete-subscription-error-info' structure.";
"This RPC allows an operator to delete a dynamic subscription
without restrictions on the originating subscriber or
underlying transport session.
-
If an error occurs, the server replies with an 'rpc-error'
where the 'error-info' field MAY contain a
'delete-subscription-error-info' structure.";
prior to 'replay-start-time', this gives the time of
the event generated immediately prior to the
'replay-start-time'.
-
If a receiver previously received event records for
this configured subscription, it can compare this time
to the last event record previously received. If the
"The identity and specific parameters of a subscription.
Subscriptions in this list can be created using a control
channel or RPC or can be established through configuration.
-
If the 'kill-subscription' RPC or configuration operations
are used to delete a subscription, a
'subscription-terminated' message is sent to any active or
'subscription-started' subscription state change
notification needs to be successfully received
before notification messages are sent.
-
If the 'reset' action is invoked for a receiver of
an active configured subscription, the state
must be moved to 'connecting'.";
}
}
}
-}
\ No newline at end of file
+}