Skip to content

list_distribution_tenants_by_customization

list_distribution_tenants_by_customization(
    *,
    config_overrides: Optional[CloudFrontClientConfig] = None,
    web_acl_arn: Optional[string] = None,
    certificate_arn: Optional[string] = None,
    marker: Optional[string] = None,
    max_items: Optional[integer] = None,
) -> ListDistributionTenantsByCustomizationResult

Lists distribution tenants by the customization that you specify.

You must specify either the CertificateArn parameter or WebACLArn parameter, but not both in the same request.

Parameters:

  • web_acl_arn (Optional[string], default: None ) –

    Filter by the ARN of the associated WAF web ACL.

  • certificate_arn (Optional[string], default: None ) –

    Filter by the ARN of the associated ACM certificate.

  • marker (Optional[string], default: None ) –

    The marker for the next set of results.

  • max_items (Optional[integer], default: None ) –

    The maximum number of distribution tenants to return by the specified customization.

Raises:

Source code in docs_src/capo_cloudfront/_services/cloud_front.py
def list_distribution_tenants_by_customization(
    self,
    *,
    config_overrides: Optional[CloudFrontClientConfig] = None,
    web_acl_arn: Optional["capo_cloudfront.types.string.string"] = None,
    certificate_arn: Optional["capo_cloudfront.types.string.string"] = None,
    marker: Optional["capo_cloudfront.types.string.string"] = None,
    max_items: Optional["capo_cloudfront.types.integer.integer"] = None,
) -> "capo_cloudfront.types.list_distribution_tenants_by_customization_result.ListDistributionTenantsByCustomizationResult":
    """<p>Lists distribution tenants by the customization that you specify.</p> <p>You must specify either the <code>CertificateArn</code> parameter or <code>WebACLArn</code> parameter, but not both in the same request.</p>

    Args:
        web_acl_arn: <p>Filter by the ARN of the associated WAF web ACL.</p>
        certificate_arn: <p>Filter by the ARN of the associated ACM certificate.</p>
        marker: <p>The marker for the next set of results.</p>
        max_items: <p>The maximum number of distribution tenants to return by the specified customization.</p>

    Raises:
        capo_cloudfront.errors.access_denied.AccessDenied: <p>Access denied.</p>
        capo_cloudfront.errors.entity_not_found.EntityNotFound: <p>The entity was not found.</p>
        capo_cloudfront.errors.invalid_argument.InvalidArgument: <p>An argument is invalid.</p>
        capo_cloudfront.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_cloudfront.types.list_distribution_tenants_by_customization_request.ListDistributionTenantsByCustomizationRequest]",
    ) -> OperationResponse[
        "capo_cloudfront.types.list_distribution_tenants_by_customization_result.ListDistributionTenantsByCustomizationResult"
    ]:
        import capo_cloudfront._operations.cloudfront2020_05_31.list_distribution_tenants_by_customization

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

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("ListDistributionTenantsByCustomization")
    )
    input_: capo_cloudfront.types.list_distribution_tenants_by_customization_request.ListDistributionTenantsByCustomizationRequest = {}
    if web_acl_arn is not None:
        input_["web_acl_arn"] = web_acl_arn
    if certificate_arn is not None:
        input_["certificate_arn"] = certificate_arn
    if marker is not None:
        input_["marker"] = marker
    if max_items is not None:
        input_["max_items"] = max_items

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