Actions34
- Devices Actions
- Endpoints Actions
- Guest Users Actions
- Local Users Actions
Devices → Delete By MAC
AI-generatedOverview
This node interacts with the Aruba ClearPass API to delete a device by its MAC address within the 'Devices' resource under the 'Identities' domain. It is useful for network administrators who need to manage device records by removing specific devices identified by their MAC addresses from the ClearPass system. For example, it can be used to automate the removal of unauthorized or decommissioned devices from the network.
Use Case Examples
- Deleting a device from the ClearPass database by specifying its MAC address to ensure it no longer has network access.
- Automating device cleanup processes in network management workflows.
Properties
| Name | Meaning |
|---|---|
| Domain | Specifies the API domain to access, here it is 'Identities' for device management. |
| MAC Address | The MAC address of the device account to be deleted. |
| Options | Additional options for the operation, such as whether to update the network state using Disconnect-Request or Change of Authorization (CoA) Request. |
Output
JSON
json- The JSON response from the ClearPass API after attempting to delete the device by MAC address.
Dependencies
- Aruba ClearPass API with an API key credential for authentication.
Troubleshooting
- Common issues include invalid or incorrectly formatted MAC addresses, which will cause the API to reject the request.
- Network connectivity or authentication failures with the ClearPass API can cause errors; ensure valid credentials and network access.
- If the device does not exist, the API may return a not found error; verify the MAC address before attempting deletion.