:doc:`LocationService <../../location>` / Client / associate_tracker_consumer

**************************
associate_tracker_consumer
**************************



.. py:method:: LocationService.Client.associate_tracker_consumer(**kwargs)

  

  Creates an association between a geofence collection and a tracker resource. This allows the tracker resource to communicate location data to the linked geofence collection.

   

  You can associate up to five geofence collections to each tracker resource.

   

  .. note::

    

    Currently not supported — Cross-account configurations, such as creating associations between a tracker resource in one account and a geofence collection in another account.

    

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/AssociateTrackerConsumer>`_  


  **Request Syntax**
  ::

    response = client.associate_tracker_consumer(
        TrackerName='string',
        ConsumerArn='string'
    )
    
  :type TrackerName: string
  :param TrackerName: **[REQUIRED]** 

    The name of the tracker resource to be associated with a geofence collection.

    

  
  :type ConsumerArn: string
  :param ConsumerArn: **[REQUIRED]** 

    The Amazon Resource Name (ARN) for the geofence collection to be associated to tracker resource. Used when you need to specify a resource across all Amazon Web Services.

     

    
    * Format example: ``arn:aws:geo:region:account-id:geofence-collection/ExampleGeofenceCollectionConsumer``
    

    

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`LocationService.Client.exceptions.InternalServerException`

  
  *   :py:class:`LocationService.Client.exceptions.ConflictException`

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

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

  
  *   :py:class:`LocationService.Client.exceptions.ValidationException`

  
  *   :py:class:`LocationService.Client.exceptions.ServiceQuotaExceededException`

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

  