Property

Create, update, or remove a property configuration.

Pass the minimum arguments required in the declaration to create a property with a default set of rules. The defaults provide basic services and protections that you can either activate or edit.

To use the defaults:

Add a CP code and an origin hostname to the rules.
An edge hostname argument in an update to your property using this resource.
Activate your property.

To remove a configuration, run 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"
  version_notes = "Sample notes"
  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.

Argument	Required	Description
`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.
`hostnames`		A 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. Note: When the `DEFAULT` certificate's production or staging status is `PENDING`, `EXPIRING_SOON_NEEDS_VALIDATION`, or `EXPIRED_NEEDS_VALIDATION`, perform a domain validation to prove you control the domain. You can do this by adding a `CNAME` record to your DNS.
`rules`		The 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_format`		A versioned rule schema and set of available behaviors and criteria. If not provided, we apply the latest rule format by default. Run the Rule formats data source for a list of supported rule formats.
`version_notes`		Human-readable notes about your property's version.

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 computed attributes.

Attribute	Description
`id`	Your property's ID.
`rule_errors`	Any `errors` returned by the API.
`rule_warnings`	Any rule warnings returned by the API.
`latest_version`	The 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_version`	The current property version active on the Akamai production network.
`staging_version`	The current property version active on the Akamai staging network.
`hostnames`	A mapping of public hostnames to edge hostnames. If used, it returns these computed attributes: `cname_type`. A hostname's CNAME type. Supports only the `EDGE_HOSTNAME` value. `edge_hostname_id`. An edge hostname's ID. `cert_status`. A certificate's status details. `hostname`. The hostname part of the CNAME record used to validate the certificate's domain. `production_status`. The certificate's deployment status on the production network. `staging_status`. The certificate's deployment status on the staging network. `target`. The destination part of the CNAME record used to validate the certificate's domain.
`read_version`	The required property's version to be read.