NSO RESTCONF API
  • 16 Jun 2022
  • Dark
    Light
  • PDF

NSO RESTCONF API

  • Dark
    Light
  • PDF

Article Summary

This section provides configuration detail on how to make RESTCONF calls to NSO via IAP. Key highlights of NSO support for RESTCONF are listed along with several use case examples of the RestAction | NSO Manager task.

NSO RESTCONF API

RESTCONF provides a programmatic way of writing configurations to network devices. This feature is NSO-supported.

  • NSO 5.x and beyond supports RESTCONF.
  • NSO 5.3 is the last release to support both RESTCONF and REST.
  • NSO 5.4 is the first release that supports only RESTCONF.
  • NSO also supports JSON-RPC and NETCONF.

See Cisco NSO for additional resources and Swagger API documentation.

HTTP Methods

The primary HTTP methods for RESTCONF are listed below.

Method CRUD Operation
GET Read
PATCH Update
PUT Create or Replace
POST Create or Operations (reload, default)
DELETE Deletes targeted resource

Note: Capitalization is not required when setting a method.

RestAction NSO Manager Task

The restAction task is used to handle REST calls to NSO but can also be used to make restAction calls.

Incoming and outgoing variables for the task are presented in the table below.

Incoming Variable Type Description Example
adapterId String Required. The NSO adapter to be used. This will satisfy the location and AAA requirements of the restConf call. Local NSO
params Object Required. Parameters such as path, contentType and method to complete the call. path - /restconf/data/tail-ncs:devices/

contentType - application/yang-data+json

accept - application/yang-data+json

method – GET, PATCH, PUT, POST, DELETE
body Object Required. The device payload to send to NSO. C-IOS1
C-IOS2


Outgoing Variable Type Description
result Object An array of results.


Figure 1: RestAction Task Dialog

02_restActionTask


Figure 2: RestAction Task Variables

03_restActionVariables


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.