Backfills data for task orchestration.

Description

During a data backfill, task flows are run in sequence based on their dates. You can specify whether task flows are run in chronological or reverse chronological order. After the data backfill is complete, you can specify a date or date range, and a node range to run task flows.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes BackFill

The operation that you want to perform. Set the value to BackFill.

Tid Long No 3***

The ID of the tenant.

Note To view the ID of the tenant, go to the Data Management (DMS) console and move the pointer over the profile picture in the upper-right corner. For more information, see View information about the current tenant.
DagId Long Yes 15***

The ID of the task flow. You can call the ListTaskFlow or ListLhTaskFlowAndScenario operation to query the task flow ID.

StartNodeIds Array of Long No 2

The number of nodes for which you want to backfill data.

IsTriggerSubTree Boolean No true

Specifies whether to run descendant nodes. Default value: true.

BackFillDate String No 2022-01-14

The date for the data to be backfilled. This parameter is required if you specify a date for data backfill.

BackFillDateBegin String No 2022-01-14

The start date of the date range for the data to be backfilled. This parameter is required if you specify a date range for data backfill.

BackFillDateEnd String No 2022-09-29

The end date of the date range for the data to be backfilled. This parameter is required if you specify a date range for data backfill.

Interval Integer No 24

The interval at which data backfill is performed. Unit: hours. Minimum value: 1. Default value: 24.

Asc Boolean No 0

The running sequence of task flows for data backfill. Valid values:

  • 0: reverse chronological order.
  • 1: chronological order. This is the default value.
HistoryDagId Long No 16***

The ID of the historical task flow.

The BackFillDate parameter is required if you specify a date for data backfill.

The BackFillDateBegin and BackFillDateEnd parameters are required if you specify a date range for data backfill.

Response parameters

Parameter Type Example Description
RequestId String 7FAD400F-7A5C-4193-8F9A-39D86C4F0231

The ID of the request.

ErrorCode String UnknownError

The error code returned if the request failed.

ErrorMessage String UnknownError

The error message returned if the request failed.

Success Boolean true

Indicates whether the request was successful. Valid values:

  • true: The request was successful.
  • false: The request failed.
NodeId Long 43****

The ID of the node.

Examples

Sample requests

http(s)://dms-enterprise.aliyuncs.com/?Action=BackFill
&DagId=15***
&Common request parameters

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<BackFillResponse>
    <RequestId>7FAD400F-7A5C-4193-8F9A-39D86C4F0231</RequestId>
    <Success>true</Success>
</BackFillResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "7FAD400F-7A5C-4193-8F9A-39D86C4F0231",
  "Success" : true
}

Error codes

For a list of error codes, visit the API Error Center.