Overview

This node operation assigns a shutdown task to a specified asset within a given organization. It is useful in scenarios where automated or remote shutdown of endpoint devices (assets) is required, such as in IT management, security incident response, or asset lifecycle management. For example, an IT administrator can use this node to remotely shut down a compromised device to prevent further damage or data loss.

Use Case Examples

1. Assign a shutdown task to an asset identified by its ID within a specific organization to remotely power off the device.
2. Select an organization and an asset from lists to schedule a shutdown task as part of an automated incident response workflow.

Properties

Output

JSON

• taskId - The unique identifier of the assigned shutdown task.
• status - The status of the shutdown task assignment, e.g., success or failure.
• message - Additional information or confirmation message about the task assignment.

Dependencies

• Requires an API key credential for authentication with the Binalyze AIR platform.

Troubleshooting

• Ensure the organization ID or name is valid and exists in the system.
• Verify the asset ID is correct and belongs to the specified organization.
• Check API credentials and network connectivity to the Binalyze AIR service.
• Common error messages include invalid organization or asset identifiers, authentication failures, and permission errors. Resolving these typically involves correcting input values or updating credentials.