Edge hostname

akamai_edge_hostname

Average processing time 10-15 minutes

Create, update, or delete an edge hostname. You can update only the TTL and IP version. To remove an edge hostname, run terraform destroy.

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

Edge hostname type	Domain suffix	Example
Standard TLS	edgesuite.net	`example.com.edgesuite.net`
Enhanced TLS	edgekey.net	`example.com.edgekey.net`
Shared Cert	akamaized.net	`example.akamaized.net`

When creating an edge hostname, the domain prefix must meet these requirements:

For the akamaized.net suffix: Keep the domain prefix 4–63 characters long. Start it with a letter, end it with a letter or digit, and include only letters, digits, and hyphens. For example, abcdef, ab123, ab123-4c5d, a1b2-cd3.
For any other suffix: Keep the domain prefix 1–63 characters long. Start it with a letter, end it with a letter, digit, or dot, and include only letters, digits, dots, and hyphens. For example, abc-def, 123.456., abc.123-def.
For the akamaized.net and other suffixes: The domain prefix can't begin or end with a hyphen.

📘
The domain prefix rules do not impact existing edge hostnames.

resource "akamai_edge_hostname" "my_edge_hostname" {
  product_id    = "prd_Adaptive_Media_Delivery"
  contract_id   = "C-0N7RAC7"
  group_id      = "12345"
  edge_hostname = "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:

Argument	Required	Description
`contract_id`	✔	A contract's ID.
`group_id`	✔	A group's ID.
`product_id`	✔	A product's ID.
`edge_hostname`	✔	One or more edge hostnames. The number of edge hostnames must be less than or equal to the number of public hostnames.
`ip_behavior`	✔	Which version of the IP protocol to use. Possible values: `IPV4` for version 4 only. `IPV6_PERFORMANCE` for version 6 only.
`ttl`		The 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_email`		A set of comma-separated change notification email addresses that should receive updates on the IP behavior update request.
`use_cases`		A JSON encoded list of Akamai-provided preset use case scenarios. They characterize the type of traffic served and help to optimize it.
`certificate`		Required 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 .
`timeouts`		Uses a `default` argument to override the HashiCorp processing timeout of 45 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.

Updated 5 days ago