Initial commit

docs/resources/dns_zone.md

@@ -0,0 +1,60 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "stackit_dns_zone Resource - stackit"
+subcategory: ""
+description: |-
+  DNS Zone resource schema.
+---
+
+# stackit_dns_zone (Resource)
+
+DNS Zone resource schema.
+
+## Example Usage
+
+```terraform
+resource "stackit_dns_zone" "example" {
+  project_id    = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+  name          = "Example zone"
+  dns_name      = "www.example-zone.com"
+  contact_email = "aa@bb.ccc"
+  type          = "primary"
+  acl           = "192.168.0.0/24"
+  description   = "Example description"
+  default_ttl   = 1230
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `dns_name` (String) The zone name. E.g. `example.com`
+- `name` (String) The user given name of the zone.
+- `project_id` (String) STACKIT project ID to which the dns zone is associated.
+
+### Optional
+
+- `acl` (String) The access control list. E.g. `0.0.0.0/0,::/0`
+- `active` (Boolean)
+- `contact_email` (String) A contact e-mail for the zone.
+- `default_ttl` (Number) Default time to live. E.g. 3600.
+- `description` (String) Description of the zone.
+- `expire_time` (Number) Expire time. E.g. 1209600.
+- `is_reverse_zone` (Boolean) Specifies, if the zone is a reverse zone or not.
+- `negative_cache` (Number) Negative caching. E.g. 60
+- `primaries` (List of String) Primary name server for secondary zone. E.g. ["1.2.3.4"]
+- `refresh_time` (Number) Refresh time. E.g. 3600
+- `retry_time` (Number) Retry time. E.g. 600
+- `type` (String) Zone type. E.g. `primary`
+
+### Read-Only
+
+- `id` (String) Terraform's internal resource ID.
+- `primary_name_server` (String) Primary name server. FQDN.
+- `record_count` (Number) Record count how many records are in the zone.
+- `serial_number` (Number) Serial number. E.g. `2022111400`.
+- `state` (String) Zone state. E.g. `CREATE_SUCCEEDED`.
+- `visibility` (String) Visibility of the zone. E.g. `public`.
+- `zone_id` (String) The zone ID.