すべてのプロダクト
Search
ドキュメントセンター

DataWorks:RunCycleDagNodes

最終更新日:Jul 31, 2026

RunCycleDagNodes を呼び出してデータバックフィルワークフローを作成します。

操作説明

データバックフィルの詳細については、「データバックフィル」を参照してください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

dataworks:*

get

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

ProjectEnv

string

必須

ワークスペースの環境。PROD は本番環境を示します。DEV は開発環境を示します。

列挙値:

  • PROD :

    本番環境。

  • DEV :

    開発環境。

PROD

StartBizDate

string

必須

データバックフィルの開始業務日。フォーマット: yyyy-MM-dd 00:00:00。

2020-05-20 00:00:00

Name

string

必須

ワークフローの名前。

xm_test

RootNodeId

integer

必須

データバックフィルの開始ノードの ID。 ListNodes 操作を呼び出してノード ID を取得できます。

1234

ExcludeNodeIds

string

任意

データバックフィルが不要なノード ID のリスト。このリスト内のノードはドライランインスタンスを生成します。ドライランインスタンスはスケジューリング後、スクリプトの内容を実行せずに直接成功します。

1234,123465

BizBeginTime

string

任意

ノードの開始時刻。このパラメーターは時間単位のスケジューリングノードにのみ必須です。フォーマット: HH:mm:ss。有効な値: 00:00:00~23:59:59。

00:00:00

BizEndTime

string

任意

ノードの終了時刻。このパラメーターは時間単位のスケジューリングノードにのみ必須です。フォーマット: HH:mm:ss。有効な値: 00:00:00~23:59:59。

01:00:00

Parallelism

boolean

必須

複数の業務日にまたがるノードを並列実行できるかどうかを指定します。

false

EndBizDate

string

必須

データバックフィルの終了業務日。フォーマット: yyyy-MM-dd 00:00:00。

2020-05-21 00:00:00

NodeParams

string

任意

キーがノード ID、値が実パラメーター値である JSON 文字列。

{"74324":"a=123 b=456"}

IncludeNodeIds

string

必須

データバックフィル対象のノード ID。複数のノード ID はカンマ (,) で区切ります。 ListNodes 操作を呼び出してノード ID を取得できます。

74324,74325

StartFutureInstanceImmediately

boolean

任意

スケジューリング時間が未来のインスタンスをすぐに実行するかどうかを指定します。このパラメーターを true にセットすると、現在時刻より後のスケジューリング時間を持つインスタンスがすぐに実行されます。それ以外の場合、インスタンスはスケジューリング時間まで待機します。

false

ConcurrentRuns

integer

任意

同時実行ノード数。有効な値: 2~10。

5

AlertType

string

任意

アラームメトリクス。有効な値:

  • SUCCESS: 成功時のアラート。

  • FAILURE: 失敗した際のアラート。

  • SUCCESS_FAILURE: 成功または失敗した際のアラート。

列挙値:

  • SUCCESS :

    成功時のアラート。

  • SUCCESS_FAILURE :

    成功または失敗時のアラート。

  • FAILURE :

    失敗時のアラート。

FAILURE

AlertNoticeType

string

任意

アラート通知方法。有効な値:

  • SMS: テキストメッセージ。

  • MAIL: メール。

  • SMS_MAIL: テキストメッセージとメール。

列挙値:

  • MAIL :

    メール。

  • SMS :

    テキストメッセージ。

  • SMS_MAIL :

    テキストメッセージとメール。

SMS

レスポンスフィールド

フィールド

型

説明

例

object

応答エンティティ。

HttpStatusCode

integer

HTTP 状態コード。

200

RequestId

string

リクエスト ID。この ID を使用してログを特定し、問題のトラブルシューティングを行えます。

>E6F0DBDD-5AD****

ErrorMessage

string

エラーメッセージ。

The connection does not exist

Success

boolean

呼び出しが成功したかどうかを示します。

true

ErrorCode

string

エラーコード。

Invalid.Tenant.ConnectionNotExists

Data

array

データバックフィルインスタンスによって返される DagId。この DagId を使用して対応するインスタンスをクエリできます。

integer

ワークフロー ID のリスト。

111

例

成功レスポンス

JSONJSON

{
  "HttpStatusCode": 200,
  "RequestId": ">E6F0DBDD-5AD****",
  "ErrorMessage": "The connection does not exist.",
  "Success": true,
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
  "Data": [
    111
  ]
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。