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 |
|---|---|---|
| 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 |
| Created | Task has not been started yet |
| InProgress | Task is in progress |
| 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. Was 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 |