You need to enable JavaScript to run this app.
Torch Log Service

Torch Log Service

Copy page
Download PDF
Log management API
DescribeDownloadUrl
Copy page
Download PDF
DescribeDownloadUrl
Call the DescribeDownloadUrl interface to get the download link for the log corresponding to the specified task.​
Usage notes​
This interface is used to obtain the download link corresponding to the specified log download task. Through this download link, the corresponding log data can be directly downloaded without authentication.​
tip​
  • Before calling this interface, it is recommended to check the status of the download task through the DescribeDownloadTasks. Only tasks with success (file generated) and partially created_cut (file generation interrupted) status can download the corresponding files.​
  • The valid period of the link is 5 minutes. Please download it in time after getting the download link. If the link is invalid, you need to call this interface again to get a new download link.​
  • The calling frequency of this interface is limited to 20 times/s, and an error ExceedQPSLimit will be reported if the frequency limit is exceeded.​
Request syntax​
  • Request Method:GET​
  • Request URL:https://{tls-endpoint}/DescribeDownloadUrl​
Request parameters​
The table below only lists the request parameters specific to this interface and some common parameters. For more information, please see Common parameters.​
Query​
​
Name​
Type​
Required​
Example​
Description​
TaskId​
String​
True​
4a9bd4bd-53f1-43ff-b88a-64ee1be5****​
The task ID of the download task.​
​
Responses​
The table below only lists the return parameters specific to this interface. For more information, please refer to the Response message.​
​
Name​
Type​
Example​
Description​
DownloadUrl​
String​
https://www.******​
Designate the download link corresponding to the download task.​
The link is valid for 5 minutes. Please download it in time after getting the download link. If the link is invalid, you need to call this interface again to get a new download link.​
​
Sample Request​
​
GET /DescribeDownloadUrl?TaskId=9f* HTTP/1.1​
Content-Type: application/json​
...​
{​
}​
​
Sample Response​
​
HTTP/1.1 200 OK​
Content-Type: application/json​
Content-Length: 0 ​
{​
"DownloadUrl": "https://www.******"​
}​
​
Error code​
The following table lists the error codes related to the interface and business logic. For common error codes, please refer to the Common error codes.​
​
HTTP status code​
Error code​
Error message​
Description​
404​
ErrDownloadTaskNotExists​
Task does not exist​
The download task does not exist​
500​
InternalServerError​
We encountered an unexpected server error, please try again later.​
Internal server error.​
​
​
​
Last updated: 2025.10.29 14:35:21