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.