Add docs about how to import with google-beta (hashicorp#255)

modular-magician · rileykarson · commit 526447f7343f · 2018-12-18T13:04:40.000-08:00
/cc @rileykarson
diff --git a/website/docs/provider_versions.html.markdown b/website/docs/provider_versions.html.markdown
@@ -85,6 +85,16 @@ resource "google_compute_instance" "beta-instance" {
 }
 ```
 
+## Importing resources with `google-beta`
+By default, Terraform will always import resources using the `google` provider.
+To import resources with `google-beta`, you need to explicitly specify a provider
+with the `-provider` flag, similarly to if you were using a provider alias.
+
+
+```bash
+terraform import -provider=google-beta google_compute_instance.beta-instance my-instance
+```
+
 ## Converting resources between versions
 
 Resources can safely be converted from one version to the other without needing to rebuild infrastructure.
diff --git a/website/docs/r/accesscontextmanager_access_level.html.markdown b/website/docs/r/accesscontextmanager_access_level.html.markdown
@@ -203,5 +203,8 @@ This resource provides the following
 AccessLevel can be imported using any of these accepted formats:
 
 ```
-$ terraform import google_access_context_manager_access_level.default {{name}}
+$ terraform import -provider=google-beta google_access_context_manager_access_level.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/accesscontextmanager_access_policy.html.markdown b/website/docs/r/accesscontextmanager_access_policy.html.markdown
@@ -96,5 +96,8 @@ This resource provides the following
 AccessPolicy can be imported using any of these accepted formats:
 
 ```
-$ terraform import google_access_context_manager_access_policy.default {{name}}
+$ terraform import -provider=google-beta google_access_context_manager_access_policy.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/accesscontextmanager_service_perimeter.html.markdown b/website/docs/r/accesscontextmanager_service_perimeter.html.markdown
@@ -207,5 +207,8 @@ This resource provides the following
 ServicePerimeter can be imported using any of these accepted formats:
 
 ```
-$ terraform import google_access_context_manager_service_perimeter.default {{name}}
+$ terraform import -provider=google-beta google_access_context_manager_service_perimeter.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/binaryauthorization_attestor.html.markdown b/website/docs/r/binaryauthorization_attestor.html.markdown
@@ -164,7 +164,10 @@ This resource provides the following
 Attestor can be imported using any of these accepted formats:
 
 ```
-$ terraform import google_binary_authorization_attestor.default projects/{{project}}/attestors/{{name}}
-$ terraform import google_binary_authorization_attestor.default {{project}}/{{name}}
-$ terraform import google_binary_authorization_attestor.default {{name}}
+$ terraform import -provider=google-beta google_binary_authorization_attestor.default projects/{{project}}/attestors/{{name}}
+$ terraform import -provider=google-beta google_binary_authorization_attestor.default {{project}}/{{name}}
+$ terraform import -provider=google-beta google_binary_authorization_attestor.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/binaryauthorization_policy.html.markdown b/website/docs/r/binaryauthorization_policy.html.markdown
@@ -178,6 +178,9 @@ This resource provides the following
 Policy can be imported using any of these accepted formats:
 
 ```
-$ terraform import google_binary_authorization_policy.default projects/{{project}}
-$ terraform import google_binary_authorization_policy.default {{project}}
+$ terraform import -provider=google-beta google_binary_authorization_policy.default projects/{{project}}
+$ terraform import -provider=google-beta google_binary_authorization_policy.default {{project}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_address.html.markdown b/website/docs/r/compute_address.html.markdown
@@ -218,3 +218,6 @@ $ terraform import google_compute_address.default projects/{{project}}/regions/{
 $ terraform import google_compute_address.default {{project}}/{{region}}/{{name}}
 $ terraform import google_compute_address.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_autoscaler.html.markdown b/website/docs/r/compute_autoscaler.html.markdown
@@ -298,3 +298,6 @@ $ terraform import google_compute_autoscaler.default {{zone}}/{{name}}
 $ terraform import google_compute_autoscaler.default {{project}}/{{zone}}/{{name}}
 $ terraform import google_compute_autoscaler.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_backend_bucket.html.markdown b/website/docs/r/compute_backend_bucket.html.markdown
@@ -122,3 +122,6 @@ $ terraform import google_compute_backend_bucket.default projects/{{project}}/gl
 $ terraform import google_compute_backend_bucket.default {{project}}/{{name}}
 $ terraform import google_compute_backend_bucket.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_disk.html.markdown b/website/docs/r/compute_disk.html.markdown
@@ -275,3 +275,6 @@ $ terraform import google_compute_disk.default projects/{{project}}/zones/{{zone
 $ terraform import google_compute_disk.default {{project}}/{{zone}}/{{name}}
 $ terraform import google_compute_disk.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_firewall.html.markdown b/website/docs/r/compute_firewall.html.markdown
@@ -266,3 +266,6 @@ $ terraform import google_compute_firewall.default projects/{{project}}/global/f
 $ terraform import google_compute_firewall.default {{project}}/{{name}}
 $ terraform import google_compute_firewall.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_forwarding_rule.html.markdown b/website/docs/r/compute_forwarding_rule.html.markdown
@@ -253,3 +253,6 @@ $ terraform import google_compute_forwarding_rule.default projects/{{project}}/r
 $ terraform import google_compute_forwarding_rule.default {{project}}/{{region}}/{{name}}
 $ terraform import google_compute_forwarding_rule.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_global_address.html.markdown b/website/docs/r/compute_global_address.html.markdown
@@ -142,3 +142,6 @@ $ terraform import google_compute_global_address.default projects/{{project}}/gl
 $ terraform import google_compute_global_address.default {{project}}/{{name}}
 $ terraform import google_compute_global_address.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_health_check.html.markdown b/website/docs/r/compute_health_check.html.markdown
@@ -264,3 +264,6 @@ $ terraform import google_compute_health_check.default projects/{{project}}/glob
 $ terraform import google_compute_health_check.default {{project}}/{{name}}
 $ terraform import google_compute_health_check.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_http_health_check.html.markdown b/website/docs/r/compute_http_health_check.html.markdown
@@ -148,3 +148,6 @@ $ terraform import google_compute_http_health_check.default projects/{{project}}
 $ terraform import google_compute_http_health_check.default {{project}}/{{name}}
 $ terraform import google_compute_http_health_check.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_https_health_check.html.markdown b/website/docs/r/compute_https_health_check.html.markdown
@@ -148,3 +148,6 @@ $ terraform import google_compute_https_health_check.default projects/{{project}
 $ terraform import google_compute_https_health_check.default {{project}}/{{name}}
 $ terraform import google_compute_https_health_check.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_interconnect_attachment.html.markdown b/website/docs/r/compute_interconnect_attachment.html.markdown
@@ -131,3 +131,6 @@ $ terraform import google_compute_interconnect_attachment.default projects/{{pro
 $ terraform import google_compute_interconnect_attachment.default {{project}}/{{region}}/{{name}}
 $ terraform import google_compute_interconnect_attachment.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_region_autoscaler.html.markdown b/website/docs/r/compute_region_autoscaler.html.markdown
@@ -298,3 +298,6 @@ $ terraform import google_compute_region_autoscaler.default {{region}}/{{name}}
 $ terraform import google_compute_region_autoscaler.default {{project}}/{{region}}/{{name}}
 $ terraform import google_compute_region_autoscaler.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_region_disk.html.markdown b/website/docs/r/compute_region_disk.html.markdown
@@ -244,3 +244,6 @@ $ terraform import google_compute_region_disk.default projects/{{project}}/regio
 $ terraform import google_compute_region_disk.default {{project}}/{{region}}/{{name}}
 $ terraform import google_compute_region_disk.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_route.html.markdown b/website/docs/r/compute_route.html.markdown
@@ -179,3 +179,6 @@ $ terraform import google_compute_route.default projects/{{project}}/global/rout
 $ terraform import google_compute_route.default {{project}}/{{name}}
 $ terraform import google_compute_route.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_router.html.markdown b/website/docs/r/compute_router.html.markdown
@@ -170,3 +170,6 @@ $ terraform import google_compute_router.default {{region}}/{{name}}
 $ terraform import google_compute_router.default {{project}}/{{region}}/{{name}}
 $ terraform import google_compute_router.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_snapshot.html.markdown b/website/docs/r/compute_snapshot.html.markdown
@@ -189,3 +189,6 @@ $ terraform import google_compute_snapshot.default projects/{{project}}/global/s
 $ terraform import google_compute_snapshot.default {{project}}/{{name}}
 $ terraform import google_compute_snapshot.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_ssl_certificate.html.markdown b/website/docs/r/compute_ssl_certificate.html.markdown
@@ -228,3 +228,6 @@ $ terraform import google_compute_ssl_certificate.default projects/{{project}}/g
 $ terraform import google_compute_ssl_certificate.default {{project}}/{{name}}
 $ terraform import google_compute_ssl_certificate.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_ssl_policy.html.markdown b/website/docs/r/compute_ssl_policy.html.markdown
@@ -151,3 +151,6 @@ $ terraform import google_compute_ssl_policy.default projects/{{project}}/global
 $ terraform import google_compute_ssl_policy.default {{project}}/{{name}}
 $ terraform import google_compute_ssl_policy.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_subnetwork.html.markdown b/website/docs/r/compute_subnetwork.html.markdown
@@ -192,3 +192,6 @@ $ terraform import google_compute_subnetwork.default {{region}}/{{name}}
 $ terraform import google_compute_subnetwork.default {{project}}/{{region}}/{{name}}
 $ terraform import google_compute_subnetwork.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_target_http_proxy.html.markdown b/website/docs/r/compute_target_http_proxy.html.markdown
@@ -145,3 +145,6 @@ $ terraform import google_compute_target_http_proxy.default projects/{{project}}
 $ terraform import google_compute_target_http_proxy.default {{project}}/{{name}}
 $ terraform import google_compute_target_http_proxy.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_target_https_proxy.html.markdown b/website/docs/r/compute_target_https_proxy.html.markdown
@@ -175,3 +175,6 @@ $ terraform import google_compute_target_https_proxy.default projects/{{project}
 $ terraform import google_compute_target_https_proxy.default {{project}}/{{name}}
 $ terraform import google_compute_target_https_proxy.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_target_ssl_proxy.html.markdown b/website/docs/r/compute_target_ssl_proxy.html.markdown
@@ -149,3 +149,6 @@ $ terraform import google_compute_target_ssl_proxy.default projects/{{project}}/
 $ terraform import google_compute_target_ssl_proxy.default {{project}}/{{name}}
 $ terraform import google_compute_target_ssl_proxy.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_target_tcp_proxy.html.markdown b/website/docs/r/compute_target_tcp_proxy.html.markdown
@@ -133,3 +133,6 @@ $ terraform import google_compute_target_tcp_proxy.default projects/{{project}}/
 $ terraform import google_compute_target_tcp_proxy.default {{project}}/{{name}}
 $ terraform import google_compute_target_tcp_proxy.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_url_map.html.markdown b/website/docs/r/compute_url_map.html.markdown
@@ -260,3 +260,6 @@ $ terraform import google_compute_url_map.default projects/{{project}}/global/ur
 $ terraform import google_compute_url_map.default {{project}}/{{name}}
 $ terraform import google_compute_url_map.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_vpn_gateway.html.markdown b/website/docs/r/compute_vpn_gateway.html.markdown
@@ -159,3 +159,6 @@ $ terraform import google_compute_vpn_gateway.default projects/{{project}}/regio
 $ terraform import google_compute_vpn_gateway.default {{project}}/{{region}}/{{name}}
 $ terraform import google_compute_vpn_gateway.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/compute_vpn_tunnel.html.markdown b/website/docs/r/compute_vpn_tunnel.html.markdown
@@ -214,3 +214,6 @@ $ terraform import google_compute_vpn_tunnel.default projects/{{project}}/region
 $ terraform import google_compute_vpn_tunnel.default {{project}}/{{region}}/{{name}}
 $ terraform import google_compute_vpn_tunnel.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/containeranalysis_note.html.markdown b/website/docs/r/containeranalysis_note.html.markdown
@@ -115,7 +115,10 @@ This resource provides the following
 Note can be imported using any of these accepted formats:
 
 ```
-$ terraform import google_container_analysis_note.default projects/{{project}}/notes/{{name}}
-$ terraform import google_container_analysis_note.default {{project}}/{{name}}
-$ terraform import google_container_analysis_note.default {{name}}
+$ terraform import -provider=google-beta google_container_analysis_note.default projects/{{project}}/notes/{{name}}
+$ terraform import -provider=google-beta google_container_analysis_note.default {{project}}/{{name}}
+$ terraform import -provider=google-beta google_container_analysis_note.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/dns_managed_zone.html.markdown b/website/docs/r/dns_managed_zone.html.markdown
@@ -113,3 +113,6 @@ $ terraform import google_dns_managed_zone.default projects/{{project}}/managedZ
 $ terraform import google_dns_managed_zone.default {{project}}/{{name}}
 $ terraform import google_dns_managed_zone.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/filestore_instance.html.markdown b/website/docs/r/filestore_instance.html.markdown
@@ -159,7 +159,10 @@ This resource provides the following
 Instance can be imported using any of these accepted formats:
 
 ```
-$ terraform import google_filestore_instance.default projects/{{project}}/locations/{{zone}}/instances/{{name}}
-$ terraform import google_filestore_instance.default {{project}}/{{zone}}/{{name}}
-$ terraform import google_filestore_instance.default {{name}}
+$ terraform import -provider=google-beta google_filestore_instance.default projects/{{project}}/locations/{{zone}}/instances/{{name}}
+$ terraform import -provider=google-beta google_filestore_instance.default {{project}}/{{zone}}/{{name}}
+$ terraform import -provider=google-beta google_filestore_instance.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/monitoring_alert_policy.html.markdown b/website/docs/r/monitoring_alert_policy.html.markdown
@@ -650,3 +650,6 @@ AlertPolicy can be imported using any of these accepted formats:
 ```
 $ terraform import google_monitoring_alert_policy.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/monitoring_group.html.markdown b/website/docs/r/monitoring_group.html.markdown
@@ -129,3 +129,6 @@ Group can be imported using any of these accepted formats:
 ```
 $ terraform import google_monitoring_group.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/monitoring_notification_channel.html.markdown b/website/docs/r/monitoring_notification_channel.html.markdown
@@ -118,3 +118,6 @@ NotificationChannel can be imported using any of these accepted formats:
 ```
 $ terraform import google_monitoring_notification_channel.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/monitoring_uptime_check_config.html.markdown b/website/docs/r/monitoring_uptime_check_config.html.markdown
@@ -263,3 +263,6 @@ UptimeCheckConfig can be imported using any of these accepted formats:
 ```
 $ terraform import google_monitoring_uptime_check_config.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/redis_instance.html.markdown b/website/docs/r/redis_instance.html.markdown
@@ -200,3 +200,6 @@ $ terraform import google_redis_instance.default projects/{{project}}/locations/
 $ terraform import google_redis_instance.default {{project}}/{{region}}/{{name}}
 $ terraform import google_redis_instance.default {{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/resourcemanager_lien.html.markdown b/website/docs/r/resourcemanager_lien.html.markdown
@@ -105,3 +105,6 @@ Lien can be imported using any of these accepted formats:
 ```
 $ terraform import google_resource_manager_lien.default {{parent}}/{{name}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/storage_default_object_access_control.html.markdown b/website/docs/r/storage_default_object_access_control.html.markdown
@@ -145,3 +145,6 @@ DefaultObjectAccessControl can be imported using any of these accepted formats:
 ```
 $ terraform import google_storage_default_object_access_control.default {{bucket}}/{{entity}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
diff --git a/website/docs/r/storage_object_access_control.html.markdown b/website/docs/r/storage_object_access_control.html.markdown
@@ -150,3 +150,6 @@ ObjectAccessControl can be imported using any of these accepted formats:
 ```
 $ terraform import google_storage_object_access_control.default {{bucket}}/{{object}}/{{entity}}
 ```
+
+-> If you're importing a resource with beta features, make sure to include `provider=google-beta"
+as an argument so that Terraform uses the correct provider to import your resource.
