Performing service operations, Performing the get/get-bulk operation – H3C Technologies H3C S6300 Series Switches User Manual

Page 247

Advertising
background image

234

<session-id>1</session-id>

</error-info>

</rpc-error>

</rpc-reply>

The output shows that the lock operation failed because the client with session ID 1 held the lock, and

only the client holding the lock can release the lock.

Performing service operations

You can use NETCONF to perform service operations on the device, such as retrieving and modifying the

specified information. The basic operations include get, get-bulk, get-config, get-bulk-config, and

edit-config, which are used to retrieve all data, retrieve configuration data, and edit the data of the
specified module. For more information, see the NETCONF XML API reference for the switch.

Performing the get/get-bulk operation

The get operation is used to retrieve device configuration and state information that match the conditions.

In some cases, this operation leads to inefficiency.
The get-bulk operation is used to retrieve a number of data entries starting from the data entry next to the

one with the specified index. One data entry contains a device configuration entry and a state
information entry. The data entry quantity is defined by the count attribute, and the index is specified by

the index attribute. The returned output does not include the index information. If you do not specify the

index attribute, the index value starts with 1 by default.
The get-bulk operation retrieves all the rest data entries starting from the data entry next to the one with

the specified index if either of the following conditions exists:

You do not specify the count attribute.

The number of matched data entries is less than the value of the count attribute.

# Copy the following text to the client to perform the get operation:

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

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

<getoperation>

<filter>

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

Specify the module, submodule, table name, and column name

</top>

</filter>

</getoperation>

</rpc>

Where, the <getoperation> parameter can be <get> or <get-bulk>. The <filter> element is used to filter
data, and it can contain module name, submodule name, table name, and column name.

If the module name and the submodule name are not provided, the operation retrieves the data for

all modules and submodules. If a module name or a submodule name is provided, the operation
retrieves the data for the specified module or submodule.

If the table name is not provided, the operation retrieves the data for all tables. If a table name is
provided, the operation retrieves the data for the specified table.

Advertising