CancelTask
指定したタスクのキャンセル要求を送信します。まだタスクが QUEUED 状態の場合にのみタスクをキャンセルできます。既に実行中のタスクは、キャンセルできません。
注記
CancelTask オペレーションがタスクの状態を変更する前にタスクがキューから処理された場合、タスクが実行されることがあります。
リクエストの構文
POST /task/taskId/cancel HTTP/1.1
URI リクエストパラメータ
リクエストでは、次の URI パラメータを使用します。
- taskId
-
キャンセルしようとしているタスクの ID。
ListTasksオペレーションでタスク ID を取得することができます。長さの制限：最小長は 1 です。最大長は 64 文字です。
必須: はい
リクエストボディ
リクエストにリクエスト本文がありません。
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"taskId": "string"
}レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- taskId
-
キャンセルしようとしているタスクの ID。
型: 文字列
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- AccessDeniedException
-
このアクションを実行する十分なアクセス権限がありません。
HTTP ステータスコード: 403
- InternalServerException
-
リクエストの処理中に予期しないエラーが発生しました。
HTTP ステータスコード：500
- ResourceNotFoundException
-
リクエストは、存在しないリソースを参照しています。
HTTP ステータスコード: 404
- ThrottlingException
-
リクエストのスロットリングにより、リクエストが拒否されました。
HTTP ステータスコード: 429
- ValidationException
-
入力が、AWS サービスで指定された制約を満たしていません。
HTTP ステータスコード：400
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
