---
title: "PUT /CancelImageCreation"
method: PUT
path: "/CancelImageCreation"
---

# PUT /CancelImageCreation

`PUT /CancelImageCreation`

CancelImageCreation cancels the creation of Image. This operation can only be used on images in a non-terminal state.

## Request body

- object
  - `imageBuildVersionArn` string, required — The Amazon Resource Name (ARN) of the image that you want to cancel creation for.
  - `clientToken` string, required — Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a> in the <i>Amazon EC2 API Reference</i>.

## Response `200`

Success

- CancelImageCreationResponse
  - `requestId` string — The request ID that uniquely identifies this request.
  - `clientToken` string — The idempotency token that was used for this request.
  - `imageBuildVersionArn` string — The ARN of the image whose creation this request canceled.

## Other responses

- `480` — ServiceException
- `481` — ClientException
- `482` — ServiceUnavailableException
- `483` — InvalidRequestException
- `484` — IdempotentParameterMismatchException
- `485` — ForbiddenException
- `486` — CallRateLimitExceededException
- `487` — ResourceInUseException

---

[API](https://skmtc.net/aws/apis/imagebuilder.md) · [All operations](https://skmtc.net/aws/apis/imagebuilder/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/imagebuilder/versions/cfe68d8f8262/schema)