Domain validation

akamai_property_domainownership_validation

📘

Beta

Hello. Just a note to let you know the underlying API on which this resource is built is in a beta state, so it's not vetted yet.

Because this functionality is also new to our Terraform provider, we've given it beta label to get your feedback to make sure it works like you need and expect.

For more details on domain validation enforcement, see the Validate domains guide.

Validate or invalidate your domains. To invalidate all domains, run terraform destroy.

You can validate up to 1,000 domains in that resource at once. However, for optimal performance and a smoother user experience, keep the number of domains well below this limit.

resource "akamai_property_domainownership_validation" "my-validation" {
  domains = [
    {
      domain_name       = "example.com"
      validation_scope  = "HOST"
      validation_method = "DNS_CNAME"
    },
    {
      domain_name       = "sub.example.com"
      validation_scope  = "WILDCARD"
      validation_method = "DNS_CNAME"
    }
  ]
}
my-validation = {
  domains  = [
    {
      domain_name       = "example.com"
      validation_method = "DNS_CNAME"
      validation_scope  = "HOST"
    },
    {
      domain_name       = "sub.example.com"
      validation_method = "DNS_CNAME"
      validation_scope  = "WILDCARD"
    },
  ]
  timeouts = null
}

Arguments

Send a list of domains to validate.

Argument Required Description
domains A list of domains. Each domain record includes:
  • domain_name. Required. Your domain's name.
  • validation_scope. Required. Your domain's validation scope. Possible values are:
    • HOST. The scope is only the exactly specified domain.
    • WILDCARD. The scope covers any hostname within one subdomain level.
    • DOMAIN. The scope covers any hostnames under the domain, regardless of the level of subdomains.
  • validation_method. The method used to validate the domain. If not provided, DOM will first attempt to perform the validation using automatic background scheduled jobs. Possible values are:
    • DNS_CNAME. For this method, Akamai generates a cname_record that you copy as the target to a CNAME record of your DNS configuration. The record's name needs to be in the _acme-challenge.domain-name format.
    • DNS_TXT. For this method, Akamai generates a txt_record with a token value that you copy as the target to a TXT record of your DNS configuration. The record's name needs to be in the _akamai-{host|wildcard|domain}-challenge.domainName format based on the validation scope.
    • HTTP. Applies only to domains with the HOST validation scope. For this method, you create the file containing a token and place it on your HTTP server in the location specified by the domains[0].validation_challenge.http_file.path or use a redirect to the domains[0].validation_challenge.http_redirect.to with the token.
timeouts Uses the create and update arguments to override the provider's processing timeout. By default, it's 30 minutes. Value is a string containing a number and its time reference, h for hours, m for minutes, s for seconds. You can pass one, two, or all time units. For example:
  • 1h3m5s
  • 2h5m
  • 3m

Attributes

There's no standard output for this resource as changes are reflected in your state file and based on what you passed in the resource block body.