AWS Batchで最大50件のジョブを一括キャンセル・終了できる新APIを導入

AWS Batchにおいて、最大50件のジョブを1回のAPIコールでキャンセルまたは終了できる新API（CancelJobs, TerminateJobs, TerminateServiceJobs）が導入されました。これにより、SUBMITTED、PENDING、RUNNABLE状態のジョブはCancelJobsで、STARTINGやRUNNINGを含むあらゆる状態のジョブはTerminateJobsおよびTerminateServiceJobsで一括操作が可能です。また、ListJobsおよびListServiceJobs APIにキャンセル・終了状態を示すフィールド（isCancelled, isTerminated）が追加され、ジョブのライフサイクル管理の観測性が向上しました。

運用上のメリット

これまで大規模なバッチ処理を運用している現場では、誤って大量のジョブを投入した際や、優先度の低いジョブをまとめて停止させたい場合に、ループ処理で個別にAPIを叩く必要がありました。今回のアップデートで最大50件まで一括処理できるようになったため、APIコールの回数を削減し、運用上のオーバーヘッドとレイテンシを大幅に軽減できます。

リージョン状況

リサーチの結果、本機能はAWS Batchが提供されている東京リージョン（ap-northeast-1）および大阪リージョン（ap-northeast-3）の両方で利用可能です。国内の環境ですぐに導入いただけます。

実務的なアドバイス

• 状態によるAPIの使い分け: CancelJobs は待機状態のジョブ用、TerminateJobs は実行中のジョブを含む全状態用と明確に分かれています。実装時は、対象ジョブの状態を判定して適切なAPIを選択するロジックを組み込んでください。
• 配列ジョブへの対応: 単一ジョブだけでなく配列ジョブ（Array Jobs）にも対応しているため、大規模なデータ処理パイプラインの制御がより柔軟になります。

次のアクション

まずはAWS CLIやSDKを用いて、少数のテストジョブを作成し、CancelJobs と TerminateJobs の挙動の違いを検証することをお勧めします。また、ListJobs のレスポンスに新しく追加された isCancelled / isTerminated フィールドを監視ダッシュボードやログに組み込むことで、ジョブの停止理由をより正確に把握できるようになります。

参考ドキュメント

AWS Batch API Reference Guide (CancelJobs, TerminateJobs, TerminateServiceJobs ページ)