Skip to content

Data Source: azurermDnsSoaRecord

Use this data source to access information about an existing DNS SOA Record within Azure DNS.

\~> Note: The Azure DNS API has a throttle limit of 500 read (GET) operations per 5 minutes - whilst the default read timeouts will work for most cases - in larger configurations you may need to set a larger read timeout then the default 5min. Although, we'd generally recommend that you split the resources out into smaller Terraform configurations to avoid the problem entirely.

Example Usage

import * as cdktf from "cdktf";
/*Provider bindings are generated by running cdktf get.
See https://cdk.tf/provider-generation for more details.*/
import * as azurerm from "./.gen/providers/azurerm";
/*The following providers are missing schema information and might need manual adjustments to synthesize correctly: azurerm.
For a more precise conversion please use the --provider flag in convert.*/
new cdktf.TerraformOutput(this, "dns_soa_record_id", {
  value: "${data.azurerm_dns_soa_record.example.id}",
});
new azurerm.dnsSoaRecord.DnsSoaRecord(this, "example", {
  resource_group_name: "test-rg",
  zone_name: "test-zone",
});

Argument Reference

  • resourceGroupName - Specifies the resource group where the DNS Zone (parent resource) exists.

  • zoneName - Specifies the DNS Zone where the resource exists.

Attributes Reference

  • id - The DNS SOA Record ID.

  • name - The name of the DNS SOA Record.

  • fqdn - The FQDN of the DNS SOA Record.

  • ttl - The Time To Live (TTL) of the DNS record in seconds.

  • email - The email contact for the SOA record.

  • hostName - The domain name of the authoritative name server for the SOA record.

  • expireTime - The expire time for the SOA record.

  • minimumTtl - The minimum Time To Live for the SOA record. By convention, it is used to determine the negative caching duration.

  • refreshTime - The refresh time for the SOA record.

  • retryTime - The retry time for the SOA record.

  • serialNumber - The serial number for the SOA record.

  • tags - A mapping of tags assigned to the resource.

Timeouts

The timeouts block allows you to specify timeouts for certain actions:

  • read - (Defaults to 5 minutes) Used when retrieving the DNS SOA Record.