作成済みのタスクの名前を指定して、セマンティックタスク解像度を削除します。タスクが現在実行中の場合は、その実行の ExecutorJobId を指定して KillSemanticJob を呼び出し、停止を確認してから削除してください。
操作説明
シナリオ
保存済みのセマンティックタスク解像度をアーカイブおよび削除し、利用可能なタスクリストに表示されないようにします。
呼び出しフロー
CreateSemanticJob.Data.NameまたはListSemanticJobs.Data.SemanticJobs[].Nameからタスク名を取得します。アクティブな実行が存在するかどうかを確認するには、まず
ListSemanticJobRunsを呼び出します。必要に応じて、KillSemanticJobを呼び出して実行を停止します。この操作を呼び出してタスク解像度を削除します。
結果の説明
応答が成功した場合、削除リクエストが完了したことを示します。削除後、その名前を使用して RunSemanticJob を呼び出すことはできなくなります。
今すぐお試しください
テスト
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
}
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。