全部产品
Search

搜索本产品

    云防火墙：DescribeDownloadTask - 查询文件下载任务

    文档中心

    云防火墙：DescribeDownloadTask - 查询文件下载任务

    更新时间：Sep 05, 2024

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

    调试

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

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。
    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
      • 对于必选的资源类型，用背景高亮的方式表示。
      • 对于不支持资源级授权的操作，用全部资源表示。
    • 条件关键字：是指云产品自身定义的条件关键字。
    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
    操作访问级别资源类型条件关键字关联操作
    yundun-cloudfirewall:DescribeDownloadTasklist
    • 全部资源
      *
      无
    		无

    请求参数

    名称类型必填描述示例值
    Langstring否

    接收消息的语言类型。取值：

    • zh（默认）：中文
    • en：英文
    		zh
    PageSizestring否

    分页查询时，显示的每页数据的最大条数。默认为 10。 可设置值最大为 50。

    		10
    CurrentPagestring否

    分页查询时，设置当前页的页码。

    		1
    TaskTypestring否

    任务类型，枚举值。可填枚举值见接口：查询文件下载任务类型。不填默认查询所有文件。

    		InternetFirewallAsset

    返回参数

    名称类型描述示例值
    object
    TotalCountinteger

    任务总数。

    		132
    RequestIdstring

    返回结果的请求 ID。

    		3F2BED13-F3D0-5984-80D6-D5F298CFEA88
    Tasksarray<object>

    任务列表。

    object

    任务信息。

    TaskIdstring

    任务 id。

    		1111
    TaskNamestring

    任务名称。

    		互联网边界防火墙资产-IPv4
    Statusstring

    任务状态。取值：

    • finish：任务完成。
    • start：任务开始。
    • error：任务失败。
    • expire：任务过期。即任务文件已经失效，无法下载。
    		finish
    FileURLstring

    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
    FileSizestring

    文件大小。

    		24.04KB
    CreateTimelong

    创建任务的时间。使用秒级时间戳格式表示。

    		1706595827
    ExpireTimelong

    任务过期的时间。使用秒级时间戳格式表示。

    		1714371828
    TaskTypestring

    任务类型。

    		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错误码错误信息描述
    400ErrorAliUidAliuid invalid.aliuid无效
    400ErrorPageNoEither page number or page size is invalid.无效的page number 或者 page size
    400ErrorDBSelectErrorA database select error occurred.内部错误：数据库查询错误

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

    变更历史

    变更时间变更内容概要操作
    2024-09-05OpenAPI 描述信息更新、OpenAPI 错误码发生变更查看变更详情