CreateNode API と FlowSpec で DataStudio ノードをプロビジョニング - DataWorks - Alibaba Cloud - DataWorks

操作説明

重要この操作はバッチ操作をサポートしていません。FlowSpec に複数のノードが定義されている場合、最初のノード以降のすべてのノードは無視されます。

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ProjectId	integer	必須	DataWorks ワークスペースの ID です。DataWorks コンソールにログインし、ワークスペース管理ページに移動して ID を取得できます。このパラメーターは、この API 呼び出し操作の対象となる DataWorks ワークスペースを指定します。	123456
ContainerId	string	任意	ノードを作成するコンテナの一意の識別子です。コンテナにはワークフローまたはコンテナノードを指定できます。コンテナ内にノードを作成する必要がある場合に、このパラメーターを指定します。重要このパラメーターが指定されている場合、FlowSpec で定義されたパスフィールドは無効になります。重要このフィールドは、8.0.0 より前の SDK バージョンでは Long 型でしたが、SDK 8.0.0 以降では String 型になりました。この変更は通常の SDK の使用量に影響を与えず、パラメーターは引き続き SDK で定義された型で返されます。SDK バージョン 8.0.0 をまたいでスペックアップする場合にのみ、型の変更によりプロジェクトのコンパイルエラーが発生する可能性があり、データの型を手動で修正する必要があります。	23451286945488XXXX
Scene	string	必須	ノードが作成されるシナリオです。このパラメーターにより、ノードが手動ノードエリアとデータ開発エリアのどちらに作成されるかが決定されます。DATAWORKS_MANUAL_WORKFLOW は、ContainerId が指定されており、かつコンテナが手動ワークフローである場合にのみ使用できます。有効な値: DATAWORKS_PROJECT: プロジェクトディレクトリ。 DATAWORKS_MANUAL_WORKFLOW: 手動ワークフロー。 DATAWORKS_MANUAL_TASK: 手動タスク。	DATAWORKS_PROJECT
Spec	string	必須	ノードを記述する FlowSpec 情報です。仕様の詳細については、「 FlowSpec 」をご参照ください。説明 FlowSpec テンプレートをすばやく取得するにはどうすればよいですか？ DataStudio でノードを開き、右側の [バージョン] をクリックして最新バージョンを表示し、スケジューリング構成をビューします。これにより、現在のノードの FlowSpec 記述が得られます。バージョン内の FlowSpec 記述を使用して、要件を満たすテンプレートをすばやく構築できます。説明ノードの内容を指定するにはどうすればよいですか？ $.spec.nodes[].script.content フィールドにノードの内容を指定します。説明バッチ同期ノードの内容を設定するにはどうすればよいですか？コードエディターを使用したバッチ同期ノードの設定のステップ 4 に従ってスクリプトを作成し、$.spec.nodes[].script.content フィールドに内容を指定します。または、ページ上でバッチ同期ノードを作成し、バージョンを表示してスクリプトの内容を取得することもできます。	{ "version": "1.1.0", "kind": "Node", "spec": { "nodes": [ { "recurrence": "法線", "timeout": 0, "instanceMode": "T+1", "rerunMode": "Allowed", "rerunTimes": 3, "rerunInterval": 180000, "datasource": { "name": "odps_test" }, "script": { "path": "XX/OpenAPI_Test/odpsSQL_Test", "runtime": { "command": "ODPS_SQL" }, "content": "select now();" }, "trigger": { "type": "Scheduler", "cron": "00 00 00 * * ?", "startTime": "1970-01-01 00:00:00", "endTime": "9999-01-01 00:00:00", "timezone": "Asia/Shanghai", "delaySeconds": 0 }, "runtimeResource": { "resourceGroup": "S_res_group_XXXX_XXXX" }, "name": "odpsSQL_Test", "inputs": { "nodeOutputs": [ { "data": "project_root", "artifactType": "NodeOutput" } ] }, "outputs": { "nodeOutputs": [ { "data": "output_data", "artifactType": "NodeOutput", "refTableName": "odpsSQL_Test" } ] } } ] } }

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスのスキーマ。
RequestId	string	リクエスト ID です。この ID を使用してログの特定や問題のトラブルシューティングを行えます。	AFBB799F-8578-51C5-A766-E922EDB8XXXX
Id	string	データ開発ノードの一意の識別子です。重要このフィールドは、8.0.0 より前の SDK バージョンでは Long 型でしたが、SDK 8.0.0 以降では String 型になりました。この変更は通常の SDK の使用量に影響を与えず、パラメーターは引き続き SDK で定義された型で返されます。SDK バージョン 8.0.0 をまたいでスペックアップする場合にのみ、型の変更によりプロジェクトのコンパイルエラーが発生する可能性があり、データの型を手動で修正する必要があります。	860438872620113XXXX

例

成功レスポンス

JSONJSON

{
  "RequestId": "AFBB799F-8578-51C5-A766-E922EDB8XXXX",
  "Id": "860438872620113XXXX"
}

エラーコード

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

変更履歴

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