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": "aute nulla mollit cupidatat",
      "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
      },
      {
        "name": 1,
        "address": -1,
        "port": 1
      },
      {
        "name": -1,
        "address": 1,
        "port": 1
      }
    ],
    "order": "ascending",
    "adapterType": [
      "AnsibleManager",
      "NSO"
    ],
    "adapterId": [
      "ansible-us-east",
      "ansible-us-east"
    ]
  }
}
           
          
            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"
              ]
            }
          },
          "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",
              "AnsibleManager"
            ]
          },
          "uniqueItems": true
        },
        "adapterId": {
          "type": "array",
          "items": {
            "type": "string",
            "examples": [
              "ansible-us-east"
            ],
            "uniqueItems": true
          }
        }
      },
      "required": [
        "limit"
      ]
    }
  },
  "required": [
    "options"
  ],
  "additionalProperties": false
}
           
          Return
          
            DetailsExampleSchema
          
          
            
              
                | Name | Type | Description | 
            
            
              
                | devices | object | Filtered/Sorted Devices | 
            
          
          
            Copied to Clipboard
            
            {
  "entity": "device",
  "total": 50214361,
  "unique_device_count": 24534682,
  "return_count": 17679233,
  "start_index": 99443985,
  "list": [
    {
      "name": "xr9kv01-aws",
      "device-type": "cli",
      "ipaddress": "10.1.6.100",
      "port": "22",
      "ostype": "cisco-ios-xr",
      "host": "nso46",
      "actions": [
        "runAction",
        "getTemplates",
        "passThru"
      ],
      "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"
      }
    }
  }
}