:doc:`Lambda <../../lambda>` / Client / list_function_event_invoke_configs

**********************************
list_function_event_invoke_configs
**********************************



.. py:method:: Lambda.Client.list_function_event_invoke_configs(**kwargs)

  

  Retrieves a list of configurations for asynchronous invocation for a function.

   

  To configure options for asynchronous invocation, use  PutFunctionEventInvokeConfig.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/ListFunctionEventInvokeConfigs>`_  


  **Request Syntax**
  ::

    response = client.list_function_event_invoke_configs(
        FunctionName='string',
        Marker='string',
        MaxItems=123
    )
    
  :type FunctionName: string
  :param FunctionName: **[REQUIRED]** 

    The name or ARN of the Lambda function.

     

    **Name formats**

     

    
    * **Function name** - ``my-function``.
     
    * **Function ARN** - ``arn:aws:lambda:us-west-2:123456789012:function:my-function``.
     
    * **Partial ARN** - ``123456789012:function:my-function``.
    

     

    The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

    

  
  :type Marker: string
  :param Marker: 

    Specify the pagination token that's returned by a previous request to retrieve the next page of results.

    

  
  :type MaxItems: integer
  :param MaxItems: 

    The maximum number of configurations to return.

    

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

    
    ::

      {
          'FunctionEventInvokeConfigs': [
              {
                  'LastModified': datetime(2015, 1, 1),
                  'FunctionArn': 'string',
                  'MaximumRetryAttempts': 123,
                  'MaximumEventAgeInSeconds': 123,
                  'DestinationConfig': {
                      'OnSuccess': {
                          'Destination': 'string'
                      },
                      'OnFailure': {
                          'Destination': 'string'
                      }
                  }
              },
          ],
          'NextMarker': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **FunctionEventInvokeConfigs** *(list) --* 

        A list of configurations.

        
        

        - *(dict) --* 
          

          - **LastModified** *(datetime) --* 

            The date and time that the configuration was last updated.

            
          

          - **FunctionArn** *(string) --* 

            The Amazon Resource Name (ARN) of the function.

            
          

          - **MaximumRetryAttempts** *(integer) --* 

            The maximum number of times to retry when the function returns an error.

            
          

          - **MaximumEventAgeInSeconds** *(integer) --* 

            The maximum age of a request that Lambda sends to a function for processing.

            
          

          - **DestinationConfig** *(dict) --* 

            A destination for events after they have been sent to a function for processing.

             

            **Destinations**

             

            
            * **Function** - The Amazon Resource Name (ARN) of a Lambda function.
             
            * **Queue** - The ARN of a standard SQS queue.
             
            * **Bucket** - The ARN of an Amazon S3 bucket.
             
            * **Topic** - The ARN of a standard SNS topic.
             
            * **Event Bus** - The ARN of an Amazon EventBridge event bus.
            

             

            .. note::

              

              S3 buckets are supported only for on-failure destinations. To retain records of successful invocations, use another destination type.

              

            
            

            - **OnSuccess** *(dict) --* 

              The destination configuration for successful invocations. Not supported in ``CreateEventSourceMapping`` or ``UpdateEventSourceMapping``.

              
              

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

                The Amazon Resource Name (ARN) of the destination resource.

                 

                .. note::

                  

                  Amazon SNS destinations have a message size limit of 256 KB. If the combined size of the function request and response payload exceeds the limit, Lambda will drop the payload when sending ``OnFailure`` event to the destination. For details on this behavior, refer to `Retaining records of asynchronous invocations <https://docs.aws.amazon.com/lambda/latest/dg/invocation-async-retain-records.html>`__.

                  

                
          
            

            - **OnFailure** *(dict) --* 

              The destination configuration for failed invocations.

              
              

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

                The Amazon Resource Name (ARN) of the destination resource.

                 

                To retain records of failed invocations from `Kinesis <https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html>`__, `DynamoDB <https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html>`__, `self-managed Apache Kafka <https://docs.aws.amazon.com/lambda/latest/dg/kafka-on-failure.html>`__, or `Amazon MSK <https://docs.aws.amazon.com/lambda/latest/dg/kafka-on-failure.html>`__, you can configure an Amazon SNS topic, Amazon SQS queue, Amazon S3 bucket, or Kafka topic as the destination.

                 

                .. note::

                  

                  Amazon SNS destinations have a message size limit of 256 KB. If the combined size of the function request and response payload exceeds the limit, Lambda will drop the payload when sending ``OnFailure`` event to the destination. For details on this behavior, refer to `Retaining records of asynchronous invocations <https://docs.aws.amazon.com/lambda/latest/dg/invocation-async-retain-records.html>`__.

                  

                 

                To retain records of failed invocations from `Kinesis <https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html>`__, `DynamoDB <https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html>`__, `self-managed Kafka <https://docs.aws.amazon.com/lambda/latest/dg/with-kafka.html#services-smaa-onfailure-destination>`__ or `Amazon MSK <https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-onfailure-destination>`__, you can configure an Amazon SNS topic, Amazon SQS queue, or Amazon S3 bucket as the destination.

                
          
        
      
    
      

      - **NextMarker** *(string) --* 

        The pagination token that's included if more results are available.

        
  
  **Exceptions**
  
  *   :py:class:`Lambda.Client.exceptions.InvalidParameterValueException`

  
  *   :py:class:`Lambda.Client.exceptions.ServiceException`

  
  *   :py:class:`Lambda.Client.exceptions.TooManyRequestsException`

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

  

  **Examples**

  The following example returns a list of asynchronous invocation configurations for a function named my-function.
  ::

    response = client.list_function_event_invoke_configs(
        FunctionName='my-function',
    )
    
    print(response)

  
  Expected Output:
  ::

    {
        'FunctionEventInvokeConfigs': [
            {
                'FunctionArn': 'arn:aws:lambda:us-east-2:123456789012:function:my-function:GREEN',
                'LastModified': 1577824406.719,
                'MaximumEventAgeInSeconds': 1800,
                'MaximumRetryAttempts': 2,
            },
            {
                'FunctionArn': 'arn:aws:lambda:us-east-2:123456789012:function:my-function:BLUE',
                'LastModified': 1577824396.653,
                'MaximumEventAgeInSeconds': 3600,
                'MaximumRetryAttempts': 0,
            },
        ],
        'ResponseMetadata': {
            '...': '...',
        },
    }

  