正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

Sidekiqキューの管理API

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab Self-Managed、GitLab Dedicated

Sidekiqキューからジョブを削除

指定されたメタデータに一致するジョブをSidekiqキューから削除します。

レスポンスには3つのフィールドがあります:

  1. deleted_jobs - リクエストによって削除されたジョブの数。
  2. queue_size - リクエストの処理後に残ったキューのサイズ。
  3. completed - リクエストがキュー全体を時間内に処理できたかどうか。時間内に処理できなかった場合、同じパラメータで再試行すると、さらにジョブが削除される可能性があります(最初のリクエストが発行された後に加えられたジョブを含む)。

このAPIエンドポイントは管理者のみが利用できます。

DELETE /admin/sidekiq/queues/:queue_name
属性必須説明
queue_name文字列はいジョブを削除するキューの名前
user文字列いいえジョブをスケジュールしたユーザー名
project文字列いいえジョブがスケジュールされたプロジェクトのフルパス
root_namespace文字列いいえプロジェクトのルートネームスペース
subscription_plan文字列いいえルートネームスペースのサブスクリプションプラン (GitLab.comのみ)
caller_id文字列いいえジョブをスケジュールしたエンドポイントまたはバックグラウンドジョブ(例: ProjectsController#create/api/:version/projects/:idPostReceive
feature_category文字列いいえバックグラウンドジョブの機能カテゴリ(例: team_planningまたはcode_review
worker_class文字列いいえバックグラウンドジョブワーカーのクラス(例: PostReceiveまたはMergeWorker

queue_name以外の属性が少なくとも1つ必要です。

リクエスト例:

curl --request DELETE \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/admin/sidekiq/queues/:queue_name"

レスポンス例:

{
  "completed": true,
  "deleted_jobs": 7,
  "queue_size": 14
}