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

DataWorks:DeleteSemanticJob

最終更新日:Sep 03, 2026

作成済みのタスクの名前を指定して、セマンティックタスク解像度を削除します。タスクが現在実行中の場合は、その実行の ExecutorJobId を指定して KillSemanticJob を呼び出し、停止を確認してから削除してください。

操作説明

シナリオ

保存済みのセマンティックタスク解像度をアーカイブおよび削除し、利用可能なタスクリストに表示されないようにします。

呼び出しフロー

  1. CreateSemanticJob.Data.Name または ListSemanticJobs.Data.SemanticJobs[].Name からタスク名を取得します。

  2. アクティブな実行が存在するかどうかを確認するには、まず ListSemanticJobRuns を呼び出します。必要に応じて、KillSemanticJob を呼び出して実行を停止します。

  3. この操作を呼び出してタスク解像度を削除します。

結果の説明

応答が成功した場合、削除リクエストが完了したことを示します。削除後、その名前を使用して RunSemanticJob を呼び出すことはできなくなります。

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

Name

string

必須

削除するタスクの名前。CreateSemanticJob の応答の Data.Name 値、または ListSemanticJobs のリスト項目の Name 値を使用します。

semantic-job-demo

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

レスポンスフィールド

フィールド

型

説明

例

object

セマンティックタスク削除の標準応答です。Data はアーカイブ削除の結果を示します。

RequestId

string

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

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

Success

boolean

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

Data

object

タスクの削除結果。削除時は、引き続き実行可能なタスク解像度は返されません。

Id

integer

削除されたタスク解像度の内部一意 ID。

1

JobName

string

削除前の元のタスク名。このリクエストで指定された Name です。

semantic-job-demo

ArchivedJobName

string

アーカイブ Record に対してシステムによって生成されたタスク名。この名前は削除済み Record の識別にのみ使用され、RunSemanticJob には使用できません。

semantic-job-demo-archived

Deleted

boolean

削除が完了したかどうかを示します。値が true の場合、タスクがアーカイブおよび削除されたことを示します。

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

例

成功レスポンス

JSONJSON

{
  "RequestId": "676271D6-53B4-57BE-89FA-72F7AE1418DF",
  "Success": false,
  "Data": {
    "Id": 1,
    "JobName": "semantic-job-demo",
    "ArchivedJobName": "semantic-job-demo-archived",
    "Deleted": false
  }
}

エラーコード

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

変更履歴

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