:doc:`IoTSiteWise <../../iotsitewise>` / Client / list_interface_relationships

****************************
list_interface_relationships
****************************



.. py:method:: IoTSiteWise.Client.list_interface_relationships(**kwargs)

  

  Retrieves a paginated list of asset models that have a specific interface asset model applied to them.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iotsitewise-2019-12-02/ListInterfaceRelationships>`_  


  **Request Syntax**
  ::

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

    The ID of the interface asset model. This can be either the actual ID in UUID format, or else externalId: followed by the external ID.

    

  
  :type nextToken: string
  :param nextToken: 

    The token to be used for the next set of paginated results.

    

  
  :type maxResults: integer
  :param maxResults: 

    The maximum number of results to return for each paginated request. Default: 50

    

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

    
    ::

      {
          'interfaceRelationshipSummaries': [
              {
                  'id': 'string'
              },
          ],
          'nextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **interfaceRelationshipSummaries** *(list) --* 

        A list that summarizes each interface relationship.

        
        

        - *(dict) --* 

          Contains summary information about an interface relationship, which defines how an interface is applied to an asset model. This summary provides the essential identifiers needed to retrieve detailed information about the relationship.

          
          

          - **id** *(string) --* 

            The ID of the asset model that has the interface applied to it.

            
      
    
      

      - **nextToken** *(string) --* 

        The token for the next set of results, or null if there are no additional results.

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

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

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

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

  