:doc:`XRay <../../xray>` / Client / update_trace_segment_destination

********************************
update_trace_segment_destination
********************************



.. py:method:: XRay.Client.update_trace_segment_destination(**kwargs)

  

  Modifies the destination of data sent to ``PutTraceSegments``. The Transaction Search feature requires the CloudWatchLogs destination. For more information, see `Transaction Search <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html>`__.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/UpdateTraceSegmentDestination>`_  


  **Request Syntax**
  ::

    response = client.update_trace_segment_destination(
        Destination='XRay'|'CloudWatchLogs'
    )
    
  :type Destination: string
  :param Destination: 

    The configured destination of trace segments.

    

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

    
    ::

      {
          'Destination': 'XRay'|'CloudWatchLogs',
          'Status': 'PENDING'|'ACTIVE'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Destination** *(string) --* 

        The destination of the trace segments.

        
      

      - **Status** *(string) --* 

        The status of the update.

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

  
  *   :py:class:`XRay.Client.exceptions.ThrottledException`

  