全部產品
Search

搜尋本產品

    Cloud Firewall：CreateDownloadTask

    文件中心

    Cloud Firewall：CreateDownloadTask

    更新時間：Jun 18, 2026

    建立檔案下載任務。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    yundun-cloudfirewall:CreateDownloadTask

    create

    *全部资源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Lang

    string

    否

    接收訊息的語言類型。

    取值：

    • zh：（預設）中文

    • en：英文。

    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

    檔案下載任務的名稱。

    test-IPv4
    Status

    string

    任務狀態。取值：

    finish：任務完成。即任務已經完成，可以透過查詢任務，取得任務檔案下載連結。

    start：任務開始。

    error：任務失敗。

    expire：任務過期。即任務檔案已經失效，無法下載。

    start

    樣本

    正常返回樣本

    JSON格式

    {
  "TaskId": 132,
  "RequestId": "E7F333E0-7B70-54DA-A307-4B2B49DEE923",
  "TaskName": "test-IPv4",
  "Status": "start"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 ErrorAliUid Aliuid invalid.
    400 ErrorDBInsertError A database insert error occurred.

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。