Skip to main content
POST
実行中の build をキャンセルする

権限

組織レベルで ManageOrgSnapshots 権限を持つサービスユーザーまたはパーソナルアクセストークンが必要です。

動作

進行中のビルド (ステータスが pending または running) をキャンセルし、ステータスが cancelled になったビルドを返します。 キャンセルできるのは進行中のビルドのみです。ビルドがすでに終了状態 (succeeded、failed、または cancelled) の場合は、409 Conflict が返され、ビルドは変更されません。

承認

Authorization
string
header
必須

サービスユーザーの認証情報(接頭辞: cog_)

パスパラメータ

build_id
string
必須
org_id
string
必須

組織ID(プレフィックス: org-)

例:

"org-abc123def456"

レスポンス

成功レスポンス

公開 Build リソースの形式 — 「これはもう成功したか?」だけを示す不透明なビュー。

仕様上、プラットフォーム/スナップショット/ジョブ単位の詳細は公開されません。今後の追加(triggered_by_repo、ビルドメタデータなど)は追加的です。

build_id
string
必須
completed_at
integer | null
必須
created_at
integer
必須
pinned
boolean
必須
started_at
integer | null
必須
status
enum<string>
必須
利用可能なオプション:
pending,
running,
succeeded,
failed,
cancelled
trigger
enum<string> | null
必須
利用可能なオプション:
manual,
auto
triggered_by_user_id
string | null
必須
updated_at
integer
必須