:doc:`IoTEvents <../../iotevents>` / Client / list_alarm_model_versions

*************************
list_alarm_model_versions
*************************



.. py:method:: IoTEvents.Client.list_alarm_model_versions(**kwargs)

  

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

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iotevents-2018-07-27/ListAlarmModelVersions>`_  


  **Request Syntax**
  ::

    response = client.list_alarm_model_versions(
        alarmModelName='string',
        nextToken='string',
        maxResults=123
    )
    
  :type alarmModelName: string
  :param alarmModelName: **[REQUIRED]** 

    The name of the alarm model.

    

  
  :type nextToken: string
  :param nextToken: 

    The token that you can use to return the next set of results.

    

  
  :type maxResults: integer
  :param maxResults: 

    The maximum number of results to be returned per request.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'alarmModelVersionSummaries': [
              {
                  'alarmModelName': 'string',
                  'alarmModelArn': 'string',
                  'alarmModelVersion': 'string',
                  'roleArn': 'string',
                  'creationTime': datetime(2015, 1, 1),
                  'lastUpdateTime': datetime(2015, 1, 1),
                  'status': 'ACTIVE'|'ACTIVATING'|'INACTIVE'|'FAILED',
                  'statusMessage': 'string'
              },
          ],
          'nextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **alarmModelVersionSummaries** *(list) --* 

        A list that summarizes each alarm model version.

        
        

        - *(dict) --* 

          Contains a summary of an alarm model version.

          
          

          - **alarmModelName** *(string) --* 

            The name of the alarm model.

            
          

          - **alarmModelArn** *(string) --* 

            The ARN of the alarm model. For more information, see `Amazon Resource Names (ARNs) <https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html>`__ in the *AWS General Reference*.

            
          

          - **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 `Amazon Resource Names (ARNs) <https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html>`__ in the *AWS General Reference*.

            
          

          - **creationTime** *(datetime) --* 

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

            
          

          - **lastUpdateTime** *(datetime) --* 

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

            
          

          - **status** *(string) --* 

            The status of the alarm model. The status can be one of the following values:

             

            
            * ``ACTIVE`` - The alarm model is active and it's ready to evaluate data.
             
            * ``ACTIVATING`` - AWS IoT Events is activating your alarm model. Activating an alarm model can take up to a few minutes.
             
            * ``INACTIVE`` - The alarm model is inactive, so it isn't ready to evaluate data. Check your alarm model information and update the alarm model.
             
            * ``FAILED`` - You couldn't create or update the alarm model. Check your alarm model information and try again.
            

            
          

          - **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 ``null`` if there are no more results.

        
  
  **Exceptions**
  
  *   :py:class:`IoTEvents.Client.exceptions.InvalidRequestException`

  
  *   :py:class:`IoTEvents.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`IoTEvents.Client.exceptions.ThrottlingException`

  
  *   :py:class:`IoTEvents.Client.exceptions.InternalFailureException`

  
  *   :py:class:`IoTEvents.Client.exceptions.ServiceUnavailableException`

  