Creates a file download task.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| Lang |
string |
No |
The language of the response message. Valid values:
|
zh |
| TaskType |
string |
No |
The type of the task. For a list of valid values, see the API for querying file download task types. |
InternetFirewallAsset |
| TaskData |
string |
No |
The query conditions for the download task. |
{\"SearchItem\":\"\",\"UserType\":\"buy\",\"IpVersion\":\"4\"} |
| TimeZone |
string |
No |
The time zone of the time information in the downloaded file. The value is an IANA time zone identifier. The default value is Asia/Shanghai, which corresponds to UTC+8. |
Asia/Shanghai |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| TaskId |
integer |
The unique ID of the task. |
132 |
| RequestId |
string |
The ID of the request. |
E7F333E0-7B70-54DA-A307-4B2B49DEE923 |
| TaskName |
string |
The name of the file download task. |
互联网边界防火墙资产-IPv4 |
| Status |
string |
The status of the task. Valid values: finish: The task is complete. You can query the task to get the file download link. start: The task has started. error: The task failed. expire: The task expired. The task file is invalid and cannot be downloaded. |
start |
Examples
Success response
JSON format
{
"TaskId": 132,
"RequestId": "E7F333E0-7B70-54DA-A307-4B2B49DEE923",
"TaskName": "互联网边界防火墙资产-IPv4",
"Status": "start"
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | ErrorAliUid | Aliuid invalid. | The aliuid is invalid. |
| 400 | ErrorDBInsertError | A database insert error occurred. | An error occurred while performing an insert operation in the database. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.