---
title: "GET /alarm-models/{alarmModelName}/versions"
method: GET
path: "/alarm-models/{alarmModelName}/versions"
---

# GET /alarm-models/{alarmModelName}/versions

`GET /alarm-models/{alarmModelName}/versions`

Lists all the versions of an alarm model. The operation returns only the metadata associated with each alarm model version.

## Path parameters

- `alarmModelName` string, required

## Query parameters

- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListAlarmModelVersionsResponse
  - `alarmModelVersionSummaries` AlarmModelVersionSummary[] — A list that summarizes each alarm model version.
    - `alarmModelName` string — The name of the alarm model.
    - `alarmModelArn` string — The ARN of the alarm model. For more information, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Names (ARNs)</a> in the <i>AWS General Reference</i>.
    - `alarmModelVersion` string — The version of the alarm model.
    - `roleArn` string — The ARN of the IAM role that allows the alarm to perform actions and access AWS resources. For more information, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Names (ARNs)</a> in the <i>AWS General Reference</i>.
    - `creationTime` string, date-time — The time the alarm model was created, in the Unix epoch format.
    - `lastUpdateTime` string, date-time — The time the alarm model was last updated, in the Unix epoch format.
    - `status` 'ACTIVE' | 'ACTIVATING' | 'INACTIVE' | 'FAILED' — <p>The status of the alarm model. The status can be one of the following values:</p> <ul> <li> <p> <code>ACTIVE</code> - The alarm model is active and it's ready to evaluate data.</p> </li> <li> <p> <code>ACTIVATING</code> - AWS IoT Events is activating your alarm model. Activating an alarm model can take up to a few minutes.</p> </li> <li> <p> <code>INACTIVE</code> - The alarm model is inactive, so it isn't ready to evaluate data. Check your alarm model information and update the alarm model.</p> </li> <li> <p> <code>FAILED</code> - You couldn't create or update the alarm model. Check your alarm model information and try again.</p> </li> </ul>
    - `statusMessage` string — Contains information about the status of the alarm model version.
  - `nextToken` string — The token that you can use to return the next set of results, or <code>null</code> if there are no more results.

## Other responses

- `480` — InvalidRequestException
- `481` — ResourceNotFoundException
- `482` — ThrottlingException
- `483` — InternalFailureException
- `484` — ServiceUnavailableException

---

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