すべてのプロダクト
Search

このプロダクト

    DataWorks:UpdateTaskAsync

    ドキュメントセンター

    DataWorks:UpdateTaskAsync

    最終更新日:Sep 09, 2026

    指定されたノードを更新し、変更を DataStudio に同期して新しい保存バージョンを作成します。

    操作説明

    操作の説明

    • この API オペレーションは、指定されたノードの情報 (ノード名、説明、オーナーなど) を更新します。

    • 変更は DataStudio に同期され、DataStudio によって新しい保存バージョンが作成されます。

    • ノードのトリガーメソッド、実行環境構成、スクリプトのフォーマット、時間、依存関係などの詳細なパラメーターを設定できます。

    今すぐお試しください

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

    テスト

    RAM 認証

    この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

    リクエスト構文

    POST  HTTP/1.1

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Id

    integer

    必須

    ノードの ID。

    10001
    ClientUniqueCode

    string

    任意

    ノードのクライアント一意コード。ノードを一意に識別します。このコードは非同期呼び出しおよびべき等性に使用されます。作成時にこのパラメーターを指定しない場合、システムによって自動的に生成されます。コードはリソース ID に一意にバインドされます。リソースの更新または削除時にこのパラメーターを指定する場合、作成時に指定したクライアント一意コードと同じである必要があります。

    Workflow_0bc5213917368545132902xxxxxxxx
    EnvType

    string

    任意

    プロジェクト環境。有効な値:

    • Prod: 本番環境

    • Dev: 開発環境

    Prod
    Name

    string

    任意

    名前。

    名前
    Description

    string

    任意

    スクリプトの説明。

    これはスクリプトの説明です
    Owner

    string

    任意

    ノードオーナーのアカウント ID。DataWorks コンソール にログインし、上部ナビゲーションバーの右上隅にあるプロフィール画像にカーソルを合わせると、アカウント ID を確認できます。このパラメーターが空の場合、デフォルトで呼び出し元の Alibaba Cloud アカウント ID が使用されます。

    1000000000001
    InstanceMode

    string

    任意

    インスタンス生成モード。有効な値:

    • T+1: 翌日にインスタンスを生成します。

    • Immediately: 直ちにインスタンスを生成します。注: ノードの公開時間から少なくとも 10 分後のスケジュール時刻を持つ期間インスタンスのみが生成されます。全インスタンス生成期間 (22:00～24:00) は、リアルタイムインスタンス生成の呼び出しを利用できません。ノードを送信して公開することはできますが、新しいノードのインスタンスは自動生成されません。

    T+1
    Timeout

    integer

    任意

    スケジューリング構成のタイムアウト時間。

    1
    RerunMode

    string

    任意

    ノードを再実行できるかどうかを指定します。有効な値:

    • AllDenied: 成否にかかわらず再実行できません。

    • FailureAllowed: 失敗した場合にのみ再実行できます。

    • AllAllowed: 成否にかかわらず再実行できます。

    AllAllowed
    RerunTimes

    integer

    任意

    リトライ回数。このパラメーターは、ノードが再実行を許可するように構成されている場合に効果があります。

    3
    RerunInterval

    integer

    任意

    リトライ時間間隔 (ミリ秒単位)。値は 1800000 を超えることはできません。

    60000
    Script

    object

    任意

    スクリプトのフォーマット情報。

    Content deprecated

    string

    任意

    スクリプトの内容。

    echo "helloWorld"
    Parameters

    string

    任意

    スクリプトパラメーターのリスト。

    para1=$bizdate
    Trigger

    object

    任意

    ノードのトリガーメソッド。

    Cron

    string

    任意

    cron 式。このパラメーターは、type が Scheduler に設定されている場合に効果があります。

    00 00 00 * * ?
    CycleType

    string

    任意

    エポックタイプ。このパラメーターは、Type が Scheduler に設定されており、cron 式で特定の時間内の時間指定スケジューリングが指定されている場合に効果があります。デフォルト値: Daily。有効な値:

    • Daily: 日次スケジューリング

    • NotDaily: 時間次スケジューリング

    Daily
    EndTime

    string

    任意

    期間トリガーの有効期限が切れる時間。このパラメーターは、type が Scheduler に設定されている場合に効果があります。フォーマット: yyyy-mm-dd hh:mm:ss。

    9999-01-01 00:00:00
    Recurrence

    string

    任意

    トリガーが起動した際の実行モード。このパラメーターは、type が Scheduler に設定されている場合に効果があります。有効な値:

    • Pause: 一時停止

    • Skip: ドライラン

    • Normal: 法線

    法線
    StartTime

    string

    任意

    エポックトリガーの有効期間。このパラメーターは、type が Scheduler に設定されている場合に効果があります。フォーマット: yyyy-mm-dd hh:mm:ss。

    1970-01-01 00:00:00
    Type

    string

    任意

    トリガータイプ。有効な値:

    • Scheduler: 期間スケジューリングトリガー

    • Manual: 手動トリガー

    BySchedule
    RuntimeResource

    object

    任意

    スケジュールリソースグループ情報、フォーマット、時間などの実行環境構成。

    Cu

    string

    任意

    ノードに構成された CU 消費量。

    0.25
    Image

    string

    任意

    ノードに構成されたイメージ ID。

    i-xxxxxx
    ResourceGroupId

    string

    任意

    ノードに構成されたスケジュールリソースグループの識別子。

    63900680
    DataSource

    object

    任意

    関連付けられたデータソースのフォーマット情報。

    Name

    string

    任意

    データソース名。

    odps_test
    Inputs

    object

    任意

    入力のフォーマット情報。

    Variables

    array<object>

    任意

    変数定義のリスト。

    object

    任意

    変数定義のリスト。

    Name

    string

    任意

    変数名。

    key1
    Type

    string

    必須

    タイプ。有効な値:

    • Constant: 定数

    • PassThrough: パラメーターノード出力

    • System: 変数

    • NodeOutput: スクリプト出力

    Constant
    Value

    string

    任意

    変数値。

    値1
    Outputs

    object

    任意

    出力のフォーマット情報。

    TaskOutputs

    array<object>

    任意

    ノード出力定義のリスト。

    object

    任意

    ノード出力定義のリスト。

    Output

    string

    任意

    出力識別子。

    pre.odps_sql_demo_0
    Variables

    array<object>

    任意

    変数定義のリスト。

    object

    任意

    変数定義のリスト。

    Name

    string

    任意

    変数名。

    key1
    Type

    string

    必須

    タイプ。有効な値:

    • Constant: 定数

    • PassThrough: パラメーターノード出力

    • System: 変数

    • NodeOutput: スクリプト出力

    Constant
    Value

    string

    任意

    変数値。

    値1
    Dependencies

    array<object>

    任意

    依存関係のフォーマット情報。

    object

    任意

    依存関係のフォーマット情報。

    Type

    string

    必須

    依存関係タイプ。有効な値:

    • CrossCycleDependsOnChildren: 第 1 レベルの子ノードに対するクロスサイクル依存関係

    • CrossCycleDependsOnSelf: 現在のノードに対するクロスサイクル依存関係

    • CrossCycleDependsOnOtherNode: 他のノードに対するクロスサイクル依存関係

    • Normal: 法線

    法線
    UpstreamOutput

    string

    任意

    上流ノードの出力識別子。このフィールドは、依存関係タイプが同一サイクル依存関係であり、入力コンテンツが設定されている場合に返されます。

    pre.odps_sql_demo_0
    UpstreamTaskId

    integer

    任意

    上流ノードの ID。このフィールドは、依存関係タイプが他のノードに対するクロスサイクル依存関係、または入力コンテンツが設定されていない同一サイクル依存関係の場合に返されます。他の場合には返されません。

    1234
    Tags

    array<object>

    任意

    バインドするデータ資産タグのリスト。

    object

    任意

    ノードタグのリスト。

    Key

    string

    必須

    タグキー。

    tagKey
    Value

    string

    任意

    タグ値。

    値

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    OperationId

    string

    操作 ID。非同期ノード更新の結果を取得するために使用されます。UpdateTaskAsync 操作を呼び出して結果を取得できます。

    e15ad21c-b0e9-4792-8f55-b037xxxxxxxx
    RequestId

    string

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

    10000001

    例

    成功レスポンス

    JSONJSON

    {
  "OperationId": "e15ad21c-b0e9-4792-8f55-b037xxxxxxxx",
  "RequestId": "10000001"
}

    エラーコード

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

    変更履歴

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