Skip to content

DNS CNAME Records»

Terraform KopiCloud_AD_API

Manage Microsoft DNS CNAME Records in AD DNS using the KopiCloud AD Terraform Provider:

Resources»

Create a DNS CNAME Record»

Create a DNS CNAME Record for a Computer:

1
2
3
4
5
resource "kopicloud_dns_cname_record" "test_cname" {
  hostname       = "tftestcn01"
  hostname_alias = "tftestcn01_alias"
  zone_name      = "kopicloud.local"
}

Output the created DNS CNAME Record:

1
2
3
4
output "dns_cname_record" {
  description = "Created DNS CNAME Record"
  value       = resource.kopicloud_dns_cname_record.test_cname
}

Schema

Optional:

  • hostname (String) Computer Hostname
  • hostname_alias (String) Computer Hostname Alias
  • zone_name (String) DNS Zone Name

Read-Only:

  • id (String) The ID of this Resource
  • result (List of Objects) Single DNS AAAA Record (see below for nested schema)

Data Sources»

List DNS CNAME Records»

List All DNS CNAME Records:

1
data "kopicloud_dns_cname_records_list" "test_cname_all" {}

Returns All DNS CNAME Records:

1
2
3
4
output "OUTPUT_dns_cname_records_list_all" {
  description = "List ALL existing DNS CNAME records"
  value       = data.kopicloud_dns_cname_records_list.test_cname_all
}

Filter DNS CNAME Records with the Zone Name:

1
2
3
data "kopicloud_dns_cname_records_list" "test_cname_zone_name" {
  zone_name = "kopicloud.local"
}

Returns all DNS CNAME Records that matches the Zone Name:

1
2
3
4
output "OUTPUT_dns_cname_records_list_zone_name" {
  description = "List existing DNS CNAME records in a Zone"
  value       = data.kopicloud_dns_cname_records_list.test_cname_zone_name
}

Filter DNS CNAME Records with an Alias:

1
2
3
data "kopicloud_dns_cname_records_list" "test_cname_alias" {
  hostname_alias = "computer70_alias"
}

Returns all DNS CNAME Records that matches the Alias:

1
2
3
4
output "OUTPUT_dns_cname_records_list_ip_address" {
  description = "List existing DNS CNAME Records with the Alias"
  value       = data.kopicloud_dns_cname_records_list.test_cname_alias
}

Filter the DNS CNAME Records with a Hostname:

1
2
3
data "kopicloud_dns_cname_records_list" "test_cname_hostname" {
  hostname = "computer33"
}

Returns all DNS CNAME Records that matches the Hostname:

1
2
3
4
output "OUTPUT_dns_cname_records_list_hostname" {
  description = "List Existing DNS CNAME Records"
  value       = data.kopicloud_dns_cname_records_list.test_cname_hostname
}

Schema

Optional:

  • hostname (String) Computer Hostname
  • hostname_alias (String) Computer Hostname Alias
  • zone_name (String) DNS Zone Name

Read-Only:

  • id (String) The ID of this Resource
  • result (List of Objects) Single DNS AAAA Record (see below for nested schema)

Nested Schema for Result»

Read-Only:

  • data (String) DNS Hostname Alias
  • name (String) DNS Name
  • timestamp (String) Timestamp of the Record
  • type (String) DNS Type
  • zone (String) DNS Zone Name

Notes»

Running this resource with terraform apply will create a DNS CNAME Record in the Microsoft DNS and running terraform destroy will remove the DNS CNAME Record from the DNS.

Source Code»

Source code available here