GetDownloadTaskStatus Tool
Retrieves the current status and request/response details for a download task, including errors and intermediate attempts for troubleshooting and monitoring.
Arguments
| Name | Type | Description |
|---|---|---|
| taskId | String | Required. The ID of the download task to check. |
Return Type
Returns a DownloadTaskStatus
DownloadTaskStatus
Download task execution status
Fields
| Name | Type | Description |
|---|---|---|
| Error | String | Optional. Request execution error |
| TaskState | DownloadTaskStates | Optional. Task state |
| Result | DownloadInfo | Optional. Download result |
| IntermedResults | Array of DownloadInfo | Optional. Intermediate requests download results stack |
DownloadTaskStates
Download task states enumeration.
Values
| Name | Description |
|---|---|
| Handled | Task is handled and its results are available |
| AccessDeniedForRobots | Access to a URL is denied by robots.txt |
| AllRequestGatesExhausted | All request gateways (proxy and host IP addresses) were exhausted but no data was received |
| InProgress | Task is in progress |
| Created | Task has not been started yet |
| Deleted | Task has been deleted |
DownloadInfo
Download attempt information
Fields
| Name | Type | Description |
|---|---|---|
| Method | String | Required. HTTP method |
| Url | String | Required. Request URL |
| IsSuccess | Bool | Required. Was the request successful |
| HttpStatusCode | Int | Required. HTTP status code |
| ReasonPhrase | String | Required. HTTP reason phrase |
| RequestHeaders | Array of HttpHeader | Required. HTTP headers sent with the request |
| ResponseHeaders | Array of HttpHeader | Required. HTTP headers received in the response |
| RequestCookies | Array of Cookie | Required. Cookies sent with the request |
| ResponseCookies | Array of Cookie | Required. Cookies received in the response |
| RequestDateUtc | DateTime | Required. Request date and time in UTC |
| DownloadTimeSec | Double | Required. Download time in seconds |
| ViaProxy | Bool | Required. Is the request made via a proxy |
| WaitTimeSec | Double | Required. What was the delay (in seconds) before the request was executed (crawl latency, etc.) |
| CrawlDelaySec | Int | Required. A delay in seconds applied to the request |
HttpHeader
HTTP header
Fields
| Name | Type | Description |
|---|---|---|
| Name | String | Required. Header name |
| Values | Array of String | Required. Header values |
Cookie
Fields
| Name | Type | Description |
|---|---|---|
| Name | String | Required. Name |
| Value | String | Required. Value |
| Domain | String | Required. Domain |
| Path | String | Required. Path |
| HttpOnly | Bool | Required. HttpOnly |
| Secure | Bool | Required. Secure |
| Expires | DateTime | Optional. Expires |