Skip to content

Latest commit

 

History

History

record-set

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 

record-set

This module creates following resources.

  • aws_route53_record (optional)

Requirements

Name Version
terraform >= 1.6
aws >= 5.51

Providers

Name Version
aws 5.47.0

Modules

No modules.

Resources

Name Type
aws_route53_record.this resource
aws_route53_zone.this data source

Inputs

Name Description Type Default Required
name (Required) The name of the record. Enter a fully qualified domain name, for example, www.example.com. You can use the asterisk (*) wildcard to replace the leftmost label in a domain name, for example, *.example.com. string n/a yes
type (Required) The DNS record type. Valid values are A, AAAA, CAA, CNAME, DS, MX, NAPTR, NS, PTR, SOA, SPF, SRV and TXT. string n/a yes
zone (Required) The ID of the hosted zone to contain this record set. string n/a yes
overwrite (Optional) Whether to allow creation of this record in Terraform to overwrite an existing record, if any. This does not affect the ability to update the record in Terraform and does not prevent other resources within Terraform or manual Route 53 changes outside Terraform from overwriting this record. This configuration is not recommended for most environments. Defaults to false. bool false no
records (Optional) A list of records for the record set. Each item of records as defined below.
(Optional) id - A unique ID to differentiate this record from other records with the same domain name and type. Not required if the routing_policy is SIMPLE. Defaults to default.
(Optional) value - A configuration for non-alias record with a list of the record values. You can specify more than one value for all record types except CNAME and SOA. Conflicts with alias.
(Optional) alias - A configuration for alias record. Conflicts with value. alias as defined below.
(Required) name - DNS domain name for a CloudFront distribution, S3 bucket, ELB, or another record set in this hosted zone.
(Required) zone - Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone.
(Optional) evaluate_target_health - Whether to respond to DNS queries using this record by checking the health of the alias target. Some resources have special requirements, see related part of documentation. Defaults to true.
list(object({
id = optional(string, "default")
value = optional(list(string))
alias = optional(object({
name = string
zone = string
evaluate_target_health = optional(bool, true)
}))
}))
[] no
routing_policy (Optional) The routing policy determines how Route 53 responds to queries. Defaults to SIMPLE. Supported routing policies are following:
SIMPLE
WEIGHTED
GEOLOCATION
LATENCY
FAILOVER
MULTIVALUE_ANSWER
CIDR
GEOPROXIMITY
string "SIMPLE" no
ttl (Optional) The record cache time to live (TTL) in seconds. Defaults to 300.
- If you're creating or updating an alias record set, omit ttl. Route 53 uses the value of TTL for the alias target.
- If you're associating this record set with a health check, we recommend that you specify a ttl of 60 seconds or less so clients respond quickly to changes in health status.
- All of the records in a group of weighted record sets must have the same value for ttl.
- If a group of weighted record sets includes one or more weighted alias records for which the alias target is an ELB load balancer, we recommend that you specify a ttl of 60 seconds for all of the non-alias weighted records that have the same name and type. Values other than 60 seconds (the TTL for load balancers) will change the effect of the values that you specify for weight.
number 300 no

Outputs

Name Description
fqdn The FQDN (Fully-qualified Domain Name) of the record.
name The name of the record.
records A list of records for the record set. Each item of records as defined below.
id - A unique ID to differentiate this record from other records with the same domain name and type.
value - A configuration for non-alias record with a list of the record values.
alias - A configuration for alias record. Conflicts with value. alias as defined below.
name - DNS domain name for a CloudFront distribution, S3 bucket, ELB, or another record set in this hosted zone.
zone - Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone.
evaluate_target_health - Whether to respond to DNS queries using this record by checking the health of the alias target.
routing_policy The routing policy of the record set.
ttl The record cache time to live (TTL) in seconds.
type The DNS record type of the record set.
zone The information for Hosted Zone of the record set.