Queries the information and download URLs of file download tasks.
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 |
| PageSize |
string |
No |
The maximum number of entries to return on each page for a paged query. The default value is 10. The maximum value is 50. |
10 |
| CurrentPage |
string |
No |
The page number for a paged query. |
1 |
| TaskType |
string |
No |
The type of the task. This is an enumeration. For a list of valid values, see the API for querying file download task types. If you do not set this parameter, tasks for all file types are queried. |
InternetFirewallAsset |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| TotalCount |
integer |
The total number of tasks. |
132 |
| RequestId |
string |
The ID of the request. |
3F2BED13-F3D0-5984-80D6-D5F298CFEA88 |
| Tasks |
array<object> |
The list of tasks. |
|
|
object |
The task information. |
||
| TaskId |
string |
The task ID. |
1111 |
| TaskName |
string |
The name of the task. |
互联网边界防火墙资产-IPv4 |
| Status |
string |
The status of the task. Valid values:
|
finish |
| FileURL |
string |
The URL of the Object Storage Service (OSS) file. |
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 |
The size of the file. |
24.04KB |
| CreateTime |
integer |
The time when the task was created. This is a UNIX timestamp in seconds. |
1706595827 |
| ExpireTime |
integer |
The time when the task expires. This is a UNIX timestamp in seconds. |
1714371828 |
| TaskType |
string |
The type of the task. |
InternetFirewallAsset |
Examples
Success response
JSON format
{
"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"
}
]
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | ErrorAliUid | Aliuid invalid. | The aliuid is invalid. |
| 400 | ErrorPageNo | Either page number or page size is invalid. | Either page number or page size is invalid. |
| 400 | ErrorDBSelectError | A database select error occurred. | The error message returned because an internal error has occurred in querying the database. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.