upstream/terraform
1
0
Fork 0
mirror of https://github.com/hashicorp/terraform.git synced 2026-05-28 04:03:27 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions 9

docs: more detail on import IDs (#34153)

Browse source
This commit is contained in:
kmoe 2023-11-21 08:35:26 +00:00 committed by GitHub
parent afc83356ca
commit 33dfeecbee
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 2 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
website/docs/language/import/index.mdx
View file

@ -36,14 +36,14 @@ The above `import` block defines an import of the AWS instance with the ID "i-ab
The `import` block has the following arguments:
- `to` - The instance address this resource will have in your state file.
- `id` - A string with the [import ID](#import-id) of the resource.
- `id` - A string with the [import ID](#import-id) of the resource, or an expression that evaluates to a string.
- `provider` (optional) - An optional custom resource provider, see [The Resource provider Meta-Argument](/terraform/language/meta-arguments/resource-provider) for details.
If you do not set the `provider` argument, Terraform attempts to import from the default provider.
### Import ID
The import block's `id` argument can be a literal string of your resource's import ID, or an expression that evaluates to a string. Terraform needs this import ID to locate the resource you want to import.
The import block's `id` argument can be a literal string of your resource's import ID, or an expression that evaluates to a string, such as `var.instance_id`. Terraform needs this import ID to locate the resource you want to import.
The import ID must be known at plan time for planning to succeed. If the value of `id` is only known after apply, `terraform plan` will fail with an error.