Skip to content

Returns per-domain validation summaries for an ACM certificate

Description

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.

Usage

acm_list_certificate_domain_validations(CertificateArn, NextToken,
  MaxItems)

Arguments

  • CertificateArn

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

  • NextToken

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

  • MaxItems

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

Value

A list with the following syntax:

list(
  DomainValidationSummaryList = list(
    list(
      DomainName = "string",
      ActiveValidationConfiguration = list(
        ValidationMethod = "EMAIL"|"DNS"|"HTTP",
        ValidationChallenge = list(
          EmailValidationChallenge = list(
            ValidationEmails = list(
              "string"
            ),
            ValidationDomain = "string"
          ),
          DnsValidationChallenge = list(
            ResourceRecord = list(
              Name = "string",
              Type = "CNAME",
              Value = "string"
            )
          )
        ),
        ValidationStatus = "PENDING_VALIDATION"|"SUCCESS"|"FAILED"
      ),
      RequestedValidationConfiguration = list(
        ValidationMethod = "EMAIL"|"DNS"|"HTTP",
        ValidationChallenge = list(
          EmailValidationChallenge = list(
            ValidationEmails = list(
              "string"
            ),
            ValidationDomain = "string"
          ),
          DnsValidationChallenge = list(
            ResourceRecord = list(
              Name = "string",
              Type = "CNAME",
              Value = "string"
            )
          )
        ),
        ValidationStatus = "PENDING_VALIDATION"|"SUCCESS"|"FAILED"
      )
    )
  ),
  NextToken = "string"
)

Request syntax

svc$list_certificate_domain_validations(
  CertificateArn = "string",
  NextToken = "string",
  MaxItems = 123
)