:doc:`CloudWatchLogs <../../logs>` / Paginator / DescribeConfigurationTemplates

******************************
DescribeConfigurationTemplates
******************************



.. py:class:: CloudWatchLogs.Paginator.DescribeConfigurationTemplates

  ::

    
    paginator = client.get_paginator('describe_configuration_templates')

  
  

  .. py:method:: paginate(**kwargs)

    Creates an iterator that will paginate through responses from :py:meth:`CloudWatchLogs.Client.describe_configuration_templates`.

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


    **Request Syntax**
    ::

      response_iterator = paginator.paginate(
          service='string',
          logTypes=[
              'string',
          ],
          resourceTypes=[
              'string',
          ],
          deliveryDestinationTypes=[
              'S3'|'CWL'|'FH'|'XRAY',
          ],
          PaginationConfig={
              'MaxItems': 123,
              'PageSize': 123,
              'StartingToken': 'string'
          }
      )
      
    :type service: string
    :param service: 

      Use this parameter to filter the response to include only the configuration templates that apply to the Amazon Web Services service that you specify here.

      

    
    :type logTypes: list
    :param logTypes: 

      Use this parameter to filter the response to include only the configuration templates that apply to the log types that you specify here.

      

    
      - *(string) --* 

      
  
    :type resourceTypes: list
    :param resourceTypes: 

      Use this parameter to filter the response to include only the configuration templates that apply to the resource types that you specify here.

      

    
      - *(string) --* 

      
  
    :type deliveryDestinationTypes: list
    :param deliveryDestinationTypes: 

      Use this parameter to filter the response to include only the configuration templates that apply to the delivery destination types that you specify here.

      

    
      - *(string) --* 

      
  
    :type PaginationConfig: dict
    :param PaginationConfig: 

      A dictionary that provides parameters to control pagination.

      

    
      - **MaxItems** *(integer) --* 

        The total number of items to return. If the total number of items available is more than the value specified in max-items then a ``NextToken`` will be provided in the output that you can use to resume pagination.

        

      
      - **PageSize** *(integer) --* 

        The size of each page.

        

      
      - **StartingToken** *(string) --* 

        A token to specify where to start paginating. This is the ``NextToken`` from a previous response.

        

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

      
      ::

        {
            'configurationTemplates': [
                {
                    'service': 'string',
                    'logType': 'string',
                    'resourceType': 'string',
                    'deliveryDestinationType': 'S3'|'CWL'|'FH'|'XRAY',
                    'defaultDeliveryConfigValues': {
                        'recordFields': [
                            'string',
                        ],
                        'fieldDelimiter': 'string',
                        's3DeliveryConfiguration': {
                            'suffixPath': 'string',
                            'enableHiveCompatiblePath': True|False
                        }
                    },
                    'allowedFields': [
                        {
                            'name': 'string',
                            'mandatory': True|False
                        },
                    ],
                    'allowedOutputFormats': [
                        'json'|'plain'|'w3c'|'raw'|'parquet',
                    ],
                    'allowedActionForAllowVendedLogsDeliveryForResource': 'string',
                    'allowedFieldDelimiters': [
                        'string',
                    ],
                    'allowedSuffixPathFields': [
                        'string',
                    ]
                },
            ],
            'NextToken': 'string'
        }
        
      **Response Structure**

      

      - *(dict) --* 
        

        - **configurationTemplates** *(list) --* 

          An array of objects, where each object describes one configuration template that matches the filters that you specified in the request.

          
          

          - *(dict) --* 

            A structure containing information about the deafult settings and available settings that you can use to configure a `delivery <https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_Delivery.html>`__ or a `delivery destination <https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeliveryDestination.html>`__.

            
            

            - **service** *(string) --* 

              A string specifying which service this configuration template applies to. For more information about supported services see `Enable logging from Amazon Web Services services. <https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html>`__.

              
            

            - **logType** *(string) --* 

              A string specifying which log type this configuration template applies to.

              
            

            - **resourceType** *(string) --* 

              A string specifying which resource type this configuration template applies to.

              
            

            - **deliveryDestinationType** *(string) --* 

              A string specifying which destination type this configuration template applies to.

              
            

            - **defaultDeliveryConfigValues** *(dict) --* 

              A mapping that displays the default value of each property within a delivery's configuration, if it is not specified in the request.

              
              

              - **recordFields** *(list) --* 

                The default record fields that will be delivered when a list of record fields is not provided in a `CreateDelivery <https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html>`__ operation.

                
                

                - *(string) --* 
            
              

              - **fieldDelimiter** *(string) --* 

                The default field delimiter that is used in a `CreateDelivery <https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html>`__ operation when the field delimiter is not specified in that operation. The field delimiter is used only when the final output delivery is in ``Plain``, ``W3C``, or ``Raw`` format.

                
              

              - **s3DeliveryConfiguration** *(dict) --* 

                The delivery parameters that are used when you create a delivery to a delivery destination that 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.

                  
            
          
            

            - **allowedFields** *(list) --* 

              The allowed fields that a caller can use in the ``recordFields`` parameter of a `CreateDelivery <https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html>`__ or `UpdateDeliveryConfiguration <https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_UpdateDeliveryConfiguration.html>`__ operation.

              
              

              - *(dict) --* 

                A structure that represents a valid record field header and whether it is mandatory.

                
                

                - **name** *(string) --* 

                  The name to use when specifying this record field in a `CreateDelivery <https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html>`__ or `UpdateDeliveryConfiguration <https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_UpdateDeliveryConfiguration.html>`__ operation.

                  
                

                - **mandatory** *(boolean) --* 

                  If this is ``true``, the record field must be present in the ``recordFields`` parameter provided to a `CreateDelivery <https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html>`__ or `UpdateDeliveryConfiguration <https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_UpdateDeliveryConfiguration.html>`__ operation.

                  
            
          
            

            - **allowedOutputFormats** *(list) --* 

              The list of delivery destination output formats that are supported by this log source.

              
              

              - *(string) --* 
          
            

            - **allowedActionForAllowVendedLogsDeliveryForResource** *(string) --* 

              The action permissions that a caller needs to have to be able to successfully create a delivery source on the desired resource type when calling `PutDeliverySource <https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html>`__.

              
            

            - **allowedFieldDelimiters** *(list) --* 

              The valid values that a caller can use as field delimiters when calling `CreateDelivery <https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html>`__ or `UpdateDeliveryConfiguration <https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_UpdateDeliveryConfiguration.html>`__ on a delivery that delivers in ``Plain``, ``W3C``, or ``Raw`` format.

              
              

              - *(string) --* 
          
            

            - **allowedSuffixPathFields** *(list) --* 

              The list of variable fields that can be used in the suffix path of a delivery that delivers to an S3 bucket.

              
              

              - *(string) --* 
          
        
      
        

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

          A token to resume pagination.

          
    