SentinelOne icon

SentinelOne

SentinelOne Management Console API specification.

Actions281

Actions → Shutdown

AI-generated

Overview

This node interacts with the SentinelOne Management Console API to perform various actions on agents, including shutting down endpoints remotely. Specifically, the 'Shutdown' operation allows users to remotely shut down all endpoints that match specified filters, which is useful for performance, maintenance, or security purposes. It is recommended to use the 'disconnect' command instead of 'shutdown' for infected endpoints to secure the environment while analyzing threats.

Use Case Examples

  1. Remotely shut down all endpoints in a specific group for maintenance.
  2. Perform a remote shutdown of endpoints matching certain criteria to improve performance during off-hours.

Properties

Name Meaning
Options Additional options for the API request such as custom body, headers, query filters, batching, debug mode, pagination, and timeout settings.

Output

JSON

  • json
    • debug - Debug information including URL, query parameters, headers, and body sent for the API request (if debug is enabled)

Dependencies

  • An API key credential for SentinelOne API authentication

Troubleshooting

  • Ensure the API credentials are correctly configured and have the necessary permissions to perform agent actions.
  • If the shutdown command returns 'Insufficient permissions', verify the user role and scope permissions for the Account, Site, or Group.
  • Check network connectivity to the SentinelOne Management Console API endpoint.
  • Use the debug option to get detailed request and response information for troubleshooting.

Links

Discussion