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
|