cisco.nso.nso_show – Displays data from Cisco NSO.
Note
This plugin is part of the cisco.nso collection (version 1.0.2).
To install it use: ansible-galaxy collection install cisco.nso.
To use it in a playbook, specify: cisco.nso.nso_show.
Synopsis
- This module provides support for displaying data from Cisco NSO.
Requirements
The below requirements are needed on the host that executes this module.
- Cisco NSO version 3.4.12 or higher, 4.1.9 or higher, 4.2.6 or higher, 4.3.7 or higher, 4.4.5 or higher, 4.5 or higher.
Parameters
| Parameter | Choices/Defaults | Comments | 
|---|---|---|
| operational  boolean  | 
 | Controls whether or not operational data is included in the result. | 
| password  string / required  | NSO password | |
| path  string / required  | Path to NSO data. | |
| timeout  integer  | Default: 300 | JSON-RPC request timeout in seconds | 
| url  string / required  | NSO JSON-RPC URL, http://localhost:8080/jsonrpc | |
| username  string / required  | NSO username | |
| validate_certs  boolean  | 
 | When set to true, validates the SSL certificate of NSO when using SSL | 
See Also
See also
- Cisco DevNet NSO Sandbox
- 
Provides a reservable pod with NSO, virtual network topology simulated with Cisco CML and a Linux host running Ansible 
- NSO Developer Resources on DevNet
- 
Documentation for getting started using NSO 
- NSO Developer Hub
- 
Collaboration community portal for NSO developers 
- NSO Developer Github
- 
Code for NSO on Github 
Examples
- name: DISPLAY DEVICE INCLUDING OPERATIONAL DATA
  cisco.nso.nso_show:
    url: https://10.10.20.49/jsonrpc
    username: developer
    password: C1sco12345
    path: /ncs:devices/device{dist-rtr01}
    operational: true
  register: result
- name: Display the result
  debug:
    var: result
- name: DISPLAY INTERFACES
  cisco.nso.nso_show:
    url: "https://10.10.20.49/jsonrpc"
    username: developer
    password: C1sco12345
    path: /ncs:devices/device{dist-rtr01}/config/interface
    operational: true
  register: result
- name: Display the result
  debug:
    var: result
   Return Values
Common return values are documented here, the following are the fields unique to this module:
| Key | Returned | Description | 
|---|---|---|
| output  dictionary  | success | Configuration | 
Authors
- Claes Nästén (@cnasten)
    © 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
    https://docs.ansible.com/ansible/2.10/collections/cisco/nso/nso_show_module.html