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

DataWorks:RunCycleDagNodes

最終更新日:Mar 21, 2026

データバックフィル用のワークフローを作成します。

操作説明

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

今すぐお試しください

この 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。ノード ID は、ListNodes 操作を呼び出して取得できます。

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

任意

ノードに設定する必要があるパラメーター。JSON 文字列として設定します。キーはノード ID を、値はパラメーターの実際の値を表します。

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

IncludeNodeIds

string

必須

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

74324,74325

StartFutureInstanceImmediately

boolean

任意

将来スケジュールされたインスタンスを即時に実行するかどうかを指定します。true を指定した場合、将来スケジュールされたインスタンスは即時に実行されます。false を指定した場合は、スケジュール通りに実行されます。

false

ConcurrentRuns

integer

任意

並列実行可能なノード数。有効な値:2 ~ 10。

5

AlertType

string

任意

アラートの種類。有効な値:

  • SUCCESS:データバックフィルが成功した場合にアラートを生成します。

  • FAILURE:データバックフィルが失敗した場合にアラートを生成します。

  • SUCCESS_FAILURE:データバックフィルの成否に関わらずアラートを生成します。

FAILURE

AlertNoticeType

string

任意

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

  • SMS

  • MAIL

  • 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

ワークフロー内のノード ID。これらの ID を使用してインスタンスを照会できます。

integer

ワークフロー内のノード ID。

111

成功レスポンス

JSONJSON

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

エラーコード

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

変更履歴

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