---
title: "GET /ota-tasks/{Identifier}"
method: GET
path: "/ota-tasks/{Identifier}"
---

# GET /ota-tasks/{Identifier}

`GET /ota-tasks/{Identifier}`

Get details of the over-the-air (OTA) task by its task id.

## Path parameters

- `Identifier` string, required

## Response `200`

Success

- GetOtaTaskResponse
  - `TaskId` string — The id of the over-the-air (OTA) task.
  - `TaskArn` string — The Amazon Resource Name (ARN) of the over-the-air (OTA) task
  - `Description` string — The description of the over-the-air (OTA) task.
  - `S3Url` string — The URL to the Amazon S3 bucket where the over-the-air (OTA) task is stored.
  - `Protocol` 'HTTP' — The connection protocol the over-the-air (OTA) task uses to update the device.
  - `OtaType` 'ONE_TIME' | 'CONTINUOUS' — The frequency type for the over-the-air (OTA) task.
  - `OtaTargetQueryString` string — The query string to add things to the thing group.
  - `OtaMechanism` 'PUSH' — The deployment mechanism for the over-the-air (OTA) task.
  - `Target` String[] — The device targeted for the over-the-air (OTA) task.
  - `CreatedAt` string, date-time — The timestamp value of when the over-the-air (OTA) task was created.
  - `LastUpdatedAt` string, date-time — The timestamp value of when the over-the-air (OTA) task was last updated at.
  - `TaskConfigurationId` string — The identifier for the over-the-air (OTA) task configuration.
  - `TaskProcessingDetails` object — The processing details of all over-the-air (OTA) tasks.
    - `NumberOfCanceledThings` integer — The number of canceled things in an over-the-air (OTA) task.
    - `NumberOfFailedThings` integer — The number of failed things in an over-the-air (OTA) task.
    - `NumberOfInProgressThings` integer — The number of in progress things in an over-the-air (OTA) task.
    - `numberOfQueuedThings` integer — The number of queued things in an over-the-air (OTA) task.
    - `numberOfRejectedThings` integer — The number of rejected things in an over-the-air (OTA) task.
    - `numberOfRemovedThings` integer — The number of removed things in an over-the-air (OTA) task.
    - `numberOfSucceededThings` integer — The number of succeeded things in an over-the-air (OTA) task.
    - `numberOfTimedOutThings` integer — The number of timed out things in an over-the-air (OTA) task.
    - `processingTargets` String[] — The targets of the over-the-air (OTA) task.
  - `OtaSchedulingConfig` OtaTaskSchedulingConfig — Over-the-air (OTA) task scheduling config.
    - `EndBehavior` 'STOP_ROLLOUT' | 'CANCEL' | 'FORCE_CANCEL' — Specifies the end behavior for all task executions after a task reaches the selected <code>endTime</code>. If <code>endTime</code> is not selected when creating the task, then <code>endBehavior</code> does not apply.
    - `EndTime` string — The time an over-the-air (OTA) task will stop.
    - `MaintenanceWindows` ScheduleMaintenanceWindow[] — Maintenance window list for over-the-air (OTA) task scheduling config.
      - `DurationInMinutes` integer — Displays the duration of the next maintenance window.
      - `StartTime` string — Displays the start time of the next maintenance window.
    - `StartTime` string — The time an over-the-air (OTA) task will start.
  - `OtaTaskExecutionRetryConfig` OtaTaskExecutionRetryConfig — Over-the-air (OTA) task retry config.
    - `RetryConfigCriteria` RetryConfigCriteria[] — The list of retry config criteria.
      - `FailureType` 'FAILED' | 'TIMED_OUT' | 'ALL' — Over-the-air (OTA) retry criteria failure type.
      - `MinNumberOfRetries` integer — The number of retries allowed for a failure type for the over-the-air (OTA) task.
  - `Status` 'IN_PROGRESS' | 'CANCELED' | 'COMPLETED' | 'DELETION_IN_PROGRESS' | 'SCHEDULED' — The status of the over-the-air (OTA) task.
  - `Tags` object — A set of key/value pairs that are used to manage the over-the-air (OTA) task.

## Other responses

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

---

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