Update Device State ID
post
/api/device/DeviceManagement/updateDiscovery
Updates the state ID of devices to force rediscovery on the next SNMP run. At minimum, either the DeviceGroupID or Devices property is required in the request body.
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
DeviceGroupID: integer
The ID of the device group containing the devices whose state IDs are to be updated. Either Devices or DeviceGroupID parameter is required.
-
Devices: integer
The comma-separated list of device IDs whose state IDs are to be updated. Either Devices or DeviceGroupID parameter is required.
-
RecursiveGroup: boolean
Whether the state IDs of all the descending devices from the device group specified by DeviceGroupID are being updated (true) or not (false).
Response
Supported Media Types
- application/json
200 Response
Successful operation
Root Schema : SuccessfulUpdateOperation
Type:
object
The response body for a successful update operation.
Show Source
-
message: string
The response message.Example:
Updated record
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
true
Default Response
Failed operation
Root Schema : schema
Type:
Show Source
object
-
errors: array
errors
The list of errors reported. Validation errors will be keyed by record field.
-
message: string
The response message.Example:
Exception thrown
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
false
Nested Schema : errors
Type:
array
The list of errors reported. Validation errors will be keyed by record field.
Show Source
-
Array of:
object items
An error.
Nested Schema : items
Type:
object
An error.