GuideReference
Guide

Property

akamai_property

Create, update, move, or remove a property configuration.

  • Create a property with a default set of rules that provide basic services and protections. You can also create a new property with an existing set of rules using the rules argument.

  • Update a property's rules or hostnames.

  • Move an activated or previously activated property to a parent, sibling, or child group. There are two exceptions, however.

    • The property you want to move cannot have a Datastream as the Datastream asset does not move to the destination group. To accomplish a move, you have to create a new property and Datastream in the destination group that mirror the source assets.
    • Properties that use cloud access keys will move, but the source group's key is not available for use in the destination group. You need to update the key in the destination group before you can activate the configuration.

    To move a property, import the property you want to move into your state and pass the destination group's ID as the value of group_id.

  • Remove a property by running terraform destroy.

resource "akamai_property" "my_property" {
    name    	= "MyProperty"
    product_id  = "prd_Object_Delivery"
    contract_id = "C-0N7RAC7"
    group_id    = "12345"
}
resource "akamai_property" "my_property" {
    name    	= "MyProperty"
    product_id  = "prd_Object_Delivery"
    contract_id = "C-0N7RAC7"
    group_id    = "12345"
    rule_format = "v2023-05-30"
    rules       = file("${path.root}/property-snippets/main.json")
    hostnames {
      cname_from             = "example.com"
      cname_to 	             = "example.com.edgekey.net"
      cert_provisioning_type = "DEFAULT"
    }
}

Arguments

Pass a property name and your contract and product IDs to create or manage a property.

ArgumentRequiredDescription
name✔️A human-readable name you give to identify your property.
contract_id✔️Your contract ID.
group_id✔️The group ID to which the property belongs.
product_id✔️A product ID including the prd_ prefix. See Common identifiers for a list of product IDs.
hostnamesA mapping of public hostnames to edge hostnames. If used, include these additional required arguments:
  • cname_from. Your origin's hostname.
  • cname_to. The hostname for edge content.
  • cert_provisioning_type. Your certificate's provisioning type. Either CPS_MANAGED for custom certificates you provision or DEFAULT for certificates provisioned automatically.
rulesThe location of your rules. Use the path to a local file or a variable that represents the output of the Rules builder or Rules template data source.
rule_formatA versioned rule schema and set of available behaviors and criteria. If not provided, we apply the latest rule format by default.

Attributes

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

Setting an output method returns the property details you provided on create along with these additions.

AttributeDescription
idYour property's ID.
rule_errorsAny errors returned by the API.
latest_versionThe version of the property you've created or updated rules for. We use the latest version or create a new version if latest is not editable.
production_versionThe current property version active on the Akamai production network.
staging_versionThe current property version active on the Akamai staging network.
version_notesAdditional information about a property version.