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

# GET /ota-task-configurations/{Identifier}

`GET /ota-task-configurations/{Identifier}`

Get a configuraiton for the over-the-air (OTA) task.

## Path parameters

- `Identifier` string, required

## Response `200`

Success

- GetOtaTaskConfigurationResponse
  - `TaskConfigurationId` string — The over-the-air (OTA) task configuration id.
  - `Name` string, password — The name of the over-the-air (OTA) task configuration.
  - `PushConfig` object — Describes the type of configuration used for the over-the-air (OTA) task.
    - `AbortConfig` object — Structure representing one abort config.
      - `AbortConfigCriteriaList` AbortConfigCriteria[] — The list of criteria for the abort config.
        - `Action` 'CANCEL' — The action taken by the abort configuration.
        - `FailureType` 'FAILED' | 'REJECTED' | 'TIMED_OUT' | 'ALL' — Over-the-air (OTA) task abort criteria failure type.
        - `MinNumberOfExecutedThings` integer — The minimum number of things that must receive task execution notifications before the task can be aborted.
        - `ThresholdPercentage` number, double — The minimum percentage of over-the-air (OTA) task execution failures that must occur to initiate the last abort.
    - `RolloutConfig` object — Structure representing one rollout config.
      - `ExponentialRolloutRate` object — Structure representing exponential rate of rollout for an over-the-air (OTA) task.
        - `BaseRatePerMinute` integer — The base rate per minute for the rollout of an over-the-air (OTA) task.
        - `IncrementFactor` number, double — The incremental factor for increasing the rollout rate of an over-the-air (OTA) task.
        - `RateIncreaseCriteria` object — The criteria for increasing the rollout rate of an over-the-air (OTA) task.
          - `numberOfNotifiedThings` integer — The threshold for number of notified things that will initiate the increase in rate of rollout.
          - `numberOfSucceededThings` integer — The threshold for number of succeeded things that will initiate the increase in rate of rollout.
      - `MaximumPerMinute` integer — The maximum number of things that will be notified of a pending task, per minute.
    - `TimeoutConfig` object — Structure representing one timeout config.
      - `InProgressTimeoutInMinutes` integer — Specifies the amount of time the device has to finish execution of this task. The timeout interval can be anywhere between 1 minute and 7 days.
  - `Description` string — A description of the over-the-air (OTA) task configuration.
  - `CreatedAt` string, date-time — The timestamp value of when the over-the-air (OTA) task configuration was created at.

## 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)