調用CreateDISyncTask創建數據集成同步任務。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| dataworks:* | get | *全部資源 * |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ProjectId | long | 是 | DataWorks 工作空間的 ID。您可以登錄 DataWorks 控制臺，進入工作空間配置頁面獲取工作空間 ID。 | 10000 |
| TaskType | string | 是 | 創建的數據集成同步任務的任務類型。 目前支持使用 CreateDISyncTask 接口創建數據集成離線同步任務（DI_OFFLINE），實時同步任務（DI_REALTIME）和解決方案（DI_SOLUTION）。 | DI_OFFLINE |
| TaskContent | string | 是 | 數據集成同步任務的腳本內容。 | {"type":"job","version":"2.0","steps":[{"stepType":"mysql","parameter":{"envType":1,"datasource":"mysql_pub","column":["id","name","create_time","age","score","t_01"],"connection":[{"datasource":"mysql_pub","table":["u_pk"]}],"where":"","splitPk":"id","encoding":"UTF-8"},"name":"Reader","category":"reader"},{"stepType":"odps","parameter":{"partition":"pt=${bizdate}","truncate":true,"datasource":"odps_first","envType":1,"column":["id","name","create_time","age","score","t_01"],"emptyAsNull":false,"tableComment":"null","table":"u_pk"},"name":"Writer","category":"writer"}],"setting":{"executeMode":null,"errorLimit":{"record":""},"speed":{"concurrent":2,"throttle":false}},"order":{"hops":[{"from":"Reader","to":"Writer"}]}} |
| TaskParam | string | 是 | 數據集成同步任務的配置參數。目前支持配置如下參數：
| {"FileFolderPath":"業務流程/XXX/數據集成","ResourceGroup":"Serverless_res_group_XXX_XXXX", "Cu":1.5} |
| TaskName | string | 是 | 創建的數據集成同步任務的名稱。 | new_di_task |
| ClientToken | string | 否 | 冪等參數，該參數可為空。 | 0000-ABCD-EFG**** |
返回參數
示例
正常返回示例
JSON格式
{
"Success": true,
"RequestId": "0bc1411515937635973****",
"Data": {
"Status": "success",
"Message": "不合法的目錄路徑：業務流程/xxxx/數據集成",
"FileId": 1000001
}
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | Invalid.DI.Parameter | The parameter is invalid. | 參數錯誤 |
| 400 | Invalid.DI.Parameter.File.Existed | The file name already exists. | 參數不合法，文件名已存在 |
| 403 | Forbidden.DI.NoPrivilege | No access. | 沒有權限訪問 |
| 500 | InternalError.DI.Parameter | A DI internal error occurred. | 數據集成內部業務錯誤 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2024-09-23 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |