> For the complete documentation index, see [llms.txt](https://docs.ionos.com/terraform-provider/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ionos.com/terraform-provider/docs/resources/dns_zone.md).

# ionoscloud\_dns\_zone

Creates and manages DNS Zone objects.

Manages a **DNS Zone**.

> ⚠️ Only tokens are accepted for authorization in the **ionoscloud\_dns\_zone** resource. Please ensure you are using tokens as other methods will not be valid.

## Example Usage

```hcl
resource "ionoscloud_dns_zone" "example" {
  name = "example.com"
  description = "description"
  enabled = false
}
```

## Argument reference

* `name` - (Required)\[string] The name of the DNS Zone. This property is immutable.
* `description` - (Optional)\[string] The description for the DNS Zone.
* `enabled` - (Optional)\[bool] Indicates if the DNS Zone is active or not. Default is `true`.

## Import

In order to import a DNS Zone, you can define an empty DNS Zone resource in the plan:

```hcl
resource "ionoscloud_dns_zone" "example" {
  
}
```

The resource can be imported using the `zone_id`, for example:

```shell
terraform import ionoscloud_dns_zone.example zone_id
```

In Terraform v1.12.0 and later, the [`import` block](https://developer.hashicorp.com/terraform/language/import) can also be used with the `identity` attribute:

```hcl
import {
  to = ionoscloud_dns_zone.example
  identity = {
    id = "zone_id"
  }
}

resource "ionoscloud_dns_zone" "example" {
  ### Configuration omitted for brevity ###
}
```

### Identity Schema

#### Required

* `id` (String) The UUID of the DNS Zone.

## Query (List Resource)

DNS Zones can be listed using `terraform query` (requires Terraform 1.14+). List blocks must be placed in a dedicated query file, whose name ends in `.tfquery.hcl` (for example `queries.tfquery.hcl`).

```hcl
list "ionoscloud_dns_zone" "all" {
  provider         = ionoscloud
  include_resource = true
}
```

See the [`ionoscloud_dns_zone` list resource documentation](/terraform-provider/docs/list-resources/dns_zone.md) for filters and the full attribute reference.