创建文件下载任务。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| Lang |
string |
否 |
接收消息的语言类型。 取值：
|
zh |
| TaskType |
string |
否 |
任务类型，枚举值。可填枚举值见接口：查询文件下载任务类型。 |
InternetFirewallAsset |
| TaskData |
string |
否 |
下载任务的请求查询条件。 |
{\"SearchItem\":\"\",\"UserType\":\"buy\",\"IpVersion\":\"4\"} |
| TimeZone |
string |
否 |
下载文件中时间信息的时区，使用 IANA 时区标识符。默认为北京时间，即 Asia/Shanghai。 |
Asia/Shanghai |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| TaskId |
integer |
任务 Id，任务的唯一标识。 |
132 |
| RequestId |
string |
返回结果的请求 ID。 |
E7F333E0-7B70-54DA-A307-4B2B49DEE923 |
| TaskName |
string |
文件下载任务的名称。 |
互联网边界防火墙资产-IPv4 |
| Status |
string |
任务状态。取值： finish：任务完成。即任务已经完成，可以通过查询任务，获取任务文件下载链接。 start：任务开始。 error：任务失败。 expire：任务过期。即任务文件已经失效，无法下载。 |
start |
示例
正常返回示例
JSON格式
{
"TaskId": 132,
"RequestId": "E7F333E0-7B70-54DA-A307-4B2B49DEE923",
"TaskName": "互联网边界防火墙资产-IPv4",
"Status": "start"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | ErrorAliUid | Aliuid invalid. | aliuid无效 |
| 400 | ErrorDBInsertError | A database insert error occurred. | 内部错误：数据库插入错误 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。