Hostnames
akamai_property_hostnames
Get an existing property's hostnames and certificate statuses.
To view Enhanced TLS hostnames, you need at least Secure Site Delivery CNAMEs - View only access.
Contact your admin user if you need additional permissions.
Example
This example returns the property's hostnames based on the selected contract and group.
data "akamai_property_hostnames" "my-example" {
property_id = "prp_123"
group_id = "grp_12345"
contract_id = "ctr_1-AB123"
}
output "property_hostnames" {
value = data.akamai_property_hostnames.my-example.hostnames
}
Argument reference
This data source supports these arguments:
contract_id
-Ā (Required) A contract's unique ID, including thectr_
prefix.group_id
-Ā (Required) A group's unique ID, including thegrp_
prefix.property_id
-Ā (Required) A property's unique ID, including theprp_
prefix.
Attributes reference
This data source returns these attributes:
-
hostnames
- A list of hostnames for the property, including:-
cname_type
- A string containing the hostname's cname type value. -
edge_hostname_id
- The edge hostname's unique ID, including theehn_
prefix. -
cname_from
- A string containing the original origin's hostname. -
cname_to
- A string containing the hostname for edge content. -
cert_provisioning_type
- The certificate's provisioning type, either the defaultCPS_MANAGED
type for the custom certificates you provision with the Certificate Provisioning System (CPS), orDEFAULT
for certificates provisioned automatically. -
cert_status
- If applicable, this shows a list of certificate statuses, including:target
- The destination part of the CNAME record used to validate the certificate's domain.hostname
- The hostname part of the CNAME record used to validate the certificate's domain.production_status
- A string containing the status of the certificate deployment on the production network.staging_status
- A string containing the status of the certificate deployment on the staging network.
-
Domain validation for DEFAULT certificates
If your cert_provisioning_type = "DEFAULT"
and the value for cert_status.production_status
or cert_status.staging_status
is either PENDING
, EXPIRING_SOON_NEEDS_VALIDATION
, or EXPIRED_NEEDS_VALIDATION
, you need to perform domain validation. This proves to the certificate authority that you control the domain and are authorized to create certificates for it.
In your DNS configuration, create a CNAME record and map the cert_status.hostname
value to the cert_status.target
value.
Updated 5 months ago