:doc:`ManagedintegrationsforIoTDeviceManagement <../../iot-managed-integrations>` / Client / list_account_associations

*************************
list_account_associations
*************************



.. py:method:: ManagedintegrationsforIoTDeviceManagement.Client.list_account_associations(**kwargs)

  

  Lists all account associations, with optional filtering by connector destination ID.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iot-managed-integrations-2025-03-03/ListAccountAssociations>`_  


  **Request Syntax**
  ::

    response = client.list_account_associations(
        ConnectorDestinationId='string',
        MaxResults=123,
        NextToken='string'
    )
    
  :type ConnectorDestinationId: string
  :param ConnectorDestinationId: 

    The identifier of the connector destination to filter account associations by.

    

  
  :type MaxResults: integer
  :param MaxResults: 

    The maximum number of account associations to return in a single response.

    

  
  :type NextToken: string
  :param NextToken: 

    A token used for pagination of results.

    

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

    
    ::

      {
          'Items': [
              {
                  'AccountAssociationId': 'string',
                  'AssociationState': 'ASSOCIATION_IN_PROGRESS'|'ASSOCIATION_FAILED'|'ASSOCIATION_SUCCEEDED'|'ASSOCIATION_DELETING'|'REFRESH_TOKEN_EXPIRED',
                  'ErrorMessage': 'string',
                  'ConnectorDestinationId': 'string',
                  'Name': 'string',
                  'Description': 'string',
                  'Arn': 'string'
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Items** *(list) --* 

        The list of account associations that match the specified criteria.

        
        

        - *(dict) --* 

          Structure containing information about an account association, including its identifier, state, and related metadata.

          
          

          - **AccountAssociationId** *(string) --* 

            The unique identifier of the account association.

            
          

          - **AssociationState** *(string) --* 

            The current state of the account association, indicating its status in the association lifecycle.

            
          

          - **ErrorMessage** *(string) --* 

            The error message explaining any issues with the account association, if applicable.

            
          

          - **ConnectorDestinationId** *(string) --* 

            The identifier of the connector destination associated with this account association.

            
          

          - **Name** *(string) --* 

            The name of the account association.

            
          

          - **Description** *(string) --* 

            A description of the account association.

            
          

          - **Arn** *(string) --* 

            The Amazon Resource Name (ARN) of the account association.

            
      
    
      

      - **NextToken** *(string) --* 

        A token used for pagination of results when there are more account associations than can be returned in a single response.

        
  
  **Exceptions**
  
  *   :py:class:`ManagedintegrationsforIoTDeviceManagement.Client.exceptions.ValidationException`

  
  *   :py:class:`ManagedintegrationsforIoTDeviceManagement.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`ManagedintegrationsforIoTDeviceManagement.Client.exceptions.InternalServerException`

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

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

  