Edge hostname

akamai_edge_hostname

Get details of an edge hostname.

  • To assign an edge hostnames to a property, use the akamai_property resource.
  • To modify an existing edge hostname or delete any that aren't currently assigned to an active property configuration, use the akamai_edge_hostname resource.
data "akamai_edge_hostname" "my-edge-hostname" {
  id          = "98765"
  contract_id = "C-0N7RAC7"
  group_id    = "12345"
}

output "my-edge-hostname" {
  value = data.akamai_edge_hostname.my-edge-hostname
}
my-edge-hostname = {
  account_id  = "act_A-CCT1234"
  contract_id = "C-0N7RAC7"
  edge_hostname = {
    domain_prefix         = "example.com"
    domain_suffix         = "edgesuite.net"
    edge_hostname_domain  = "example.com.edgesuite.net"
    edge_hostname_id      = "ehn_98765"
    https_service_binding = null
    ip_version_behaviour  = "IPV4"
    product_id            = "prd_Download_Delivery"
    secure                = false
    status                = "CREATED"
    use_cases = [
      {
        option   = "BACKGROUND"
        type     = "GLOBAL"
        use_case = "Download_Mode"
      },
    ]
  }
  group_id = "12345"
  id       = "98765"
  options  = null
}

Arguments

Pass your edge hostname, contract, and group IDs in the data block to get the edge hostname's details.

NameRequiredDescription
id✔Your edge hostname's ID.
contract_id✔Your contract's ID.
group_id✔Your group's ID.
optionsOptional query parameters that enable extra mapping-related information.

Attributes

Returned to you are the account and edge hostname's details.

NameDescription
account_idThe account's ID.
edge_hostnamesThe set of requested edge hostnames. Contains:
  • domain_prefix. The origin domain portion of the edge hostname.
    An edge hostname consists of a customer-specific domain_prefix such as example.com and an Akamai-specific domain_suffix such as edgesuite.net. The edge hostname's final DNS CNAME combines the two, for example, example.com.edgesuite.net.
  • domain_suffix. The Akamai-specific portion of the edge hostname, for example, edgesuite.net.
  • edge_hostname_domain. The full edge domain name formed from the domain_prefix and domain_suffix.
  • edge_hostname_id. The edge hostname's ID, which can be assigned to a property.
  • ip_version_behaviour. The IP version behavior of the edge hostname.
  • product_id. The product ID for which you created the edge hostname.
  • secure. Whether to use the edge hostname with SSL. Defaults to false for POST requests. Enabling this option for new edge hostnames isn't supported.
  • status. The status of the edge hostname. Possible values are:
    • PENDING indicates any newly defined hostname whose DNS mapping hasn't yet been distributed across the entire Akamai network.
    • CREATED indicates the DNS mapping distribution has completed.
    If the status is omitted, it indicates the edge hostname is active. Note that an edge hostname's status isn't related to a property activation's deployment status.
  • map_details_serial_number. The map details' serial number.
  • map_details_slot_number. The map details' slot number.
  • map_details_map_domain. The map details' map domain
  • https_service_binding. The type of HTTPS service binding for the edge hostname. Possible values are: H2, H3, or H2_AND_H3. May be null if it wasn't specified upon edge hostname creation.
  • use_cases. Available use cases for edge hostnames assigned to the product. May be null if no use cases were specified upon edge hostname creation.
    • option. One of the options available in the response.
    • type. The type of the network over which traffic deploys. Currently, the only available value is GLOBAL.
    • use_case. The name of the use case.
    • delivery_policy. Details information about the edge hostname's delivery policy. Contains:
      • policy_type. The type of delivery policy. Value is GEO_OPT_IN.
      • policy_attributes. Properties of the policy. Contains:
        • attribute_type. The kind of information detailed. The value is GEO. This type provides details about your traffic delivery location.
        • code. A geographic region code for the delivery location. Possible values are:
          • EU_CH_GB
          • IN
          • US
        • name. The human-readable name for the delivery location. Possible values are:
          • European Union
          • Switzerland and Great Britain
          • India
          • USA
optionsThe list of query parameters that enable extra mapping-related information.

Did this page help you?