:doc:`CloudFront <../../cloudfront>` / Client / list_invalidations_for_distribution_tenant

******************************************
list_invalidations_for_distribution_tenant
******************************************



.. py:method:: CloudFront.Client.list_invalidations_for_distribution_tenant(**kwargs)

  

  Lists the invalidations for a distribution tenant.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/ListInvalidationsForDistributionTenant>`_  


  **Request Syntax**
  ::

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

    The ID of the distribution tenant.

    

  
  :type Marker: string
  :param Marker: 

    Use this parameter when paginating results to indicate where to begin in your list of invalidation batches. Because the results are returned in decreasing order from most recent to oldest, the most recent results are on the first page, the second page will contain earlier results, and so on. To get the next page of results, set ``Marker`` to the value of the ``NextMarker`` from the current page's response. This value is the same as the ID of the last invalidation batch on that page.

    

  
  :type MaxItems: integer
  :param MaxItems: 

    The maximum number of invalidations to return for the distribution tenant.

    

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

    
    ::

      {
          'InvalidationList': {
              'Marker': 'string',
              'NextMarker': 'string',
              'MaxItems': 123,
              'IsTruncated': True|False,
              'Quantity': 123,
              'Items': [
                  {
                      'Id': 'string',
                      'CreateTime': datetime(2015, 1, 1),
                      'Status': 'string'
                  },
              ]
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **InvalidationList** *(dict) --* 

        The ``InvalidationList`` complex type describes the list of invalidation objects. For more information about invalidation, see `Invalidating Objects (Web Distributions Only) <https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html>`__ in the *Amazon CloudFront Developer Guide*.

        
        

        - **Marker** *(string) --* 

          The value that you provided for the ``Marker`` request parameter.

          
        

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

          If ``IsTruncated`` is ``true``, this element is present and contains the value that you can use for the ``Marker`` request parameter to continue listing your invalidation batches where they left off.

          
        

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

          The value that you provided for the ``MaxItems`` request parameter.

          
        

        - **IsTruncated** *(boolean) --* 

          A flag that indicates whether more invalidation batch requests remain to be listed. If your results were truncated, you can make a follow-up pagination request using the ``Marker`` request parameter to retrieve more invalidation batches in the list.

          
        

        - **Quantity** *(integer) --* 

          The number of invalidation batches that were created by the current Amazon Web Services account.

          
        

        - **Items** *(list) --* 

          A complex type that contains one ``InvalidationSummary`` element for each invalidation batch created by the current Amazon Web Services account.

          
          

          - *(dict) --* 

            A summary of an invalidation request.

            
            

            - **Id** *(string) --* 

              The unique ID for an invalidation request.

              
            

            - **CreateTime** *(datetime) --* 

              The time that an invalidation request was created.

              
            

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

              The status of an invalidation request.

              
        
      
    
  
  **Exceptions**
  
  *   :py:class:`CloudFront.Client.exceptions.AccessDenied`

  
  *   :py:class:`CloudFront.Client.exceptions.EntityNotFound`

  
  *   :py:class:`CloudFront.Client.exceptions.InvalidArgument`

  