DXE-3507 Document how to import a property

[stigok]

Affected Resource(s)

Please list the resources as a list, for example:

• akamai_property

Instructions on how to import a resource of type akamai_property using the terraform import command is not documented on the property resource page https://techdocs.akamai.com/terraform/docs/pm-rc-property.

[lsadlon]

Hi @stigok

Thank you for raising this issue. We will investigate it and get back to you.

BR,
Lukasz

[lkowalsk-akamai-com]

Hi @stigok please check if this part of the documentation helps you: https://techdocs.akamai.com/terraform/docs/set-up-property-provisioning#import-a-property This shows much easier way to import the property using cli-terraform to do the export of a given property.

[stigok]

Yes, it helps, but it is not located where one expects to find that information. It would be ideal to keep the import instructions on a specific resource's documentation page, as this is what one expects when working with almost all other Terraform providers.

[estif95]

It would be really usefull! As a workarround we are using the documentation of the provider version 3.4.0. that is still working in the latest version of the provider: https://registry.terraform.io/providers/akamai/akamai/3.4.0/docs/resources/property#import

@lkowalsk-akamai-com the CLI can be usefull in some cases, specially when you don't have the Terraform configuration writen and want a massive export, but in our case, we are using Terraform modules to create the properties and we are importing old properties to our modules. I can modify the script that the CLI generates to match the way we are working, but I think it should be more easier if only documented as we expect on a provider.

The import block feature of Terraform is so usefull https://developer.hashicorp.com/terraform/language/import#syntax and it makes imports GitOps on every Terraform CICD. This allows teams to collaborate on "imports" tasks and follow what happens in a specific resource since it's creation (even if the resource was originally imported or created by terraform).

Thanks,
Esteve