For the complete documentation index, see llms.txt. This page is also available as Markdown.
Support

Deleted / blacklisted devices

This section discusses deleting devices and managing deleted and blacklisted units in VHQ.

Use this when you need to delete, undelete, or blacklist a device.

The Delete devices area under Device Management > Manage Devices lists all devices with the statuses Deleted or Blacklisted, making it easier to find them.

Delete a device

1

Select the device

Go to Device Search, select the device(s), then Actions > Delete. You can select and delete a single device or multiple ones.

VHQ delete device
2

Or delete from Device Profile

Alternatively, reach Device Profile by searching for the device's serial number or device ID, or by going to Device Search and clicking the device's Serial #.

Going to Device Profile
3

Confirm the deletion

On the Device Profile page, click the Delete Device icon.

Device Profile delete device icon

A confirmation popup followed by a warning message is displayed.

When a device is deleted or permanently deleted from the API, a confirmation and warning message are displayed as well.

Undelete a device

If you accidentally deleted a device, reload it back into the VHQ estate using Undelete from the Deleted/Blacklisted Devices screen. Once undeleted, the device's status returns to what it was before deletion (for example, an active device that was deleted returns to Active), and its device keys are retained on the VHQ server — no key exchange is required again.

VHQ undelete device

Blacklist a device

You can blacklist a device from the Device Profile screen.

Blacklist device from Device Profile

Guidelines

  • A deleted device can additionally be marked as blacklisted if it should never return to the device estate.

  • Deleting a device removes it from the estate; a record is retained for audit purposes and viewable from the Deleted Devices feature. Any heartbeat from a deleted device is ignored, and the server generates the Deleted Device Contacting alert.

  • Blacklisted devices remain in the same status. Any heartbeat from a blacklisted device is ignored, generating the Blacklisted Device Contacting alert — this also applies when a blacklisted device tries to register. VHQ does not purge data for blacklisted devices, but follows purge guidelines for logs and history. Blacklisted devices can be viewed on the Deleted Devices page.

  • Deleted devices retain the same VHQ status (Active, Inactive, etc.) they had at the time of deletion. If the VHQ server receives a message from a device in Deleted status, it will NOT accept the message and generates the Deleted device contacting alert. The device's profile remains viewable from the Deleted Devices screen.

Keywords

Also called: delete device, undelete device, blacklist device. Search terms: deleted devices, blacklisted devices, delete device contacting.

Last updated

Was this helpful?