--- # ---------------------------------------------------------------------------- # # *** AUTO GENERATED CODE *** AUTO GENERATED CODE *** # # ---------------------------------------------------------------------------- # # This file is automatically generated by Magic Modules and manual # changes will be clobbered when the file is regenerated. # # Please read more about how to change this file in # .github/CONTRIBUTING.md. # # ---------------------------------------------------------------------------- layout: "google" page_title: "Google: google_dns_managed_zone" sidebar_current: "docs-google-dns-managed-zone" description: |- A zone is a subtree of the DNS namespace under one administrative responsibility. --- # google\_dns\_managed\_zone A zone is a subtree of the DNS namespace under one administrative responsibility. A ManagedZone is a resource that represents a DNS zone hosted by the Cloud DNS service. To get more information about ManagedZone, see: * [API documentation](https://cloud.google.com/dns/api/v1/managedZones) * How-to Guides * [Managing Zones](https://cloud.google.com/dns/zones/)
## Example Usage - Dns Managed Zone Basic ```hcl resource "google_dns_managed_zone" "example-zone" { name = "example-zone" dns_name = "example-${random_id.rnd.hex}.com." description = "Example DNS zone" labels = { foo = "bar" } } resource "random_id" "rnd" { byte_length = 4 } ``` ## Argument Reference The following arguments are supported: * `dns_name` - (Required) The DNS name of this managed zone, for instance "example.com.". * `name` - (Required) User assigned name for this resource. Must be unique within the project. - - - * `description` - (Optional) A textual description field. Defaults to 'Managed by Terraform'. * `labels` - (Optional) A set of key/value label pairs to assign to this ManagedZone. * `project` - (Optional) The ID of the project in which the resource belongs. If it is not provided, the provider project is used. ## Attributes Reference In addition to the arguments listed above, the following computed attributes are exported: * `name_servers` - Delegate your managed_zone to these virtual name servers; defined by the server ## Timeouts This resource provides the following [Timeouts](/docs/configuration/resources.html#timeouts) configuration options: - `create` - Default is 4 minutes. - `update` - Default is 4 minutes. - `delete` - Default is 4 minutes. ## Import ManagedZone can be imported using any of these accepted formats: ``` $ terraform import google_dns_managed_zone.default projects/{{project}}/managedZones/{{name}} $ 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.