Summary
Run a list of Live Status commands against a list of devices
Description
Run a list of Live Status commands against a list of devices (e.g. ['show version', 'show ip interface brief']).
Route
POST /nso_manager/runCommands
Roles
admin
Parameters
DetailsExampleSchema
Name |
Type |
Required |
Description |
devices |
array |
yes |
A list of devices names. |
commands |
array |
yes |
The commands to run against the devices. |
options |
object |
yes |
NSO NETCONF transaction options |
Copied to Clipboard
{
"devices": [
"device1,device2,device3",
"device1,device2,device3",
"device1,device2,device3"
],
"commands": [
"incididunt",
"tempor labore ut",
"qui amet",
"veniam commodo",
"eu elit nostrud ullamco enim"
]
}
Copied to Clipboard
{
"type": "object",
"properties": {
"devices": {
"oneOf": [
{
"type": "array",
"items": {
"$ref": "inputDevices"
}
},
{
"$ref": "inputDevices"
}
],
"required": [
"devices"
]
},
"commands": {
"type": "array",
"items": {
"type": "string"
},
"required": [
"commands"
]
},
"options": {
"type": "object",
"properties": {}
}
},
"required": [
"devices",
"commands",
"options"
],
"additionalProperties": false
}
Return
DetailsExampleSchema
Name |
Type |
Description |
results |
object |
Live status results. |
Copied to Clipboard
[
[
{
"device": "ut nulla esse dolore Excepteur",
"result": "fugiat et",
"status": "voluptate consectetur",
"command": "sint nostrud"
}
],
[
{
"device": "nisi",
"result": "ullamco mollit velit ut anim",
"status": "proident",
"command": "exercitation"
},
{
"device": "nostrud enim eiusmod irure est",
"result": "qui veniam",
"status": "nisi Duis",
"command": "in ea pariatur commodo"
},
{
"device": "eiusmod est labore in",
"result": "ex",
"status": "veniam exercitation do",
"command": "pariatur adipisicing officia Duis in"
},
{
"device": "aute Ut eiusmod ullamco aliquip",
"result": "do in sunt",
"status": "velit sit reprehenderit",
"command": "sunt cillum ad in elit"
}
]
]
Copied to Clipboard
{
"type": "array",
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"device": {
"type": "string"
},
"result": {
"type": "string"
},
"status": {
"type": "string"
},
"command": {
"type": "string"
}
},
"required": [
"device",
"result",
"status",
"command"
]
}
},
"example": [
[
{
"device": "ios.0",
"result": "\r\nCisco IOS Software, NETSIM\r\nios.0# ",
"status": "success",
"command": "show version"
}
],
[
{
"device": "ios.0",
"result": "\r\nios.0# ",
"status": "success",
"command": "show interfaces"
}
]
]
}