全部產品
Search

搜尋本產品

    Data Management：CreateForecastAgent

    文件中心

    Data Management：CreateForecastAgent

    更新時間：Aug 25, 2026

    建立 forecast agent 執行個體。

    介面說明

    建立資產盤點任務，支援選擇執行個體、資料庫、資料表維度進行知識盤點，並返回任務 ID。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    dms:CreateForecastAgent

    create

    *全部資源。

    *

    		 無 無

    請求文法

    POST  HTTP/1.1

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    DataRegion

    string

    否

    資料湖所屬的地域。

    cn-hangzhou
    DryRun

    boolean

    否

    是否開啟 DryRun 模式。true：開啟；false（預設值）：關閉。DryRun 模式用於測試 API 呼叫，驗證您是否具有相應資源的權限，以及請求參數是否設定正確。DryRun 模式開啟後，KMS 會始終返回失敗並提示失敗原因。失敗原因包含如下：DryRunOperationError：不設定 DryRun 參數時，請求會成功。ValidationError：請求中指定的參數有誤。AccessDeniedError：您無權在 KMS 資源上執行該操作。

    True

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    Id of the request

    427688B8-ADFB-4C4E-9D45-EF5C1FD6****
    HttpStatusCode

    integer

    HTTP 狀態碼。

    200
    Success

    boolean

    請求是否成功，返回值如下：

    • true：請求成功。

    • false：請求失敗。

    true
    ErrorCode

    string

    錯誤碼。

    UnknownError
    Message

    string

    執行失敗時，返回的錯誤資訊。

    UnknownError
    Root

    object

    Dify 相關資訊。

    InstanceUuid

    string

    恢復目標伺服器資料庫備份用戶端唯一識別碼。

    說明

    呼叫 DescribeUniBackupDatabase 介面可以獲取此參數。

    ***
    RegionId

    string

    選擇 DMS 的服務地域，用於呼叫此介面，取值請參見 RegionID 參數說明。

    說明

    請根據應用程式所在地就近選擇。

    cn-chengdu
    Status

    string

    Dify 執行個體的狀態。包括 DEPLOYED（執行中）、未設定等。

    DEPLOYED
    CurrentStep

    string

    任務目前操作步驟數。

    PRE_CHECK
    TaskId

    string

    任務 ID。

    t-0002kwya4y5ydqvuof6b
    ImageVersion

    string

    映像版本。

    說明

    當您指定了執行個體 ID（InstanceId），並且該執行個體的映像是雲端市場映像或來自雲端市場映像建立的自訂映像時，此參數必須與目前執行個體映像的 ImageVersion 相同或設為空值。

    3.5.3.925
    FailureMessage

    string

    失敗訊息。建立失敗後，返回此欄位。

    missing parameter: aliyunParentUid

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "427688B8-ADFB-4C4E-9D45-EF5C1FD6****",
  "HttpStatusCode": 200,
  "Success": true,
  "ErrorCode": "UnknownError",
  "Message": "UnknownError",
  "Root": {
    "InstanceUuid": "***",
    "RegionId": "cn-chengdu",
    "Status": "DEPLOYED",
    "CurrentStep": "PRE_CHECK",
    "TaskId": "t-0002kwya4y5ydqvuof6b",
    "ImageVersion": "3.5.3.925",
    "FailureMessage": "missing parameter: aliyunParentUid"
  }
}

    錯誤碼

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

    變更歷史

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