ACM / Paginator / ListCertificateDomainValidations

ListCertificateDomainValidations

class ACM.Paginator.ListCertificateDomainValidations

paginator = client.get_paginator('list_certificate_domain_validations')

paginate(**kwargs)

Creates an iterator that will paginate through responses from ACM.Client.list_certificate_domain_validations().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    CertificateArn='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

• CertificateArn (string) –

  [REQUIRED]

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

• PaginationConfig (dict) –

  A dictionary that provides parameters to control pagination.

  • MaxItems (integer) –

    The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

  • PageSize (integer) –

    The size of each page.

  • StartingToken (string) –

    A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'DomainValidationSummaryList': [
        {
            'DomainName': 'string',
            'ActiveValidationConfiguration': {
                'ValidationMethod': 'EMAIL'|'DNS'|'HTTP',
                'ValidationChallenge': {
                    'EmailValidationChallenge': {
                        'ValidationEmails': [
                            'string',
                        ],
                        'ValidationDomain': 'string'
                    },
                    'DnsValidationChallenge': {
                        'ResourceRecord': {
                            'Name': 'string',
                            'Type': 'CNAME',
                            'Value': 'string'
                        }
                    }
                },
                'ValidationStatus': 'PENDING_VALIDATION'|'SUCCESS'|'FAILED'
            },
            'RequestedValidationConfiguration': {
                'ValidationMethod': 'EMAIL'|'DNS'|'HTTP',
                'ValidationChallenge': {
                    'EmailValidationChallenge': {
                        'ValidationEmails': [
                            'string',
                        ],
                        'ValidationDomain': 'string'
                    },
                    'DnsValidationChallenge': {
                        'ResourceRecord': {
                            'Name': 'string',
                            'Type': 'CNAME',
                            'Value': 'string'
                        }
                    }
                },
                'ValidationStatus': 'PENDING_VALIDATION'|'SUCCESS'|'FAILED'
            }
        },
    ],

}

Response Structure

• (dict) –

  • DomainValidationSummaryList (list) –

    A list of DomainValidationSummary objects, one for each domain on the certificate. Each object contains the domain name and its active and requested validation configurations.

    • (dict) –

      Contains per-domain validation information for a certificate. This structure is returned as a member of the ListCertificateDomainValidations response.

      • DomainName (string) –

        The fully qualified domain name (FQDN) in the certificate for which this validation summary applies.

      • ActiveValidationConfiguration (dict) –

        The validation configuration currently in effect for this domain. This reflects the validation method that ACM is currently using to validate domain ownership (for example, email or DNS).

        • ValidationMethod (string) –

          The validation method for this configuration. Valid values:

          • DNS – Validation using a CNAME record added to your DNS configuration.

          • EMAIL – Validation using an approval email sent to domain contacts.

          • HTTP – Validation using an HTTP resource placed on your web server.

        • ValidationChallenge (dict) –

          The validation challenge details for this configuration. The structure varies by validation method: for DNS validation, contains a DnsValidationChallenge with the CNAME record to add; for email validation, contains an EmailValidationChallenge with the validation email addresses.

          Note

          This is a Tagged Union structure. Only one of the following top level keys will be set: EmailValidationChallenge, DnsValidationChallenge. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

          'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
          

          • EmailValidationChallenge (dict) –

            Contains the email addresses used for email-based domain validation.

            • ValidationEmails (list) –

              A list of email addresses that ACM uses to send domain validation emails.

              • (string) –

            • ValidationDomain (string) –

              The domain name that ACM uses to send validation emails.

          • DnsValidationChallenge (dict) –

            Contains the CNAME record that you must add to your DNS configuration to validate domain ownership using DNS validation.

            • ResourceRecord (dict) –

              The CNAME record that ACM creates for DNS validation. Add this record to your DNS configuration to prove that you own or control the domain.

              • Name (string) –

                The name of the DNS record to create in your domain. This is supplied by ACM.

              • Type (string) –

                The type of DNS record. Currently this can be CNAME.

              • Value (string) –

                The value of the CNAME record to add to your DNS database. This is supplied by ACM.

        • ValidationStatus (string) –

          The validation status for this domain. Valid values:

          • PENDING_VALIDATION – The domain is waiting for validation to complete.

          • SUCCESS – Validation completed successfully.

          • FAILED – Validation failed.

      • RequestedValidationConfiguration (dict) –

        The validation configuration for a pending validation method migration. This field is present only when a migration is in progress (for example, from email to DNS validation). It contains the target validation method, the current validation status, and the validation challenge details (such as the CNAME record to add to your DNS configuration).

        • ValidationMethod (string) –

          The validation method for this configuration. Valid values:

          • DNS – Validation using a CNAME record added to your DNS configuration.

          • EMAIL – Validation using an approval email sent to domain contacts.

          • HTTP – Validation using an HTTP resource placed on your web server.

        • ValidationChallenge (dict) –

          The validation challenge details for this configuration. The structure varies by validation method: for DNS validation, contains a DnsValidationChallenge with the CNAME record to add; for email validation, contains an EmailValidationChallenge with the validation email addresses.

          Note

          This is a Tagged Union structure. Only one of the following top level keys will be set: EmailValidationChallenge, DnsValidationChallenge. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

          'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
          

          • EmailValidationChallenge (dict) –

            Contains the email addresses used for email-based domain validation.

            • ValidationEmails (list) –

              A list of email addresses that ACM uses to send domain validation emails.

              • (string) –

            • ValidationDomain (string) –

              The domain name that ACM uses to send validation emails.

          • DnsValidationChallenge (dict) –

            Contains the CNAME record that you must add to your DNS configuration to validate domain ownership using DNS validation.

            • ResourceRecord (dict) –

              The CNAME record that ACM creates for DNS validation. Add this record to your DNS configuration to prove that you own or control the domain.

              • Name (string) –

                The name of the DNS record to create in your domain. This is supplied by ACM.

              • Type (string) –

                The type of DNS record. Currently this can be CNAME.

              • Value (string) –

                The value of the CNAME record to add to your DNS database. This is supplied by ACM.

        • ValidationStatus (string) –

          The validation status for this domain. Valid values:

          • PENDING_VALIDATION – The domain is waiting for validation to complete.

          • SUCCESS – Validation completed successfully.

          • FAILED – Validation failed.