翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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"
}レスポンス要素
アクションが成功すると、サービスは 200 HTTP レスポンスを送り返します。
次のデータは、 サービスによって JSON 形式で返されます。
- taskId
-
キャンセルしようとしているタスクの ID。
型: 文字列
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- AccessDeniedException
-
このアクションを実行する十分なアクセス権限がありません。
HTTP ステータスコード: 403
- InternalServerException
-
リクエストの処理中に予期しないエラーが発生しました。
HTTP ステータスコード: 500
- ResourceNotFoundException
-
リクエストは、存在しないリソースを参照しています。
HTTP ステータスコード: 404
- ThrottlingException
-
リクエストのスロットリングにより、リクエストが拒否されました。
HTTP ステータスコード: 429
- ValidationException
-
入力が AWS サービスで指定された制約を満たさない。
HTTP ステータスコード: 400
以下の資料も参照してください。
言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。
