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

<!-- This change is generated by MagicModules. -->
/cc @rileykarson

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.

website/docs/r/compute_address.html.markdown

@@ -209,3 +209,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.

website/docs/r/compute_autoscaler.html.markdown

@@ -265,3 +265,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.

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.

website/docs/r/compute_disk.html.markdown

@@ -254,3 +254,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.

website/docs/r/compute_firewall.html.markdown

@@ -260,3 +260,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.

website/docs/r/compute_forwarding_rule.html.markdown

@@ -228,3 +228,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.

website/docs/r/compute_global_address.html.markdown

@@ -114,3 +114,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.

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.

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.

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.

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.

website/docs/r/compute_region_autoscaler.html.markdown

@@ -265,3 +265,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.

website/docs/r/compute_region_disk.html.markdown

@@ -236,3 +236,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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.