使用DescribeDownloadTask API查询文件下载任务-云防火墙-阿里云

查询文件下载任务，包括任务信息以及下载地址。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
Lang	string	否	接收消息的语言类型。取值： zh（默认）：中文 en：英文	zh
PageSize	string	否	分页查询时，显示的每页数据的最大条数。默认为 10。可设置值最大为 50。	10
CurrentPage	string	否	分页查询时，设置当前页的页码。	1
TaskType	string	否	任务类型，枚举值。可填枚举值见接口：查询文件下载任务类型。不填默认查询所有文件。	InternetFirewallAsset

返回参数

名称	类型	描述	示例值
	object
TotalCount	integer	任务总数。	132
RequestId	string	返回结果的请求 ID。	3F2BED13-F3D0-5984-80D6-D5F298CFEA88
Tasks	array<object>	任务列表。
	object	任务信息。
TaskId	string	任务 id。	1111
TaskName	string	任务名称。	互联网边界防火墙资产-IPv4
Status	string	任务状态。取值： finish：任务完成。 start：任务开始。 error：任务失败。 expire：任务过期。即任务文件已经失效，无法下载。	finish
FileURL	string	OSS 文件地址。	https://cfw-table-download-cn.oss-cn-hangzhou.aliyuncs.com/%E4%BA%92%E8%81%94%E7%BD%91%E8%BE%B9%E7%95%8C%E9%98%B2%E7%81%AB%E5%A2%99%E8%B5%84%E4%BA%A7-IPv4_1069.csv?Expires=1708583913&OSSAccessKeyId=**&Signature=****%3D
FileSize	string	文件大小。	24.04KB
CreateTime	integer	创建任务的时间。使用秒级时间戳格式表示。	1706595827
ExpireTime	integer	任务过期的时间。使用秒级时间戳格式表示。	1714371828
TaskType	string	任务类型。	InternetFirewallAsset

示例

正常返回示例

JSON格式

{
  "TotalCount": 132,
  "RequestId": "3F2BED13-F3D0-5984-80D6-D5F298CFEA88",
  "Tasks": [
    {
      "TaskId": "1111",
      "TaskName": "互联网边界防火墙资产-IPv4",
      "Status": "finish",
      "FileURL": "https://cfw-table-download-cn.oss-cn-hangzhou.aliyuncs.com/%E4%BA%92%E8%81%94%E7%BD%91%E8%BE%B9%E7%95%8C%E9%98%B2%E7%81%AB%E5%A2%99%E8%B5%84%E4%BA%A7-IPv4_1069.csv?Expires=1708583913&OSSAccessKeyId=****&Signature=******%3D",
      "FileSize": "24.04KB",
      "CreateTime": 1706595827,
      "ExpireTime": 1714371828,
      "TaskType": "InternetFirewallAsset"
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	ErrorAliUid	Aliuid invalid.	aliuid无效
400	ErrorPageNo	Either page number or page size is invalid.	无效的page number 或者 page size
400	ErrorDBSelectError	A database select error occurred.	内部错误：数据库查询错误

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。