Skip to content

Latest commit

 

History

History
66 lines (52 loc) · 2.74 KB

route53_zone.html.markdown

File metadata and controls

66 lines (52 loc) · 2.74 KB
Raw
subcategory layout page_title description
Route 53
aws
AWS: aws_route53_zone
Provides details about a specific Route 53 Hosted Zone

Data Source: aws_route53_zone

aws_route53_zone provides details about a specific Route 53 Hosted Zone.

This data source allows to find a Hosted Zone ID given Hosted Zone name and certain search criteria.

Example Usage

The following example shows how to get a Hosted Zone from its name and from this data how to create a Record Set.

data "aws_route53_zone" "selected" {
  name         = "test.com."
  private_zone = true
}

resource "aws_route53_record" "www" {
  zone_id = data.aws_route53_zone.selected.zone_id
  name    = "www.${data.aws_route53_zone.selected.name}"
  type    = "A"
  ttl     = "300"
  records = ["10.0.0.1"]
}

Argument Reference

The arguments of this data source act as filters for querying the available Hosted Zone. You have to use zone_id or name, not both of them. The given filter must match exactly one Hosted Zone. If you use name field for private Hosted Zone, you need to add private_zone field to true.

  • zone_id - (Optional) Hosted Zone id of the desired Hosted Zone.
  • name - (Optional) Hosted Zone name of the desired Hosted Zone.
  • private_zone - (Optional) Used with name field to get a private Hosted Zone.
  • vpc_id - (Optional) Used with name field to get a private Hosted Zone associated with the vpc_id (in this case, private_zone is not mandatory).
  • tags - (Optional) Used with name field. A map of tags, each pair of which must exactly match a pair on the desired Hosted Zone.

Attribute Reference

All of the argument attributes are also exported as result attributes. This data source will complete the data by populating any fields that are not included in the configuration with the data for the selected Hosted Zone.

The following attribute is additionally exported:

  • arn - ARN of the Hosted Zone.
  • caller_reference - Caller Reference of the Hosted Zone.
  • comment - Comment field of the Hosted Zone.
  • linked_service_principal - The service that created the Hosted Zone (e.g., servicediscovery.amazonaws.com).
  • linked_service_description - The description provided by the service that created the Hosted Zone (e.g., arn:aws:servicediscovery:us-east-1:1234567890:namespace/ns-xxxxxxxxxxxxxxxx).
  • name - The Hosted Zone name.
  • name_servers - List of DNS name servers for the Hosted Zone.
  • primary_name_server - The Route 53 name server that created the SOA record.
  • private_zone - Indicates whether this is a private hosted zone.
  • resource_record_set_count - The number of Record Set in the Hosted Zone.
  • tags - A map of tags assigned to the Hosted Zone.
  • zone_id - The Hosted Zone identifier.