Skip to content

create_invalidation 

create_invalidation(
    distribution_id: string,
    invalidation_batch: InvalidationBatch,
    *,
    config_overrides: Optional[CloudFrontClientConfig] = None,
) -> CreateInvalidationResult

Create a new invalidation. For more information, see Invalidating files in the Amazon CloudFront Developer Guide.

Parameters:

  • distribution_id (string) –

    The distribution's id.

  • invalidation_batch (InvalidationBatch) –

    The batch information for the invalidation.

Raises:

Source code in docs_src/capo_cloudfront/_services/cloud_front.py 
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
def create_invalidation(
    self,
    distribution_id: "capo_cloudfront.types.string.string",
    invalidation_batch: "capo_cloudfront.types.invalidation_batch.InvalidationBatch",
    *,
    config_overrides: Optional[CloudFrontClientConfig] = None,
) -> "capo_cloudfront.types.create_invalidation_result.CreateInvalidationResult":
    """<p>Create a new invalidation. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html">Invalidating files</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>

    Args:
        distribution_id: <p>The distribution's id.</p>
        invalidation_batch: <p>The batch information for the invalidation.</p>

    Raises:
        capo_cloudfront.errors.access_denied.AccessDenied: <p>Access denied.</p>
        capo_cloudfront.errors.batch_too_large.BatchTooLarge: <p>Invalidation batch specified is too large.</p>
        capo_cloudfront.errors.inconsistent_quantities.InconsistentQuantities: <p>The value of <code>Quantity</code> and the size of <code>Items</code> don't match.</p>
        capo_cloudfront.errors.invalid_argument.InvalidArgument: <p>An argument is invalid.</p>
        capo_cloudfront.errors.missing_body.MissingBody: <p>This operation requires a body. Ensure that the body is present and the <code>Content-Type</code> header is set.</p>
        capo_cloudfront.errors.no_such_distribution.NoSuchDistribution: <p>The specified distribution does not exist.</p>
        capo_cloudfront.errors.too_many_invalidations_in_progress.TooManyInvalidationsInProgress: <p>You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects.</p>
        capo_cloudfront.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_cloudfront.types.create_invalidation_request.CreateInvalidationRequest]",
    ) -> OperationResponse[
        "capo_cloudfront.types.create_invalidation_result.CreateInvalidationResult"
    ]:
        import capo_cloudfront._operations.cloudfront2020_05_31.create_invalidation

        output, http_response = (
            capo_cloudfront._operations.cloudfront2020_05_31.create_invalidation.create_invalidation(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("CreateInvalidation")
    )
    input_: capo_cloudfront.types.create_invalidation_request.CreateInvalidationRequest = {
        "distribution_id": distribution_id,
        "invalidation_batch": invalidation_batch,
    }

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output