Summary
Get device(s) from Automation Gateway
Description
This method will get device(s) from Automation Gateway based on the provided criteria
Route
No Northbound API Available
Roles
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| options | object | yes | the options containing the criteria |
{ "options": { "start": 0, "limit": 20, "functionName": "startswith", "filter": { "address": "10.1.98.234", "name": "sunt", "names": [ "minim sint dolor commodo Excepteur", "aliquip proident laborum", "voluptate irure eiusmod minim dolor", "in amet ipsum irure in" ], "ostype": "in ut", "ostypes": [ "aliqua in ut do", "cupidatat mollit Excepteur aute exercitation", "Duis" ], "port": "22" }, "sort": [ { "name": -1, "address": -1, "port": 1 }, { "name": 1, "address": -1, "port": 1 }, { "name": -1, "address": 1, "port": 1 } ], "order": "descending", "adapterType": [ "AutomationGateway", "NSO" ], "adapterId": [ "ansible-us-east", "ansible-us-east", "ansible-us-east" ], "exactMatch": false } }
{ "type": "object", "properties": { "options": { "title": "options", "type": "object", "properties": { "start": { "type": "integer", "minimum": 0, "examples": [ 0 ] }, "limit": { "type": "integer", "minimum": 1, "examples": [ 20 ] }, "functionName": { "type": "string", "enum": [ "contains", "equals", "startswith" ] }, "filter": { "type": "object", "properties": { "address": { "type": "string", "pattern": "^((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$", "examples": [ "10.1.98.234" ] }, "name": { "type": "string" }, "names": { "type": "array", "items": { "type": "string" } }, "ostype": { "type": "string" }, "ostypes": { "type": "array", "items": { "type": "string" } }, "port": { "type": "string", "pattern": "^[0-9]+$", "examples": [ "22" ] } }, "required": [] }, "sort": { "type": "array", "items": { "type": "object", "properties": { "name": { "enum": [ -1, 1 ] }, "address": { "enum": [ -1, 1 ] }, "port": { "enum": [ -1, 1 ] } }, "required": [] } }, "order": { "type": "string", "enum": [ "ascending", "descending" ] }, "adapterType": { "type": "array", "items": { "type": "string", "examples": [ "NSO", "AutomationGateway" ] }, "uniqueItems": true }, "adapterId": { "type": "array", "items": { "type": "string", "examples": [ "ansible-us-east" ], "uniqueItems": true } }, "exactMatch": { "type": "boolean", "enum": [ true, false ] } }, "required": [] } }, "required": [ "options" ], "additionalProperties": false }
Return
| Name | Type | Description |
|---|---|---|
| devices | object | A JSON Object containing the device(s) |
{ "entity": "device", "total": 50698949, "unique_device_count": 73290728, "return_count": 33714028, "start_index": 64338434, "list": [ { "name": "xr9kv01-aws", "device-type": "cli", "ipaddress": "10.1.6.100", "port": "22", "ostype": "cisco-ios-xr", "host": "nso46", "actions": [ "getNEDs", "checkSync", "restoreDevice", "getDevices" ], "authgroup": "xr9kv-aws", "address": "10.1.6.100", "ned": "cisco-ios-xr", "admin": true, "origins": [ "nso46", "nso46", "nso46" ] }, { "name": "xr9kv01-aws", "device-type": "cli", "ipaddress": "10.1.6.100", "port": "22", "ostype": "cisco-ios-xr", "host": "nso46", "actions": [ "liveStatus", "connectDevice", "getTemplates" ], "authgroup": "xr9kv-aws", "address": "10.1.6.100", "ned": "cisco-ios-xr", "admin": false, "origins": [ "nso46", "nso46", "nso46" ] }, { "name": "xr9kv01-aws", "device-type": "cli", "ipaddress": "10.1.6.100", "port": "22", "ostype": "cisco-ios-xr", "host": "nso46", "actions": [ "checkSyncDevices", "syncToDevices", "getNEDs", "getDeviceGroupsForDevices", "syncFrom" ], "authgroup": "xr9kv-aws", "address": "10.1.6.100", "ned": "cisco-ios-xr", "admin": false, "origins": [ "nso46", "nso46", "nso46", "nso46" ] }, { "name": "xr9kv01-aws", "device-type": "cli", "ipaddress": "10.1.6.100", "port": "22", "ostype": "cisco-ios-xr", "host": "nso46", "actions": [ "getOutOfSyncConfig", "getDevicesFiltered", "getDeviceGroupsForDevices", "addDevice", "syncTo" ], "authgroup": "xr9kv-aws", "address": "10.1.6.100", "ned": "cisco-ios-xr", "admin": false, "origins": [ "nso46", "nso46", "nso46" ] }, { "name": "xr9kv01-aws", "device-type": "cli", "ipaddress": "10.1.6.100", "port": "22", "ostype": "cisco-ios-xr", "host": "nso46", "actions": [ "passThru", "getNEDs" ], "authgroup": "xr9kv-aws", "address": "10.1.6.100", "ned": "cisco-ios-xr", "admin": true, "origins": [ "nso46", "nso46", "nso46" ] } ] }
{ "title": "devices", "type": "object", "properties": { "entity": { "const": "device" }, "total": { "type": "integer", "minimum": 0 }, "unique_device_count": { "type": "integer", "minimum": 0 }, "return_count": { "type": "integer", "minimum": 0 }, "start_index": { "type": "integer", "minimum": 0 }, "list": { "type": "array", "items": { "$ref": "deviceData#/definitions/deviceDetails" } } } }