Skip to content

Data Source: azurermDnsARecord

Use this data source to access information about an existing DNS A 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.*/
const dataAzurermDnsARecordExample =
  new azurerm.dataAzurermDnsARecord.DataAzurermDnsARecord(this, "example", {
    name: "test",
    resource_group_name: "test-rg",
    zone_name: "test-zone",
  });
new cdktf.TerraformOutput(this, "dns_a_record_id", {
  value: dataAzurermDnsARecordExample.id,
});

Argument Reference

  • name - The name of the DNS A Record.

  • 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 A Record ID.

  • fqdn - The FQDN of the DNS A Record.

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

  • records - List of IPv4 Addresses.

  • targetResourceId - The Azure resource id of the target object from where the dns resource value is taken.

  • tags - A mapping of tags assigned to the DNS A Record.

Timeouts

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

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