GuideReference
TrainingSupportCommunity
Guide

Edge hostname

akamai_edge_hostname

Average processing time 10-15 minutes

Create or update an edge hostname. You can update only the TTL and IP version.

Akamai supports three types of edge hostnames. Each type supports a different level of security.

Edge hostname typeDomain suffixExample
Standard TLSedgesuite.netwww.example.com.edgesuite.net
Enhanced TLSedgekey.netwww.example.com.edgekey.net
Shared Certakamaized.netwww.example.com.akamaized.net
resource "akamai_edge_hostname" "my_edge_hostname" {
  product_id    = "prd_Adaptive_Media_Delivery"
  contract_id   = "C-0N7RAC7"
  group_id      = "12345"
  edge_hostname = "www.example.com.edgesuite.net"
  ip_behavior   = "IPV4"
  ttl           = 300
  use_cases = jsonencode([
    {
      "type" : "GLOBAL",
      "option" : "LIVE",
      "useCase" : "Segmented_Media_Mode"
    }
  ])
  timeouts {
    default = "1h"
  }
}

Arguments

The resource supports these arguments:

ArgumentRequiredDescription
contract_idA contract's ID.
group_idA group's ID.
product_idA product's ID.
edge_hostnameOne or more edge hostnames. The number of edge hostnames must be less than or equal to the number of public hostnames.
ip_behaviorWhich version of the IP protocol to use. Possible values:
  • IPV4 for version 4 only.
  • IPV6_PERFORMANCE for version 6 only.
ttlThe time to live. The number of seconds to keep an edge hostname assigned to a map or target. If not provided, the default value for a product is used.
status_update_emailA set of comma-separated change notification email addresses that should receive updates on the IP behavior update request.
use_casesA JSON encoded list of Akamai-provided preset use case scenarios. They characterize the type of traffic served and help to optimize it.
certificateRequired only when creating an Enhanced TLS edge hostname. Sets the certificate enrollment ID. Edge hostnames for Enhanced TLS end in edgekey.net. You can retrieve this ID from the Certificate Provisioning Service CLI .
timeoutsUses a delete argument to override the HashiCorp processing timeout of 20 minutes. Value is a string containing a number and its time reference, h, m, s. You can pass one, two, or all values. For example:
  • 1h3m5s
  • 2h5m
  • 3m

Attributes

If you've not set an output method, the response only provides an edge hostname ID in the success message.

Setting an output method returns the edge hostname details you provided on create along with the computed edge hostname ID.