Import and export assets

This page provides you with general instructions for using the import feature, which allows you to add existing resources to your state file without impacting your current Terraform configuration.

Additionally, it contains a reference list of import and export commands for each subprovider's resources that can help you effectively manage your configuration.

Import an existing resource

To add an existing configuration to your Terraform state file:

1. First, create a given resource's configuration with its required arguments in your Terraform configuration.

   hcl

   resource "akamai_edge_hostname" "my-hostname-import" {
       product_id    = "prd_Object_Delivery"
       contract_id   = "C-0N7RAC7"
       group_id      = "12345"
       edge_hostname = "example.com.edgesuite.net"
       ip_behavior   = "IPV4"
   }
   

2. Then use the terraform import command with a variable to the resource along with appropriate arguments.

   For example, to import an edge hostname, add your edge hostname, contract, and group IDs with the prefixes.

   Shell

   terraform import akamai_edge_hostname.my-hostname-import ehn_123456,ctr_C-0N7RAC7,grp_12345
   

   For the import commands for each subprovider's resources, see the Import list section.

Import list

Note: This list isn't exhaustive.

Export your resources

To use the export commands, you need to have our Terraform CLI installed on your device. With the export commands, you can import your configurations by running the included import script. Thanks to that, there is no need to create a configuration before importing, the export commands generate the configuration for you.

To export your assets, provide the path to your .edgerc, your credentials section header, and the export command for the asset you need. If you manage multiple accounts, pass your account switch key using the global --accountkey flag. Use other additional flags or arguments to further define the output.

Notes:

• If you pass the command without the global --edgerc and --section flags, the command, by default, will point to the local home directory of your .edgerc file and the default credentials section header of that file.
• By default, when your run the command, generated files are saved in your active directory. Use the --tfworkpath flag in any export command to change the storage path.

akamai terraform [global flags] command [command flags] [arguments...]

For example:

akamai terraform --edgerc "~/.edgerc" --section "default" --accountkey "A-CCT1234:A-CCT5432" export-property --version 3 "my-property"

This will generate a Terraform property configuration file with its JSON rules for a specific property version as well as the import script file for you to run to populate your Terraform state.

Export command help

To get help information for a given Terraform CLI command, pass the export command and the --help flag.

akamai terraform export-iam --help

Name:
  akamai-terraform export-iam

Usage:
  akamai-terraform [global flags] export-iam [command flags] <subcommand>

Description:
  Generates Terraform configuration for Identity and Access Management resources.

Subcommands:
  all
  allowlist
  group
  role
  user

Command Flags:
  --tfworkpath value  Directory used to store files created when running commands. (default: current directory)
  --help              show help (default: false)

Global Flags:
  --edgerc value, -e value                 Location of the credentials file (default: "/home/user/.edgerc") [$AKAMAI_EDGERC]
  --section value, -s value                Section of the credentials file (default: "default") [$AKAMAI_EDGERC_SECTION]
  --accountkey value, --account-key value  Account switch key [$AKAMAI_EDGERC_ACCOUNT_KEY]

See the Export list for the available export commands and their syntax.

Export list