---
title: "PUT /metadata-transfer-jobs/{metadataTransferJobId}/cancel"
method: PUT
path: "/metadata-transfer-jobs/{metadataTransferJobId}/cancel"
---

# PUT /metadata-transfer-jobs/{metadataTransferJobId}/cancel

`PUT /metadata-transfer-jobs/{metadataTransferJobId}/cancel`

Cancels the metadata transfer job.

## Path parameters

- `metadataTransferJobId` string, required

## Response `200`

Success

- CancelMetadataTransferJobResponse
  - `metadataTransferJobId` string, required — The metadata transfer job Id.
  - `arn` string, required — The metadata transfer job ARN.
  - `updateDateTime` string, date-time, required — Used to update the DateTime property.
  - `status` object, required — The metadata transfer job's status.
    - `state` 'VALIDATING' | 'PENDING' | 'RUNNING' | 'CANCELLING' | 'ERROR' | 'COMPLETED' | 'CANCELLED' — The metadata transfer job state.
    - `error` object — The metadata transfer job error.
      - `code` 'VALIDATION_ERROR' | 'INTERNAL_FAILURE' | 'SYNC_INITIALIZING_ERROR' | 'SYNC_CREATING_ERROR' | 'SYNC_PROCESSING_ERROR' | 'SYNC_DELETING_ERROR' | 'PROCESSING_ERROR' | 'COMPOSITE_COMPONENT_FAILURE' — The error code.
      - `message` string — The error message.
    - `queuedPosition` integer — The queued position.
  - `progress` object — The metadata transfer job's progress.
    - `totalCount` integer — The total count. [of what]
    - `succeededCount` integer — The succeeded count.
    - `skippedCount` integer — The skipped count.
    - `failedCount` integer — The failed count.

## Other responses

- `480` — InternalServerException
- `481` — AccessDeniedException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException
- `484` — ValidationException
- `485` — ConflictException

---

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