CloudFront / Client / list_invalidations_for_distribution_tenant

list_invalidations_for_distribution_tenant

CloudFront.Client.list_invalidations_for_distribution_tenant(**kwargs)

Lists the invalidations for a distribution tenant.

See also: AWS API Documentation

Request Syntax

response = client.list_invalidations_for_distribution_tenant(
    Id='string',
    Marker='string',
    MaxItems=123
)
Parameters:

  • Id (string) –

    [REQUIRED]

    The ID of the distribution tenant.

  • Marker (string) – 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.

  • MaxItems (integer) – The maximum number of invalidations to return for the distribution tenant.

Return type:

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) 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

  • CloudFront.Client.exceptions.AccessDenied

  • CloudFront.Client.exceptions.EntityNotFound

  • CloudFront.Client.exceptions.InvalidArgument