get_request_tasks
Retrieve host-by-host task details for an Ambari request and filter by status or hostname to identify failed, pending, or running roles.
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
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"request_id": "<request_id>"
},
"name": "get_request_tasks"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| request_id | Yes | ID of the Ambari request to inspect (integer string) | |
| host_filter | No | Optional hostname substring to restrict results to matching hosts. | |
| status_filter | No | 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). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |