文档

BackFill - 给任务编排补数据

更新时间:

调用BackFill接口,给任务编排补数据。

接口说明

补充数据时,任务流按照日期串行执行,可指定按日期升序或降序执行。补充数据完成后,可指定日期或日期范围,以及节点范围来运行任务流。

调试

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

授权信息

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

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

请求参数

名称类型必填描述示例值
Tidlong

租户 ID。

说明 取自系统右上角头像处悬停展示的租户 ID 信息,详情请参见查看租户信息
3***
DagIdlong

任务流 ID,可通过调用接口 ListTaskFlowListLhTaskFlowAndScenario 获取该参数的值。

15***
StartNodeIdsarray

补数据开始节点 ID 列表。

说明 参数缺省时运行整个任务流。
long

待补数据的任务节点数。

2
FilterNodeIdsarray

过滤条件,指定任务流中无需补数据的节点 Id 列表。

long

任务流中无需补数据的节点 ID。

12***
IsTriggerSubTreeboolean

是否运行下游节点。缺省时默认为 true。

true
BackFillDatestring

补数据业务时间。指定时间补数据需要填写该参数。

2022-01-14
BackFillDateBeginstring

补数据开始业务时间。指定时间范围补数据需要填写该参数。

2022-01-14
BackFillDateEndstring

补数据结束业务时间。指定时间范围补数据需要填写该参数。

2022-09-29
Intervalinteger

补数据时间间隔,单位:小时。最小值:1,默认值:24。

24
Ascboolean

补数据任务流运行顺序。取值:

  • 0:降序。从大日期到小日期。
  • 1:默认值,升序。从小日期到大日期。
0
HistoryDagIdlong

历史任务流 ID。

说明 若您未填写该参数,在调用 API 时,系统会自动获取最近发布的任务流版本 ID 作为该参数的值。若没有发布过任务流,系统获取不到任务流版本 ID,则调用会出错。
16***

指定日期补数据,需提供 BackFillDate 参数。
指定时间范围补数据,需提供 BackFillDateBegin 和 BackFillDateEnd 参数。

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

7FAD400F-7A5C-4193-8F9A-39D86C4F0231
ErrorCodestring

错误码。

UnknownError
ErrorMessagestring

调用失败时,返回的错误信息。

UnknownError
Successboolean

请求是否成功,返回值如下:

  • true:请求成功
  • false:请求失败
true
DagInstanceIdlong

任务流运行记录 ID,可通过调用接口 ListTaskFlowInstance 获取该参数的值。

47****
NodeIdlong

同 DagInstanceId。

47****

示例

正常返回示例

JSON格式

{
  "RequestId": "7FAD400F-7A5C-4193-8F9A-39D86C4F0231",
  "ErrorCode": "UnknownError",
  "ErrorMessage": "UnknownError",
  "Success": true,
  "DagInstanceId": 0,
  "NodeId": 0
}

错误码

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

变更历史

变更时间变更内容概要操作
2023-05-25OpenAPI 入参发生变更、OpenAPI 返回结构发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:FilterNodeIds
出参OpenAPI 返回结构发生变更
  • 本页导读 (1)
文档反馈