Summary
Find Devices
Description
Gets a specific subset of devices for based on given options
Route
POST /configuration_manager/devices
Roles
admin
apiread
Parameters
DetailsExampleSchema
Name |
Type |
Required |
Description |
options |
object |
yes |
Object with filters and query params. Only options.limit is required. |
Copied to Clipboard
{
"options": {
"limit": 20,
"start": 0,
"filter": {
"name": "laborum ipsum culpa",
"address": "10.1.98.234",
"port": "22"
},
"sort": [
{
"name": -1,
"address": -1,
"port": 1
},
{
"name": -1,
"address": 1,
"port": 1
},
{
"name": 1,
"address": -1,
"port": 1
}
],
"order": "ascending",
"adapterType": [
"NSO",
"AnsibleManager"
],
"adapterId": [
"ansible-us-east"
],
"exactMatch": false
}
}
Copied to Clipboard
{
"type": "object",
"properties": {
"options": {
"title": "options",
"type": "object",
"properties": {
"start": {
"type": "integer",
"minimum": 0,
"examples": [
0
]
},
"limit": {
"type": "integer",
"minimum": 1,
"examples": [
20
]
},
"filter": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"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"
]
},
"port": {
"type": "string",
"pattern": "^[0-9]+$",
"examples": [
"22"
]
}
}
},
"sort": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"enum": [
-1,
1
]
},
"address": {
"enum": [
-1,
1
]
},
"port": {
"enum": [
-1,
1
]
}
}
}
},
"order": {
"type": "string",
"enum": [
"ascending",
"descending"
]
},
"adapterType": {
"type": "array",
"items": {
"type": "string",
"examples": [
"NSO",
"AnsibleManager"
]
},
"uniqueItems": true
},
"adapterId": {
"type": "array",
"items": {
"type": "string",
"examples": [
"ansible-us-east"
],
"uniqueItems": true
}
},
"exactMatch": {
"type": "boolean",
"description": "boolean that indicates if an exact result will be returned or not",
"enum": [
true,
false
]
}
},
"required": [
"limit"
]
}
},
"required": [
"options"
],
"additionalProperties": false
}
Return
DetailsExampleSchema
Name |
Type |
Description |
devices |
object |
Filtered/Sorted Devices |
Copied to Clipboard
{
"entity": "device",
"total": 30955940,
"unique_device_count": 34027781,
"return_count": 36631969,
"start_index": 45612087,
"list": [
{
"name": "xr9kv01-aws",
"device-type": "cli",
"ipaddress": "10.1.6.100",
"port": "22",
"ostype": "cisco-ios-xr",
"host": "nso46",
"actions": [
"deleteDevice",
"setConfig",
"isAlive"
],
"authgroup": "xr9kv-aws",
"address": "10.1.6.100",
"ned": "cisco-ios-xr",
"admin": true,
"origins": [
"nso46"
]
},
{
"name": "xr9kv01-aws",
"device-type": "cli",
"ipaddress": "10.1.6.100",
"port": "22",
"ostype": "cisco-ios-xr",
"host": "nso46",
"actions": [
"getDeviceGroupsForDevices",
"deleteDevice",
"removeDeviceFromGroup"
],
"authgroup": "xr9kv-aws",
"address": "10.1.6.100",
"ned": "cisco-ios-xr",
"admin": false,
"origins": [
"nso46",
"nso46"
]
},
{
"name": "xr9kv01-aws",
"device-type": "cli",
"ipaddress": "10.1.6.100",
"port": "22",
"ostype": "cisco-ios-xr",
"host": "nso46",
"actions": [
"addDeviceGroup",
"addDevice"
],
"authgroup": "xr9kv-aws",
"address": "10.1.6.100",
"ned": "cisco-ios-xr",
"admin": true,
"origins": [
"nso46",
"nso46",
"nso46"
]
}
]
}
Copied to Clipboard
{
"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"
}
}
}
}