---
title: "POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}/cancel"
method: POST
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}/cancel"
tags: ["VirtualMachineImageTemplate"]
---

# POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}/cancel

`POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}/cancel`

Cancel the long running image build based on the image template

## Path parameters

- `subscriptionId` string, required
- `resourceGroupName` string, required
- `imageTemplateName` string, required

## Query parameters

- `api-version` string, required

## Response `200`

The operation was successful.

## Other responses

- `202` — The request is accepted.
- `204` — The long running image build has been canceled.
- `default` — Error response describing why the operation failed.

## Changes

- **2026-07-13** (2018-02-01-preview) `fdab4083973e` — 3 warning
  - deleted the `path` request parameter `resourceGroupName`
  - deleted the `path` request parameter `subscriptionId`
  - deleted the `query` request parameter `api-version`
- **2026-07-13** (2018-02-01-preview) `ba75e124a7cd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/imagebuilder-microsoft-virtualmachineimages-imagebuilder/changes/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.VirtualMachineImages/imageTemplates/:imageTemplateName/cancel/post.md)

---

[API](https://skmtc.dev/azure/apis/imagebuilder-microsoft-virtualmachineimages-imagebuilder.md) · [All operations](https://skmtc.dev/azure/apis/imagebuilder-microsoft-virtualmachineimages-imagebuilder/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/imagebuilder-microsoft-virtualmachineimages-imagebuilder/revisions/33accb8fd530/schema)