cisco.nso.nso_action – Executes Cisco NSO actions and verifies output.¶
Note
This plugin is part of the cisco.nso collection (version 1.0.3).
To install it use: ansible-galaxy collection install cisco.nso
.
To use it in a playbook, specify: cisco.nso.nso_action
.
Synopsis¶
This module provides support for executing Cisco NSO actions and then verifying that the output is as expected.
Requirements¶
The below requirements are needed on the host that executes this module.
Cisco NSO version 3.4 or higher.
Parameters¶
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: Sync NSO device
cisco.nso.nso_action:
url: https://10.10.20.49/jsonrpc
username: developer
password: C1sco12345
path: /ncs:devices/device{dist-rtr01}/sync-from
input: {}
- name: Check device sync
cisco.nso.nso_action:
url: https://10.10.20.49/jsonrpc
username: developer
password: C1sco12345
path: /ncs:devices/check-sync
input: {}
- name: Load Native Config
cisco.nso.nso_action:
url: "https://10.10.20.49/jsonrpc"
username: developer
password: C1sco12345
path: /ncs:devices/ncs:device{dist-rtr01}/load-native-config
input: { file: "/home/developer/test.cfg" , verbose: true, mode: "merge"}
register: result
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
output
dictionary
|
success |
Action output
Sample:
{'result': True}
|
Authors¶
Claes Nästén (@cnasten)