aherman
/
terraform
mirror of https://github.com/hashicorp/terraform
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Apply suggestions from code review

Browse Source 
Co-authored-by: Rose M Koron <32436232+rkoron007@users.noreply.github.com>
docs/atrujillo/lang-add-moved-ref
trujillo-adam 2 years ago committed by GitHub
parent d56ed45484
commit e3d2923c1f
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 5 additions and 6 deletions
Show Stats Download Patch File Download Diff File

11
website/docs/language/moved.mdx
Unescape View File

@ -1,6 +1,6 @@
---
page_title: moved block configuration reference
description: Learn about the `moved` block that you can specify in Terraform configurations. The `moved` block programmatically changes the location of resource.
description: Learn about the `moved` block that you can specify in Terraform configurations. The `moved` block programmatically changes the location of a resource.
---
# Moved block configuration reference
@ -24,7 +24,6 @@ The following list outlines field hierarchy, language-specific data types, and r
When every field is defined, a `moved` block has the following form:
```hcl
moved = {
from = <old address for the resource>
to = <new address for the resource>
@ -41,14 +40,14 @@ Map that specifies addresses for the resource. The following table describes the
| Field | Description | Type | Required |
| --- | --- | --- | --- |
| `from` | Specifies the previous address of the resource addresses using a syntax that allows Terraform to select modules, resources, and resources inside child modules. | string | required |
| `to` | Sepcifies the current address of the resource using a syntax that allows Terraform to select modules, resources, and resources inside child modules. | string | required |
| `from` | Specifies a resource's previous address. The syntax allows Terraform to select modules, resources, and resources inside child modules. | string | required |
| `to` | Specifies the new address to relocate the resource to. The syntax allows Terraform to select modules, resources, and resources inside child modules. | string | required |
Before creating a new plan for the resource specified in the `to` field, Terraform checks the state for an existing object at the address specified in the `from` field. Terraform renames existing objects to the string specified in the `to` field then creates a plan. The plan directs Terraform to provision the resource specified in the `from` field as the resource specified in the `to` field. As a result, Terraform does not destroy the resource during the Terraform run.
Before creating a new plan for the resource specified in the `to` field, Terraform checks the state for an existing object at the address specified in the `from` field. Terraform renames existing objects to the string specified in the `to` field and then creates a plan. The plan directs Terraform to provision the resource specified in the `from` field as the resource specified in the `to` field. As a result, Terraform does not destroy the resource during the Terraform run.
## Example
The following example moves and AWS instance from address `aws_instance.a` to `aws_instance.b`:
The following example moves an AWS instance from address `aws_instance.a` to `aws_instance.b`:
```hcl
moved {

Write Preview
Loading…
Cancel
Save