:doc:`CloudWatchLogs <../../logs>` / Client / update_delivery_configuration

*****************************
update_delivery_configuration
*****************************



.. py:method:: CloudWatchLogs.Client.update_delivery_configuration(**kwargs)

  

  Use this operation to update the configuration of a `delivery <https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_Delivery.html>`__ to change either the S3 path pattern or the format of the delivered logs. You can't use this operation to change the source or destination of the delivery.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/UpdateDeliveryConfiguration>`_  


  **Request Syntax**
  ::

    response = client.update_delivery_configuration(
        id='string',
        recordFields=[
            'string',
        ],
        fieldDelimiter='string',
        s3DeliveryConfiguration={
            'suffixPath': 'string',
            'enableHiveCompatiblePath': True|False
        }
    )
    
  :type id: string
  :param id: **[REQUIRED]** 

    The ID of the delivery to be updated by this request.

    

  
  :type recordFields: list
  :param recordFields: 

    The list of record fields to be delivered to the destination, in order. If the delivery's log source has mandatory fields, they must be included in this list.

    

  
    - *(string) --* 

    

  :type fieldDelimiter: string
  :param fieldDelimiter: 

    The field delimiter to use between record fields when the final output format of a delivery is in ``Plain``, ``W3C``, or ``Raw`` format.

    

  
  :type s3DeliveryConfiguration: dict
  :param s3DeliveryConfiguration: 

    This structure contains parameters that are valid only when the delivery's delivery destination is an S3 bucket.

    

  
    - **suffixPath** *(string) --* 

      This string allows re-configuring the S3 object prefix to contain either static or variable sections. The valid variables to use in the suffix path will vary by each log source. To find the values supported for the suffix path for each log source, use the `DescribeConfigurationTemplates <https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeConfigurationTemplates.html>`__ operation and check the ``allowedSuffixPathFields`` field in the response.

      

    
    - **enableHiveCompatiblePath** *(boolean) --* 

      This parameter causes the S3 objects that contain delivered logs to use a prefix structure that allows for integration with Apache Hive.

      

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`CloudWatchLogs.Client.exceptions.ServiceUnavailableException`

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

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

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

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

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

  