Domain

akamai_property_domainownership_domain

Get the details and status history for a domain within your chosen scope.

data "akamai_property_domainownership_domain" "my-domain" {
  domain_name      = "example.com"
  validation_scope = "HOST"
}

output "my-domain" {
  value = data.akamai_property_domainownership_domain.my-domain
}

my-domain = {
  account_id                = "A-CCT1234"
  domain_name               = "example.com"
  domain_status             = "VALIDATED"
  domain_status_history     = [
    {
      domain_status = "REQUEST_ACCEPTED"
      message       = null
      modified_date = "2025-02-03T16:33:54Z"
      modified_user = "jsmith"
    },
    {
      domain_status = "VALIDATION_IN_PROGRESS"
      message       = null
      modified_date = "2025-02-03T16:34:01Z"
      modified_user = "SYSTEM"
    },
    {
      domain_status = "VALIDATED"
      message       = null
      modified_date = "2025-02-03T16:35:00Z"
      modified_user = "SYSTEM"
    },
  ]
  validation_challenge      = {
    cname_record    = {
      name   = "_acme-challenge.example.com"
      target = "ac.1ab23c45def678gh9ij01klm23n4op.example.com.validate-akdv.net"
    }
    expiration_date = "2025-05-04T16:33:54Z"
    http_file       = {
      content      = "abcDeFghi12JK-LmNopQr3ST-uVwX4Y_zAbCDEfgijkLmnoPqRstuV5-wXy678Z"
      content_type = "text/plain"
      path         = "https://example.com/.well-known/akamai/akamai-challenge/abc1dEf3gh-ij3hlmoPr"
    }
    http_redirect   = {
      from = "https://example.com/.well-known/akamai/akamai-challenge/abc1dEf3gh-ij3hlmoPr"
      to   = "https://validation.akamai.com/.well-known/akamai/akamai-challenge/abcDeFghi12JK-LmNopQr3ST-uVwX4Y_zAbCDEfgijkLmnoPqRstuV5-wXy678Z"
    }
    txt_record      = {
      name  = "_akamai-host-challenge.example.com"
      value = "abcDeFghi12JK-LmNopQr3ST-uVwX4Y_zAbCDEfgijkLmnoPqRstuV5-wXy678Z"
    }
  }
  validation_completed_date = "2025-02-03T16:35:00Z"
  validation_method         = "HTTP"
  validation_requested_by   = "jsmith"
  validation_requested_date = "2025-02-03T16:33:54Z"
  validation_scope          = "HOST"
}

Arguments

Pass the domain's name and its validation scope in the data block to get the domain's details.

Argument	Required	Description
`domain_name`	✔	Your domain's name.
`validation_scope`	✔	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.

Attributes

Returned to you are the domain's details with its status history.

Attribute	Description
`account_id`	Your account's ID.
`domain_status`	The domain's validation status. Possible values are: `REQUEST_ACCEPTED`. When you successfully submit the domain for validation. `VALIDATION_IN_PROGRESS`. When DOM has initiated domain validation, either via background jobs or an API request, but the validation hasn't succeeded. This status remains until the domain challenges are correctly configured and successfully verified. `VALIDATED`. When the validation is completed successfully. Akamai recognizes you as the domain owner. `TOKEN_EXPIRED`. When you haven't completed the validation in the requested time frame and the challenge token is not valid anymore. You need to generate new validation challenges for the domain. `INVALIDATED`. When the domain was invalidated and Akamai doesn't recognize you as its owner.
`validation_method`	The method used to validate the domain. 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 `validation_challenge.http_file.path` or use a redirect to the `validation_challenge.http_redirect.to` with the token. `SYSTEM`. This method refers to domains that were automatically validated before Domain Validation Manager (DOM) was introduced. `MANUAL`. For this method, the DOM team manually performed the validation.
`validation_requested_by`	The name of the user who requested the domain validation.
`validation_requested_date`	The timestamp indicating when the domain validation was requested.
`validation_completed_date`	The timestamp indicating when the domain validation was completed.
`validation_challenge`	The domain's validation challenge details. Includes: `cname_record`. The details of the `CNAME` record you copy to your DNS configuration to prove you own the domain. You should use the `DNS_CNAME` method in most cases. Includes: `name`. The `CNAME` record for your domain that you add to the DNS configuration. `target`. The `target` value you set in the `CNAME` record that validates the domain ownership. `txt_record`. The details of the `TXT` record with the challenge token that you copy to your DNS configuration to prove you own the domain. Includes: `name`. The hostname where you should add the `TXT` record to validate the domain ownership. `value`. The token you need to copy to the DNS `TXT` record that validates the domain ownership. `http_file`. Available only for the `HOST` validation scope. The details for the HTTP validation method in which you create a file containing a token and save it on your HTTP server at the provided URL. Alternatively, you can use the `http_redirect` method. Includes: `path`. The URL where you should place the file containing the challenge token. `content`. The content of the file that you should place at the specified URL. `content_type`. The content type of the file containing the token. `http_redirect`. Available only for the `HOST` validation scope. The details for the HTTP validation method in which you use a redirect URL with the token. Alternatively, you can use the `http_file` method. Includes: `from`. The location on your HTTP server where you set up the redirect. `to`. The redirect URL with the token that you place on your HTTP server. `expiration_date`. The timestamp indicating when the challenge data expires.
`domain_status_history`	A list of domain status history changes. Each change record includes: `domain_status`. The domain's validation status. Possible values are: `REQUEST_ACCEPTED`. When you successfully submit the domain for validation. `VALIDATION_IN_PROGRESS`. When the DOM background jobs are trying to validate the domain. `VALIDATED`. When the validation is completed successfully. Akamai recognizes you as the domain owner. `TOKEN_EXPIRED`. When you haven't completed the validation in the requested time frame and the challenge token is not valid anymore. You need to generate new validation challenges for the domain. `INVALIDATED`. When the domain was invalidated and Akamai doesn't recognize you as its owner. `modified_user`. The name of the user who requested the status change. `modified_date`. The timestamp indicating when the domain status changed. `message`. Additional information about the status change.

Updated 25 days ago

Did this page help you?