Skip to content

list_certificate_domain_validations async

list_certificate_domain_validations(
    certificate_arn: CertificateArn,
    *,
    config_overrides: Optional[AsyncACMClientConfig] = None,
    next_token: Optional[NextToken] = None,
    max_items: Optional[MaxItems] = None,
) -> ListCertificateDomainValidationsResponse

Returns per-domain validation summaries for an ACM certificate. Each summary includes the domain name, the active validation configuration, and the requested validation configuration when a validation method migration is in progress. You can use the results to monitor the progress of an email-to-DNS validation migration and to retrieve the CNAME records required for DNS validation.

Parameters:

  • certificate_arn (CertificateArn) –

    The Amazon Resource Name (ARN) of the certificate for which to list domain validation summaries.

  • next_token (Optional[NextToken], default: None ) –

    A token returned by a previous call to ListCertificateDomainValidations. If the number of results exceeds MaxItems, use this token to retrieve the next page of results.

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

    The maximum number of domain validation summaries to return. If you don't specify a value, the default is 1000.

Raises:

Source code in docs_src/capo_acm/_services/async_acm.py
async def list_certificate_domain_validations(
    self,
    certificate_arn: "capo_acm.types.certificate_arn.CertificateArn",
    *,
    config_overrides: Optional[AsyncACMClientConfig] = None,
    next_token: Optional["capo_acm.types.next_token.NextToken"] = None,
    max_items: Optional["capo_acm.types.max_items.MaxItems"] = None,
) -> "capo_acm.types.list_certificate_domain_validations_response.ListCertificateDomainValidationsResponse":
    """<p>Returns per-domain validation summaries for an ACM certificate. Each summary includes the domain name, the active validation configuration, and the requested validation configuration when a validation method migration is in progress. You can use the results to monitor the progress of an email-to-DNS validation migration and to retrieve the CNAME records required for DNS validation.</p>

    Args:
        certificate_arn: <p>The Amazon Resource Name (ARN) of the certificate for which to list domain validation summaries.</p>
        next_token: <p>A token returned by a previous call to <code>ListCertificateDomainValidations</code>. If the number of results exceeds <code>MaxItems</code>, use this token to retrieve the next page of results.</p>
        max_items: <p>The maximum number of domain validation summaries to return. If you don't specify a value, the default is 1000.</p>

    Raises:
        capo_acm.errors.access_denied_exception.AccessDeniedException: <p>You do not have access required to perform this action.</p>
        capo_acm.errors.invalid_args_exception.InvalidArgsException: <p>One or more of request parameters specified is not valid.</p>
        capo_acm.errors.resource_not_found_exception.ResourceNotFoundException: <p>The specified certificate cannot be found in the caller's account or the caller's account cannot be found.</p>
        capo_acm.errors.throttling_exception.ThrottlingException: <p>The request was denied because it exceeded a quota.</p>
        capo_acm.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_acm.types.list_certificate_domain_validations_request.ListCertificateDomainValidationsRequest]",
    ) -> AsyncOperationResponse[
        "capo_acm.types.list_certificate_domain_validations_response.ListCertificateDomainValidationsResponse"
    ]:
        import capo_acm._operations.certificate_manager.list_certificate_domain_validations

        (
            output,
            http_response,
        ) = await capo_acm._operations.certificate_manager.list_certificate_domain_validations.async_list_certificate_domain_validations(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("ListCertificateDomainValidations")
    )
    input_: capo_acm.types.list_certificate_domain_validations_request.ListCertificateDomainValidationsRequest = {
        "certificate_arn": certificate_arn
    }
    if next_token is not None:
        input_["next_token"] = next_token
    if max_items is not None:
        input_["max_items"] = max_items

    response = await aexecute_pipeline(
        AsyncOperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    await response.response.aclose()
    return response.output