Exchanging capabilities, Subscribing to event notifications, Subscription procedure – H3C Technologies H3C S6300 Series Switches User Manual

Page 242

Advertising
background image

229

Exchanging capabilities

After you enter XML view, the client and the device exchange their capabilities before you can perform

subsequent operations. The device automatically advertises its NETCONF capabilities to the client in a

hello message as follows:

<?xml version="1.0" encoding="UTF-8"?><hello

xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"><capabilities><capability>urn:ietf:pa

rams:netconf:base:1.1</capability><capability>urn:ietf:params:netconf:writable-runnin

g</capability><capability>urn:ietf:params:netconf:capability:notification:1.0</capabi

lity><capability>urn:ietf:params:netconf:capability:validate:1.1</capability><capabil

ity>urn:ietf:params:netconf:capability:interleave:1.0</capability><capability>urn:iet

f:params:netconf:capability:h3c-netconf-ext:1.0</capability></capabilities><session-i

d>1</session-id></hello>]]>]]>

Where:

The <capabilities> parameter represents the capabilities supported by the device.

The <session-id> parameter represents the unique ID assigned to the current session.

After receiving the hello message from the device, copy the following message to notify the device of the

capabilities (user-configurable) supported by the client:

<hello xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">

<capabilities>

<capability>

capability-set

</capability>

</capabilities>

</hello>

Where, capability-set represents the capabilities supported by the client. Use a pair of <capability> and
</capability> tags to enclose a capability.

Subscribing to event notifications

After you subscribe to event notifications, the device sends event notifications to the NETCONF client

when a subscribed event takes place on the device. The notifications include the code, group, severity,

start time, and description of the events. The device supports only log subscription.
A subscription takes effect only on the current session. If the session is terminated, the subscription is

automatically canceled.
You can send multiple subscription messages to subscribe to notification of multiple events.

Subscription procedure

# Copy the following message to the client to complete the subscription:

<?xml version="1.0" encoding="UTF-8"?>

<rpc message-id="101" xmlns ="urn:ietf:params:xml:ns:netconf:base:1.0">

<create-subscription xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0">

<stream>NETCONF</stream>

<filter>

<event xmlns="http://www.h3c.com/netconf/event:1.0">

Advertising