get_request_tasks
Retrieve per-host task details for an Ambari request to identify failed, pending, or running tasks. Filter by status or host to debug partial failures and track remaining work.
Instructions
Retrieves task-level details for a specific Ambari request (host-by-host breakdown).
[Tool Role]: Provides granular, per-host task information for an Ambari request, going beyond the summary level offered by get_request_status.
[Core Functions]:
List all tasks (host/role/status/timing) belonging to a request
Filter tasks by status (e.g. FAILED, IN_PROGRESS) or exclude a status (not:COMPLETED)
Filter tasks by hostname to inspect a specific host
Identify which hosts/roles are failing, pending, or still running
[Required Usage Scenarios]:
When users want to know which hosts or roles failed/are pending in an operation
When debugging a partially-failed bulk operation (e.g. "Start all services")
When users ask for task details, host-level progress, or remaining tasks
When request progress is near 100% but not complete and user wants to know what's left
Args: request_id: ID of the Ambari request to inspect (integer string) status_filter: Optional status to filter on. Use exact status names (PENDING, IN_PROGRESS, COMPLETED, FAILED, ABORTED, TIMEDOUT) or prefix with "not:" to exclude that status (e.g. "not:COMPLETED" shows only unfinished tasks). host_filter: Optional hostname substring to restrict results to matching hosts.
Returns: Task list formatted as a table (success) or an error message (failure). - Success: header with request summary + per-task rows (task_id, host, role, status, duration) - Failure: English error message describing the problem
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| request_id | Yes | ||
| status_filter | No | ||
| host_filter | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |