Skip to content

DNS A Records»

Terraform KopiCloud_AD_API

Manage Microsoft DNS A Records using the KopiCloud AD Terraform Provider.

Resources»

Create a DNS A Record»

Create a DNS A Record for a computer

1
2
3
4
5
resource "kopicloud_dns_a_record" "test_a" {
  hostname   = "atftestvm01"
  ip_address = "100.30.1.1"
  zone_name  = "kopicloud.local"
}

Output the created DNS A Record:

1
2
3
4
output "dns_a_record" {
  description = "Created DNS A Record"
  value       = resource.kopicloud_dns_a_record.test_a
}

Output the Hostname of the created DNS A Record:

1
2
3
4
output "dns_a_record_hostname" {
  description = "Hostname of Created DNS A Record"
  value       = resource.kopicloud_dns_a_record.test_a.hostname
}

Schema

Optional:

  • hostname (String) Computer Hostname
  • ip_address (String) IPv4 Address
  • 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 A Records»

List All DNS A Records:

1
data "kopicloud_dns_a_records_list" "test_a_all" {}

Returns All DNS A Records:

1
2
3
4
output "OUTPUT_dns_a_records_list_all" {
  description = "List Existing DNS A Records"
  value       = data.kopicloud_dns_a_records_list.test_a_all
}

Filter DNS A Records with the Zone Name:

1
2
3
data "kopicloud_dns_a_records_list" "test_a_zone_name" {
  zone_name = "kopicloud.local"
}

Returns all DNS A Records that matches the Zone Name:

1
2
3
4
output "OUTPUT_dns_a_records_list_zone_name" {
  description = "List existing DNS A Records filtered by Zone Name"
  value       = data.kopicloud_dns_a_records_list.test_a_zone_name
}

Filter DNS A Records with an IP Address:

1
2
3
data "kopicloud_dns_a_records_list" "test_a_ip" {
  ip_address = "12.12.12.12"
}

Returns all DNS A Records that matches the IP Address:

1
2
3
4
output "OUTPUT_dns_a_records_list_ip_address" {
  description = "List existing DNS A Records filtered by IP Address"
  value       = data.kopicloud_dns_a_records_list.test_a_ip
}

Filter DNS A Records with a Hostname:

1
2
3
data "kopicloud_dns_a_records_list" "test_a_hostname" {
  hostname = "computer75"
}

Returns all DNS A Records that matches the Hostname:

1
2
3
4
output "dns_a_records_list_hostname" {
  description = "List Existing DNS A Records"
  value       = data.kopicloud_dns_a_records_list.test_a_hostname
}

Returns the IP Address of the 1st DNS A Record:

1
2
3
4
output "dns_a_records_list_hostname_record_1_ip_address" {
  description = "Show the IP Address of the 1st DNS A Record"
  value       = data.kopicloud_dns_a_records_list.test_a_hostname.result.0.data
}

Schema

Optional:

  • hostname (String) Computer Hostname
  • ip_address (String) IPv4 Address
  • 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) IPv4 Address
  • name (String) Computer Hostname
  • 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 A Record in the Microsoft DNS and running terraform destroy will remove the DNS A Record from the DNS.

Source Code»

Source code available here