Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1426220141.8 KB

Updates an alarm model. Any alarms that were created based on the previous version are deleted and then created again as new data arrives.

post/alarm-models/{alarmModelName}

Path parameters

alarmModelNamestring required

The name of the alarm model.

Request body

alarmModelDescriptionstring

The description of the alarm model.

roleArnstring required

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>.

severityinteger

A non-negative integer that reflects the severity level of the alarm.

Response

Success

creationTimestring date-time

The time the alarm model was created, in the Unix epoch format.

alarmModelArnstring

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>.

alarmModelVersionstring

The version of the alarm model.

lastUpdateTimestring 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>