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

DataWorks:ListSemanticJobs

最終更新日:Sep 03, 2026

現在のテナントのセマンティックノード解像度をページングしてクエリします。リスト項目の Name、ProjectId、Source フィールドは、それぞれノードの実行/削除、実行詳細のクエリ、入力範囲の確認に使用できます。

操作説明

シナリオ

現在のテナントの保存済みセマンティックノード解像度をページングしてクエリします。この操作を使用して、ノードリストを表示したり、実行するノードを選択したり、ノードが属するワークスペースを取得したりできます。

呼び出しフロー

  1. PageNumber と PageSize を使用して Data.SemanticJobs をページングして読み取ります。

  2. リスト項目の Name フィールドを使用して RunSemanticJob、DeleteSemanticJob、または ListSemanticJobRuns を呼び出します。

  3. リスト項目の ProjectId フィールドを ExecutorJobId と組み合わせて使用し、詳細、ログ、および停止操作を呼び出します。

注意事項

この操作はリアルタイムの実行ステータスではなく、ノード解像度を返します。実行ステータスをクエリするには、ListSemanticJobRuns を呼び出してください。

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

PageNumber

integer

任意

ページ番号。1 から始まります。このパラメーターが指定されていないか、0 以下の値に設定されている場合、1 ページ目が返されます。

1

PageSize

integer

任意

1 ページあたりのタスク解像度の数。このパラメーターが指定されていないか、0 以下の値に設定されている場合、デフォルト値 50 が使用されます。最大値: 200。

50

各リクエストフィールドの説明に基づいて呼び出しパラメーターを構築してください。

レスポンスフィールド

フィールド

型

説明

例

object

ノード解像度のページングクエリの標準的な応答です。Data.SemanticJobs の各項目は、後続の実行またはクエリに対してアクティブなノード解像度です。

RequestId

string

リクエスト ID。ログの特定や問題のトラブルシューティングに使用されます。

676271D6-53B4-57BE-89FA-72F7AE1418DF

Success

boolean

リクエストが成功したかどうかを示します。

Data

object

タスク解像度のページング結果。リスト項目の Name フィールドを使用して、実行、削除、実行レコードのクエリ、または結果のダウンロードを行います。ProjectId フィールドを使用して、実行の詳細、ログのクエリ、または実行の停止を行います。

TotalCount

integer

現在のテナントで条件を満たすタスク解像度の総数。

1

PageNumber

integer

返されるページ番号。1 から始まります。

1

PageSize

integer

返される 1 ページあたりのタスク解像度の数。

50

SemanticJobs

array<object>

タスク解像度のリスト。

array<object>

保存済みのセマンティックタスク解像度。フィールドの意味は CreateSemanticJob の Data パラメーターのものと同じです。

Id

integer

タスク解像度の内部一意 ID。

1

Name

string

タスク名。RunSemanticJob、DeleteSemanticJob、ListSemanticJobRuns、および DownloadSemanticResults に使用されます。

semantic-job-demo

UserId

string

セマンティックタスク作成者のユーザー ID。

user-demo

Creator

string

セマンティックタスク作成者のユーザー ID。

user-demo

ProjectId

integer

タスクが属するワークスペースの ID。GetSemanticJobDetail、GetSemanticJobLog、KillSemanticJob に使用されます。

100

Type

string

タスクに保存されている Source.type データソースタイプ。

maxcompute

Source

object

ノードに保存された入力データソース構成。この構成により、ランタイム時の分析範囲が決定されます。

ReferenceFileIds

array

タスクに関連付けられたアップロード済みファイル ID のリスト。

string

アップロードされたリファレンスファイル ID のオプションリスト。

semantic-job-value

ReferenceFileUris

array

タスクに関連付けられた外部リファレンスファイル URI のリスト。

string

アクセス可能なリファレンスファイル URI のオプションリスト。

semantic-job-value

GmtCreate

integer

作成時間。ミリ秒単位の UNIX タイムスタンプで表されます。

1700000000000

GmtModified

integer

最終更新時間。ミリ秒単位の UNIX タイムスタンプで表されます。

1700000000000

ResourceGroupId

string

このタスクの実行に使用されるリソースグループの ID。

rg-demo

応答フィールドの意味と後続の呼び出しとの関係については、フィールドの説明を参照してください。

例

成功レスポンス

JSONJSON

{
  "RequestId": "676271D6-53B4-57BE-89FA-72F7AE1418DF",
  "Success": false,
  "Data": {
    "TotalCount": 1,
    "PageNumber": 1,
    "PageSize": 50,
    "SemanticJobs": [
      {
        "Id": 1,
        "Name": "semantic-job-demo",
        "UserId": "user-demo",
        "Creator": "user-demo",
        "ProjectId": 100,
        "Type": "maxcompute",
        "Source": {
          "test": "test",
          "test2": 1
        },
        "ReferenceFileIds": [
          "semantic-job-value"
        ],
        "ReferenceFileUris": [
          "semantic-job-value"
        ],
        "GmtCreate": 1700000000000,
        "GmtModified": 1700000000000,
        "ResourceGroupId": "rg-demo"
      }
    ]
  }
}

エラーコード

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

変更履歴

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