GuideReference
TrainingSupportCommunity
Guide

Hostnames

akamai_property_hostnames

Get a given property's hostnames and certificate statuses.

🚧

To view Enhanced TLS hostnames, you need at least Secure Site Delivery CNAMEs - View only access.

Use the roles data source to determine your access level.

data "akamai_property_hostnames" "my_property_hostnames" {
    group_id    = "12345"
    contract_id = "C-0N7RAC7"
    property_id = "12345"
    version     = 3
}

output "my_property_hostnames" {
  value = data.akamai_property_hostnames.my_property_hostnames
}
+ my_property_hostnames = {
      + contract_id = "C-0N7RAC7"
      + group_id    = "12345"
      + hostnames   = [
          + {
              + cert_provisioning_type = "DEFAULT"
              + cert_status            = [
                  + {
                      + hostname          = "_acme-challenge.my-property-hostnames.com"
                      + production_status = "ACTIVE"
                      + staging_status    = "ACTIVE"
                      + target            = "ac.123456a1234abc1abcdefg12345a1234.my-property-hostnames.com.validate-akdv.net"
                    },
                ]
              + cname_from             = "my-property-hostnames.com"
              + cname_to               = "my-property-hostnames.com.edgesuite.net"
              + cname_type             = "EDGE_HOSTNAME"
              + edge_hostname_id       = "ehn_1234567"
            },
        ]
      + id          = "prp_1234567"
      + property_id = "prp_123456"
      + version     = 3
    }

Arguments

Send your contract, group, and property IDs in the declaration to get hostname information.

ArgumentRequiredDescription
contract_id✔️Your contract ID.
group_id✔️Your group ID.
property_id✔️Your property's ID.
versionYour property's version number. If no value is passed, the information returned is from the latest version.

Attributes

Returned to you is a computed set that contains an edge hostname's ID among other details.

Attribute Description
cname_type A hostname's CNAME type.
edge_hostname_id A hostname's ID, including the ehn_ prefix.
hostnames A set of your property's hostnames.
  • cname_type. A hostname's CNAME type.
  • edge_hostname_id. A hostname's ID, including the ehn_ prefix.
  • cname_from. A hostname's origin.
  • cname_to. The hostname for edge content.
  • cert_provisioning_type. A certificate's provisioning type. Either CPS_MANAGED. for custom provisioned certificates or DEFAULT for automatically provisioned certificates.
    Note: If the value is DEFAULT and the value for either the production or staging status is PENDING, EXPIRING_SOON_NEEDS_VALIDATION, or EXPIRED_NEEDS_VALIDATION, perform domain validation to prove you control the domain.
  • cert_status. A certificate's status details.
    • hostname. The hostname CNAME record used to validate a certificate's domain.
    • production_status. The certificate's deployment status on the production network.
    • staging_status. The certificate's deployment status on the staging network.
    • target. The destination CNAME record used to validate a certificate's domain.