Importing ilert UI resources into Terraform state
Last updated
Was this helpful?
Last updated
Was this helpful?
When working with with Terraform you have the option to create resources (managed by Terraform) or data sources (managed by ilert and read-only accessed by your Terraform config).
Often you have setup resources in ilert through API or UI before you start using Terraform to manage your setup and you want to know how to manage these resources as well, without deleting them first.
To do that, we can import resources into your local Terraform config.
Bring the configuration into your Terraform config.
Imagine we have the user Max Mustermann with the ID 123456 created through the UI in ilert. To import him into TF, we first setup a block.
Now with the block setup, we need to tell Terraform to import the existing user from ilert into the block relation for the internal state management (otherwise TF will try to create a new user instead of updating it)
After the import was successful, the block is now properly mapped to the identifer and you can continue as usual running terraform plan or terraform apply.
You can either use the API or the UI to find the identifier of your resource:
In the UI head to the detail view of your desired resource and copy the id param of your browser's URL:
For the API, you may call the GET list resources of your entities e.g. GET /api/alert-sources and use the id field of the returned objects.
Should you have many entities, we recommend using the (inofficial) ?query= param to search for the name of your desired resource:
Note that while in 99% of the cases, the import keys (identifiers) are the same as the entity’s ID, they sometimes might differ. You can find the import description at the bottom of each resource in .
