published on Tuesday, Mar 10, 2026 by Pulumi
published on Tuesday, Mar 10, 2026 by Pulumi
Provides a Route53 record resource.
Example Usage
Simple routing policy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var www = new Aws.Route53.Record("www", new()
{
ZoneId = aws_route53_zone.Primary.Zone_id,
Name = "www.example.com",
Type = "A",
Ttl = 300,
Records = new[]
{
aws_eip.Lb.Public_ip,
},
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/route53"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := route53.NewRecord(ctx, "www", &route53.RecordArgs{
ZoneId: pulumi.Any(aws_route53_zone.Primary.Zone_id),
Name: pulumi.String("www.example.com"),
Type: pulumi.String("A"),
Ttl: pulumi.Int(300),
Records: pulumi.StringArray{
aws_eip.Lb.Public_ip,
},
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.route53.Record;
import com.pulumi.aws.route53.RecordArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var www = new Record("www", RecordArgs.builder()
.zoneId(aws_route53_zone.primary().zone_id())
.name("www.example.com")
.type("A")
.ttl(300)
.records(aws_eip.lb().public_ip())
.build());
}
}
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const www = new aws.route53.Record("www", {
zoneId: aws_route53_zone.primary.zone_id,
name: "www.example.com",
type: "A",
ttl: 300,
records: [aws_eip.lb.public_ip],
});
import pulumi
import pulumi_aws as aws
www = aws.route53.Record("www",
zone_id=aws_route53_zone["primary"]["zone_id"],
name="www.example.com",
type="A",
ttl=300,
records=[aws_eip["lb"]["public_ip"]])
resources:
www:
type: aws:route53:Record
properties:
zoneId: ${aws_route53_zone.primary.zone_id}
name: www.example.com
type: A
ttl: 300
records:
- ${aws_eip.lb.public_ip}
Weighted routing policy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var www_dev = new Aws.Route53.Record("www-dev", new()
{
ZoneId = aws_route53_zone.Primary.Zone_id,
Name = "www",
Type = "CNAME",
Ttl = 5,
WeightedRoutingPolicies = new[]
{
new Aws.Route53.Inputs.RecordWeightedRoutingPolicyArgs
{
Weight = 10,
},
},
SetIdentifier = "dev",
Records = new[]
{
"dev.example.com",
},
});
var www_live = new Aws.Route53.Record("www-live", new()
{
ZoneId = aws_route53_zone.Primary.Zone_id,
Name = "www",
Type = "CNAME",
Ttl = 5,
WeightedRoutingPolicies = new[]
{
new Aws.Route53.Inputs.RecordWeightedRoutingPolicyArgs
{
Weight = 90,
},
},
SetIdentifier = "live",
Records = new[]
{
"live.example.com",
},
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/route53"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := route53.NewRecord(ctx, "www-dev", &route53.RecordArgs{
ZoneId: pulumi.Any(aws_route53_zone.Primary.Zone_id),
Name: pulumi.String("www"),
Type: pulumi.String("CNAME"),
Ttl: pulumi.Int(5),
WeightedRoutingPolicies: route53.RecordWeightedRoutingPolicyArray{
&route53.RecordWeightedRoutingPolicyArgs{
Weight: pulumi.Int(10),
},
},
SetIdentifier: pulumi.String("dev"),
Records: pulumi.StringArray{
pulumi.String("dev.example.com"),
},
})
if err != nil {
return err
}
_, err = route53.NewRecord(ctx, "www-live", &route53.RecordArgs{
ZoneId: pulumi.Any(aws_route53_zone.Primary.Zone_id),
Name: pulumi.String("www"),
Type: pulumi.String("CNAME"),
Ttl: pulumi.Int(5),
WeightedRoutingPolicies: route53.RecordWeightedRoutingPolicyArray{
&route53.RecordWeightedRoutingPolicyArgs{
Weight: pulumi.Int(90),
},
},
SetIdentifier: pulumi.String("live"),
Records: pulumi.StringArray{
pulumi.String("live.example.com"),
},
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.route53.Record;
import com.pulumi.aws.route53.RecordArgs;
import com.pulumi.aws.route53.inputs.RecordWeightedRoutingPolicyArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var www_dev = new Record("www-dev", RecordArgs.builder()
.zoneId(aws_route53_zone.primary().zone_id())
.name("www")
.type("CNAME")
.ttl(5)
.weightedRoutingPolicies(RecordWeightedRoutingPolicyArgs.builder()
.weight(10)
.build())
.setIdentifier("dev")
.records("dev.example.com")
.build());
var www_live = new Record("www-live", RecordArgs.builder()
.zoneId(aws_route53_zone.primary().zone_id())
.name("www")
.type("CNAME")
.ttl(5)
.weightedRoutingPolicies(RecordWeightedRoutingPolicyArgs.builder()
.weight(90)
.build())
.setIdentifier("live")
.records("live.example.com")
.build());
}
}
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const www_dev = new aws.route53.Record("www-dev", {
zoneId: aws_route53_zone.primary.zone_id,
name: "www",
type: "CNAME",
ttl: 5,
weightedRoutingPolicies: [{
weight: 10,
}],
setIdentifier: "dev",
records: ["dev.example.com"],
});
const www_live = new aws.route53.Record("www-live", {
zoneId: aws_route53_zone.primary.zone_id,
name: "www",
type: "CNAME",
ttl: 5,
weightedRoutingPolicies: [{
weight: 90,
}],
setIdentifier: "live",
records: ["live.example.com"],
});
import pulumi
import pulumi_aws as aws
www_dev = aws.route53.Record("www-dev",
zone_id=aws_route53_zone["primary"]["zone_id"],
name="www",
type="CNAME",
ttl=5,
weighted_routing_policies=[aws.route53.RecordWeightedRoutingPolicyArgs(
weight=10,
)],
set_identifier="dev",
records=["dev.example.com"])
www_live = aws.route53.Record("www-live",
zone_id=aws_route53_zone["primary"]["zone_id"],
name="www",
type="CNAME",
ttl=5,
weighted_routing_policies=[aws.route53.RecordWeightedRoutingPolicyArgs(
weight=90,
)],
set_identifier="live",
records=["live.example.com"])
resources:
www-dev:
type: aws:route53:Record
properties:
zoneId: ${aws_route53_zone.primary.zone_id}
name: www
type: CNAME
ttl: 5
weightedRoutingPolicies:
- weight: 10
setIdentifier: dev
records:
- dev.example.com
www-live:
type: aws:route53:Record
properties:
zoneId: ${aws_route53_zone.primary.zone_id}
name: www
type: CNAME
ttl: 5
weightedRoutingPolicies:
- weight: 90
setIdentifier: live
records:
- live.example.com
Alias record
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var main = new Aws.Elb.LoadBalancer("main", new()
{
AvailabilityZones = new[]
{
"us-east-1c",
},
Listeners = new[]
{
new Aws.Elb.Inputs.LoadBalancerListenerArgs
{
InstancePort = 80,
InstanceProtocol = "http",
LbPort = 80,
LbProtocol = "http",
},
},
});
var www = new Aws.Route53.Record("www", new()
{
ZoneId = aws_route53_zone.Primary.Zone_id,
Name = "example.com",
Type = "A",
Aliases = new[]
{
new Aws.Route53.Inputs.RecordAliasArgs
{
Name = main.DnsName,
ZoneId = main.ZoneId,
EvaluateTargetHealth = true,
},
},
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/elb"
"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/route53"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
main, err := elb.NewLoadBalancer(ctx, "main", &elb.LoadBalancerArgs{
AvailabilityZones: pulumi.StringArray{
pulumi.String("us-east-1c"),
},
Listeners: elb.LoadBalancerListenerArray{
&elb.LoadBalancerListenerArgs{
InstancePort: pulumi.Int(80),
InstanceProtocol: pulumi.String("http"),
LbPort: pulumi.Int(80),
LbProtocol: pulumi.String("http"),
},
},
})
if err != nil {
return err
}
_, err = route53.NewRecord(ctx, "www", &route53.RecordArgs{
ZoneId: pulumi.Any(aws_route53_zone.Primary.Zone_id),
Name: pulumi.String("example.com"),
Type: pulumi.String("A"),
Aliases: route53.RecordAliasArray{
&route53.RecordAliasArgs{
Name: main.DnsName,
ZoneId: main.ZoneId,
EvaluateTargetHealth: pulumi.Bool(true),
},
},
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.elb.LoadBalancer;
import com.pulumi.aws.elb.LoadBalancerArgs;
import com.pulumi.aws.elb.inputs.LoadBalancerListenerArgs;
import com.pulumi.aws.route53.Record;
import com.pulumi.aws.route53.RecordArgs;
import com.pulumi.aws.route53.inputs.RecordAliasArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var main = new LoadBalancer("main", LoadBalancerArgs.builder()
.availabilityZones("us-east-1c")
.listeners(LoadBalancerListenerArgs.builder()
.instancePort(80)
.instanceProtocol("http")
.lbPort(80)
.lbProtocol("http")
.build())
.build());
var www = new Record("www", RecordArgs.builder()
.zoneId(aws_route53_zone.primary().zone_id())
.name("example.com")
.type("A")
.aliases(RecordAliasArgs.builder()
.name(main.dnsName())
.zoneId(main.zoneId())
.evaluateTargetHealth(true)
.build())
.build());
}
}
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const main = new aws.elb.LoadBalancer("main", {
availabilityZones: ["us-east-1c"],
listeners: [{
instancePort: 80,
instanceProtocol: "http",
lbPort: 80,
lbProtocol: "http",
}],
});
const www = new aws.route53.Record("www", {
zoneId: aws_route53_zone.primary.zone_id,
name: "example.com",
type: "A",
aliases: [{
name: main.dnsName,
zoneId: main.zoneId,
evaluateTargetHealth: true,
}],
});
import pulumi
import pulumi_aws as aws
main = aws.elb.LoadBalancer("main",
availability_zones=["us-east-1c"],
listeners=[aws.elb.LoadBalancerListenerArgs(
instance_port=80,
instance_protocol="http",
lb_port=80,
lb_protocol="http",
)])
www = aws.route53.Record("www",
zone_id=aws_route53_zone["primary"]["zone_id"],
name="example.com",
type="A",
aliases=[aws.route53.RecordAliasArgs(
name=main.dns_name,
zone_id=main.zone_id,
evaluate_target_health=True,
)])
resources:
main:
type: aws:elb:LoadBalancer
properties:
availabilityZones:
- us-east-1c
listeners:
- instancePort: 80
instanceProtocol: http
lbPort: 80
lbProtocol: http
www:
type: aws:route53:Record
properties:
zoneId: ${aws_route53_zone.primary.zone_id}
name: example.com
type: A
aliases:
- name: ${main.dnsName}
zoneId: ${main.zoneId}
evaluateTargetHealth: true
NS and SOA Record Management
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var exampleZone = new Aws.Route53.Zone("exampleZone");
var exampleRecord = new Aws.Route53.Record("exampleRecord", new()
{
AllowOverwrite = true,
Name = "test.example.com",
Ttl = 172800,
Type = "NS",
ZoneId = exampleZone.ZoneId,
Records = new[]
{
exampleZone.NameServers.Apply(nameServers => nameServers[0]),
exampleZone.NameServers.Apply(nameServers => nameServers[1]),
exampleZone.NameServers.Apply(nameServers => nameServers[2]),
exampleZone.NameServers.Apply(nameServers => nameServers[3]),
},
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/route53"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
exampleZone, err := route53.NewZone(ctx, "exampleZone", nil)
if err != nil {
return err
}
_, err = route53.NewRecord(ctx, "exampleRecord", &route53.RecordArgs{
AllowOverwrite: pulumi.Bool(true),
Name: pulumi.String("test.example.com"),
Ttl: pulumi.Int(172800),
Type: pulumi.String("NS"),
ZoneId: exampleZone.ZoneId,
Records: pulumi.StringArray{
exampleZone.NameServers.ApplyT(func(nameServers []string) (string, error) {
return nameServers[0], nil
}).(pulumi.StringOutput),
exampleZone.NameServers.ApplyT(func(nameServers []string) (string, error) {
return nameServers[1], nil
}).(pulumi.StringOutput),
exampleZone.NameServers.ApplyT(func(nameServers []string) (string, error) {
return nameServers[2], nil
}).(pulumi.StringOutput),
exampleZone.NameServers.ApplyT(func(nameServers []string) (string, error) {
return nameServers[3], nil
}).(pulumi.StringOutput),
},
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.route53.Zone;
import com.pulumi.aws.route53.Record;
import com.pulumi.aws.route53.RecordArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var exampleZone = new Zone("exampleZone");
var exampleRecord = new Record("exampleRecord", RecordArgs.builder()
.allowOverwrite(true)
.name("test.example.com")
.ttl(172800)
.type("NS")
.zoneId(exampleZone.zoneId())
.records(
exampleZone.nameServers().applyValue(nameServers -> nameServers[0]),
exampleZone.nameServers().applyValue(nameServers -> nameServers[1]),
exampleZone.nameServers().applyValue(nameServers -> nameServers[2]),
exampleZone.nameServers().applyValue(nameServers -> nameServers[3]))
.build());
}
}
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const exampleZone = new aws.route53.Zone("exampleZone", {});
const exampleRecord = new aws.route53.Record("exampleRecord", {
allowOverwrite: true,
name: "test.example.com",
ttl: 172800,
type: "NS",
zoneId: exampleZone.zoneId,
records: [
exampleZone.nameServers[0],
exampleZone.nameServers[1],
exampleZone.nameServers[2],
exampleZone.nameServers[3],
],
});
import pulumi
import pulumi_aws as aws
example_zone = aws.route53.Zone("exampleZone")
example_record = aws.route53.Record("exampleRecord",
allow_overwrite=True,
name="test.example.com",
ttl=172800,
type="NS",
zone_id=example_zone.zone_id,
records=[
example_zone.name_servers[0],
example_zone.name_servers[1],
example_zone.name_servers[2],
example_zone.name_servers[3],
])
resources:
exampleZone:
type: aws:route53:Zone
exampleRecord:
type: aws:route53:Record
properties:
allowOverwrite: true
name: test.example.com
ttl: 172800
type: NS
zoneId: ${exampleZone.zoneId}
records:
- ${exampleZone.nameServers[0]}
- ${exampleZone.nameServers[1]}
- ${exampleZone.nameServers[2]}
- ${exampleZone.nameServers[3]}
Create Record Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Record(name: string, args: RecordArgs, opts?: CustomResourceOptions);@overload
def Record(resource_name: str,
args: RecordArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Record(resource_name: str,
opts: Optional[ResourceOptions] = None,
name: Optional[str] = None,
zone_id: Optional[str] = None,
type: Optional[Union[str, RecordType]] = None,
latency_routing_policies: Optional[Sequence[RecordLatencyRoutingPolicyArgs]] = None,
geolocation_routing_policies: Optional[Sequence[RecordGeolocationRoutingPolicyArgs]] = None,
health_check_id: Optional[str] = None,
aliases: Optional[Sequence[RecordAliasArgs]] = None,
multivalue_answer_routing_policy: Optional[bool] = None,
failover_routing_policies: Optional[Sequence[RecordFailoverRoutingPolicyArgs]] = None,
records: Optional[Sequence[str]] = None,
set_identifier: Optional[str] = None,
ttl: Optional[int] = None,
cidr_routing_policy: Optional[RecordCidrRoutingPolicyArgs] = None,
weighted_routing_policies: Optional[Sequence[RecordWeightedRoutingPolicyArgs]] = None,
allow_overwrite: Optional[bool] = None)func NewRecord(ctx *Context, name string, args RecordArgs, opts ...ResourceOption) (*Record, error)public Record(string name, RecordArgs args, CustomResourceOptions? opts = null)
public Record(String name, RecordArgs args)
public Record(String name, RecordArgs args, CustomResourceOptions options)
type: aws:route53:Record
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args RecordArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args RecordArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args RecordArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args RecordArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args RecordArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var recordResource = new Aws.Route53.Record("recordResource", new()
{
Name = "string",
ZoneId = "string",
Type = "string",
LatencyRoutingPolicies = new[]
{
new Aws.Route53.Inputs.RecordLatencyRoutingPolicyArgs
{
Region = "string",
},
},
GeolocationRoutingPolicies = new[]
{
new Aws.Route53.Inputs.RecordGeolocationRoutingPolicyArgs
{
Continent = "string",
Country = "string",
Subdivision = "string",
},
},
HealthCheckId = "string",
Aliases = new[]
{
new Aws.Route53.Inputs.RecordAliasArgs
{
EvaluateTargetHealth = false,
Name = "string",
ZoneId = "string",
},
},
MultivalueAnswerRoutingPolicy = false,
FailoverRoutingPolicies = new[]
{
new Aws.Route53.Inputs.RecordFailoverRoutingPolicyArgs
{
Type = "string",
},
},
Records = new[]
{
"string",
},
SetIdentifier = "string",
Ttl = 0,
CidrRoutingPolicy = new Aws.Route53.Inputs.RecordCidrRoutingPolicyArgs
{
CollectionId = "string",
LocationName = "string",
},
WeightedRoutingPolicies = new[]
{
new Aws.Route53.Inputs.RecordWeightedRoutingPolicyArgs
{
Weight = 0,
},
},
AllowOverwrite = false,
});
example, err := route53.NewRecord(ctx, "recordResource", &route53.RecordArgs{
Name: pulumi.String("string"),
ZoneId: pulumi.String("string"),
Type: pulumi.String("string"),
LatencyRoutingPolicies: route53.RecordLatencyRoutingPolicyArray{
&route53.RecordLatencyRoutingPolicyArgs{
Region: pulumi.String("string"),
},
},
GeolocationRoutingPolicies: route53.RecordGeolocationRoutingPolicyArray{
&route53.RecordGeolocationRoutingPolicyArgs{
Continent: pulumi.String("string"),
Country: pulumi.String("string"),
Subdivision: pulumi.String("string"),
},
},
HealthCheckId: pulumi.String("string"),
Aliases: route53.RecordAliasArray{
&route53.RecordAliasArgs{
EvaluateTargetHealth: pulumi.Bool(false),
Name: pulumi.String("string"),
ZoneId: pulumi.String("string"),
},
},
MultivalueAnswerRoutingPolicy: pulumi.Bool(false),
FailoverRoutingPolicies: route53.RecordFailoverRoutingPolicyArray{
&route53.RecordFailoverRoutingPolicyArgs{
Type: pulumi.String("string"),
},
},
Records: pulumi.StringArray{
pulumi.String("string"),
},
SetIdentifier: pulumi.String("string"),
Ttl: pulumi.Int(0),
CidrRoutingPolicy: &route53.RecordCidrRoutingPolicyArgs{
CollectionId: pulumi.String("string"),
LocationName: pulumi.String("string"),
},
WeightedRoutingPolicies: route53.RecordWeightedRoutingPolicyArray{
&route53.RecordWeightedRoutingPolicyArgs{
Weight: pulumi.Int(0),
},
},
AllowOverwrite: pulumi.Bool(false),
})
var recordResource = new Record("recordResource", RecordArgs.builder()
.name("string")
.zoneId("string")
.type("string")
.latencyRoutingPolicies(RecordLatencyRoutingPolicyArgs.builder()
.region("string")
.build())
.geolocationRoutingPolicies(RecordGeolocationRoutingPolicyArgs.builder()
.continent("string")
.country("string")
.subdivision("string")
.build())
.healthCheckId("string")
.aliases(RecordAliasArgs.builder()
.evaluateTargetHealth(false)
.name("string")
.zoneId("string")
.build())
.multivalueAnswerRoutingPolicy(false)
.failoverRoutingPolicies(RecordFailoverRoutingPolicyArgs.builder()
.type("string")
.build())
.records("string")
.setIdentifier("string")
.ttl(0)
.cidrRoutingPolicy(RecordCidrRoutingPolicyArgs.builder()
.collectionId("string")
.locationName("string")
.build())
.weightedRoutingPolicies(RecordWeightedRoutingPolicyArgs.builder()
.weight(0)
.build())
.allowOverwrite(false)
.build());
record_resource = aws.route53.Record("recordResource",
name="string",
zone_id="string",
type="string",
latency_routing_policies=[{
"region": "string",
}],
geolocation_routing_policies=[{
"continent": "string",
"country": "string",
"subdivision": "string",
}],
health_check_id="string",
aliases=[{
"evaluate_target_health": False,
"name": "string",
"zone_id": "string",
}],
multivalue_answer_routing_policy=False,
failover_routing_policies=[{
"type": "string",
}],
records=["string"],
set_identifier="string",
ttl=0,
cidr_routing_policy={
"collection_id": "string",
"location_name": "string",
},
weighted_routing_policies=[{
"weight": 0,
}],
allow_overwrite=False)
const recordResource = new aws.route53.Record("recordResource", {
name: "string",
zoneId: "string",
type: "string",
latencyRoutingPolicies: [{
region: "string",
}],
geolocationRoutingPolicies: [{
continent: "string",
country: "string",
subdivision: "string",
}],
healthCheckId: "string",
aliases: [{
evaluateTargetHealth: false,
name: "string",
zoneId: "string",
}],
multivalueAnswerRoutingPolicy: false,
failoverRoutingPolicies: [{
type: "string",
}],
records: ["string"],
setIdentifier: "string",
ttl: 0,
cidrRoutingPolicy: {
collectionId: "string",
locationName: "string",
},
weightedRoutingPolicies: [{
weight: 0,
}],
allowOverwrite: false,
});
type: aws:route53:Record
properties:
aliases:
- evaluateTargetHealth: false
name: string
zoneId: string
allowOverwrite: false
cidrRoutingPolicy:
collectionId: string
locationName: string
failoverRoutingPolicies:
- type: string
geolocationRoutingPolicies:
- continent: string
country: string
subdivision: string
healthCheckId: string
latencyRoutingPolicies:
- region: string
multivalueAnswerRoutingPolicy: false
name: string
records:
- string
setIdentifier: string
ttl: 0
type: string
weightedRoutingPolicies:
- weight: 0
zoneId: string
Record Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Record resource accepts the following input properties:
- Name string
- The name of the record.
- Type
string | Pulumi.
Aws. Route53. Record Type - The record type. Valid values are
A,AAAA,CAA,CNAME,DS,MX,NAPTR,NS,PTR,SOA,SPF,SRVandTXT. - Zone
Id string - The ID of the hosted zone to contain this record.
- Aliases
List<Record
Alias> - An alias block. Conflicts with
ttl&records. Documented below. - Allow
Overwrite bool Allow creation of this record to overwrite an existing record, if any. This does not affect the ability to update the record using this provider and does not prevent other resources within this provider or manual Route 53 changes outside this provider from overwriting this record.
falseby default. This configuration is not recommended for most environments.Exactly one of
recordsoraliasmust be specified: this determines whether it's an alias record.- Cidr
Routing RecordPolicy Cidr Routing Policy - A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.
- Failover
Routing List<RecordPolicies Failover Routing Policy> - A block indicating the routing behavior when associated health check fails. Conflicts with any other routing policy. Documented below.
- Geolocation
Routing List<RecordPolicies Geolocation Routing Policy> - A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.
- Health
Check stringId - The health check the record should be associated with.
- Latency
Routing List<RecordPolicies Latency Routing Policy> - A block indicating a routing policy based on the latency between the requestor and an AWS region. Conflicts with any other routing policy. Documented below.
- Multivalue
Answer boolRouting Policy - Set to
trueto indicate a multivalue answer routing policy. Conflicts with any other routing policy. - Records List<string>
- A string list of records. To specify a single record value longer than 255 characters such as a TXT record for DKIM, add
\"\"inside the provider configuration string (e.g.,"first255characters\"\"morecharacters"). - Set
Identifier string - Unique identifier to differentiate records with routing policies from one another. Required if using
cidr_routing_policy,failover_routing_policy,geolocation_routing_policy,latency_routing_policy,multivalue_answer_routing_policy, orweighted_routing_policy. - Ttl int
- The TTL of the record.
- Weighted
Routing List<RecordPolicies Weighted Routing Policy> - A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.
- Name string
- The name of the record.
- Type
string | Record
Type - The record type. Valid values are
A,AAAA,CAA,CNAME,DS,MX,NAPTR,NS,PTR,SOA,SPF,SRVandTXT. - Zone
Id string - The ID of the hosted zone to contain this record.
- Aliases
[]Record
Alias Args - An alias block. Conflicts with
ttl&records. Documented below. - Allow
Overwrite bool Allow creation of this record to overwrite an existing record, if any. This does not affect the ability to update the record using this provider and does not prevent other resources within this provider or manual Route 53 changes outside this provider from overwriting this record.
falseby default. This configuration is not recommended for most environments.Exactly one of
recordsoraliasmust be specified: this determines whether it's an alias record.- Cidr
Routing RecordPolicy Cidr Routing Policy Args - A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.
- Failover
Routing []RecordPolicies Failover Routing Policy Args - A block indicating the routing behavior when associated health check fails. Conflicts with any other routing policy. Documented below.
- Geolocation
Routing []RecordPolicies Geolocation Routing Policy Args - A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.
- Health
Check stringId - The health check the record should be associated with.
- Latency
Routing []RecordPolicies Latency Routing Policy Args - A block indicating a routing policy based on the latency between the requestor and an AWS region. Conflicts with any other routing policy. Documented below.
- Multivalue
Answer boolRouting Policy - Set to
trueto indicate a multivalue answer routing policy. Conflicts with any other routing policy. - Records []string
- A string list of records. To specify a single record value longer than 255 characters such as a TXT record for DKIM, add
\"\"inside the provider configuration string (e.g.,"first255characters\"\"morecharacters"). - Set
Identifier string - Unique identifier to differentiate records with routing policies from one another. Required if using
cidr_routing_policy,failover_routing_policy,geolocation_routing_policy,latency_routing_policy,multivalue_answer_routing_policy, orweighted_routing_policy. - Ttl int
- The TTL of the record.
- Weighted
Routing []RecordPolicies Weighted Routing Policy Args - A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.
- name String
- The name of the record.
- type
String | Record
Type - The record type. Valid values are
A,AAAA,CAA,CNAME,DS,MX,NAPTR,NS,PTR,SOA,SPF,SRVandTXT. - zone
Id String - The ID of the hosted zone to contain this record.
- aliases
List<Record
Alias> - An alias block. Conflicts with
ttl&records. Documented below. - allow
Overwrite Boolean Allow creation of this record to overwrite an existing record, if any. This does not affect the ability to update the record using this provider and does not prevent other resources within this provider or manual Route 53 changes outside this provider from overwriting this record.
falseby default. This configuration is not recommended for most environments.Exactly one of
recordsoraliasmust be specified: this determines whether it's an alias record.- cidr
Routing RecordPolicy Cidr Routing Policy - A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.
- failover
Routing List<RecordPolicies Failover Routing Policy> - A block indicating the routing behavior when associated health check fails. Conflicts with any other routing policy. Documented below.
- geolocation
Routing List<RecordPolicies Geolocation Routing Policy> - A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.
- health
Check StringId - The health check the record should be associated with.
- latency
Routing List<RecordPolicies Latency Routing Policy> - A block indicating a routing policy based on the latency between the requestor and an AWS region. Conflicts with any other routing policy. Documented below.
- multivalue
Answer BooleanRouting Policy - Set to
trueto indicate a multivalue answer routing policy. Conflicts with any other routing policy. - records List<String>
- A string list of records. To specify a single record value longer than 255 characters such as a TXT record for DKIM, add
\"\"inside the provider configuration string (e.g.,"first255characters\"\"morecharacters"). - set
Identifier String - Unique identifier to differentiate records with routing policies from one another. Required if using
cidr_routing_policy,failover_routing_policy,geolocation_routing_policy,latency_routing_policy,multivalue_answer_routing_policy, orweighted_routing_policy. - ttl Integer
- The TTL of the record.
- weighted
Routing List<RecordPolicies Weighted Routing Policy> - A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.
- name string
- The name of the record.
- type
string | Record
Type - The record type. Valid values are
A,AAAA,CAA,CNAME,DS,MX,NAPTR,NS,PTR,SOA,SPF,SRVandTXT. - zone
Id string - The ID of the hosted zone to contain this record.
- aliases
Record
Alias[] - An alias block. Conflicts with
ttl&records. Documented below. - allow
Overwrite boolean Allow creation of this record to overwrite an existing record, if any. This does not affect the ability to update the record using this provider and does not prevent other resources within this provider or manual Route 53 changes outside this provider from overwriting this record.
falseby default. This configuration is not recommended for most environments.Exactly one of
recordsoraliasmust be specified: this determines whether it's an alias record.- cidr
Routing RecordPolicy Cidr Routing Policy - A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.
- failover
Routing RecordPolicies Failover Routing Policy[] - A block indicating the routing behavior when associated health check fails. Conflicts with any other routing policy. Documented below.
- geolocation
Routing RecordPolicies Geolocation Routing Policy[] - A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.
- health
Check stringId - The health check the record should be associated with.
- latency
Routing RecordPolicies Latency Routing Policy[] - A block indicating a routing policy based on the latency between the requestor and an AWS region. Conflicts with any other routing policy. Documented below.
- multivalue
Answer booleanRouting Policy - Set to
trueto indicate a multivalue answer routing policy. Conflicts with any other routing policy. - records string[]
- A string list of records. To specify a single record value longer than 255 characters such as a TXT record for DKIM, add
\"\"inside the provider configuration string (e.g.,"first255characters\"\"morecharacters"). - set
Identifier string - Unique identifier to differentiate records with routing policies from one another. Required if using
cidr_routing_policy,failover_routing_policy,geolocation_routing_policy,latency_routing_policy,multivalue_answer_routing_policy, orweighted_routing_policy. - ttl number
- The TTL of the record.
- weighted
Routing RecordPolicies Weighted Routing Policy[] - A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.
- name str
- The name of the record.
- type
str | Record
Type - The record type. Valid values are
A,AAAA,CAA,CNAME,DS,MX,NAPTR,NS,PTR,SOA,SPF,SRVandTXT. - zone_
id str - The ID of the hosted zone to contain this record.
- aliases
Sequence[Record
Alias Args] - An alias block. Conflicts with
ttl&records. Documented below. - allow_
overwrite bool Allow creation of this record to overwrite an existing record, if any. This does not affect the ability to update the record using this provider and does not prevent other resources within this provider or manual Route 53 changes outside this provider from overwriting this record.
falseby default. This configuration is not recommended for most environments.Exactly one of
recordsoraliasmust be specified: this determines whether it's an alias record.- cidr_
routing_ Recordpolicy Cidr Routing Policy Args - A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.
- failover_
routing_ Sequence[Recordpolicies Failover Routing Policy Args] - A block indicating the routing behavior when associated health check fails. Conflicts with any other routing policy. Documented below.
- geolocation_
routing_ Sequence[Recordpolicies Geolocation Routing Policy Args] - A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.
- health_
check_ strid - The health check the record should be associated with.
- latency_
routing_ Sequence[Recordpolicies Latency Routing Policy Args] - A block indicating a routing policy based on the latency between the requestor and an AWS region. Conflicts with any other routing policy. Documented below.
- multivalue_
answer_ boolrouting_ policy - Set to
trueto indicate a multivalue answer routing policy. Conflicts with any other routing policy. - records Sequence[str]
- A string list of records. To specify a single record value longer than 255 characters such as a TXT record for DKIM, add
\"\"inside the provider configuration string (e.g.,"first255characters\"\"morecharacters"). - set_
identifier str - Unique identifier to differentiate records with routing policies from one another. Required if using
cidr_routing_policy,failover_routing_policy,geolocation_routing_policy,latency_routing_policy,multivalue_answer_routing_policy, orweighted_routing_policy. - ttl int
- The TTL of the record.
- weighted_
routing_ Sequence[Recordpolicies Weighted Routing Policy Args] - A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.
- name String
- The name of the record.
- type String | "A" | "AAAA" | "CNAME" | "CAA" | "MX" | "NAPTR" | "NS" | "PTR" | "SOA" | "SPF" | "SRV" | "TXT"
- The record type. Valid values are
A,AAAA,CAA,CNAME,DS,MX,NAPTR,NS,PTR,SOA,SPF,SRVandTXT. - zone
Id String - The ID of the hosted zone to contain this record.
- aliases List<Property Map>
- An alias block. Conflicts with
ttl&records. Documented below. - allow
Overwrite Boolean Allow creation of this record to overwrite an existing record, if any. This does not affect the ability to update the record using this provider and does not prevent other resources within this provider or manual Route 53 changes outside this provider from overwriting this record.
falseby default. This configuration is not recommended for most environments.Exactly one of
recordsoraliasmust be specified: this determines whether it's an alias record.- cidr
Routing Property MapPolicy - A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.
- failover
Routing List<Property Map>Policies - A block indicating the routing behavior when associated health check fails. Conflicts with any other routing policy. Documented below.
- geolocation
Routing List<Property Map>Policies - A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.
- health
Check StringId - The health check the record should be associated with.
- latency
Routing List<Property Map>Policies - A block indicating a routing policy based on the latency between the requestor and an AWS region. Conflicts with any other routing policy. Documented below.
- multivalue
Answer BooleanRouting Policy - Set to
trueto indicate a multivalue answer routing policy. Conflicts with any other routing policy. - records List<String>
- A string list of records. To specify a single record value longer than 255 characters such as a TXT record for DKIM, add
\"\"inside the provider configuration string (e.g.,"first255characters\"\"morecharacters"). - set
Identifier String - Unique identifier to differentiate records with routing policies from one another. Required if using
cidr_routing_policy,failover_routing_policy,geolocation_routing_policy,latency_routing_policy,multivalue_answer_routing_policy, orweighted_routing_policy. - ttl Number
- The TTL of the record.
- weighted
Routing List<Property Map>Policies - A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.
Outputs
All input properties are implicitly available as output properties. Additionally, the Record resource produces the following output properties:
Look up Existing Record Resource
Get an existing Record resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: RecordState, opts?: CustomResourceOptions): Record@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
aliases: Optional[Sequence[RecordAliasArgs]] = None,
allow_overwrite: Optional[bool] = None,
cidr_routing_policy: Optional[RecordCidrRoutingPolicyArgs] = None,
failover_routing_policies: Optional[Sequence[RecordFailoverRoutingPolicyArgs]] = None,
fqdn: Optional[str] = None,
geolocation_routing_policies: Optional[Sequence[RecordGeolocationRoutingPolicyArgs]] = None,
health_check_id: Optional[str] = None,
latency_routing_policies: Optional[Sequence[RecordLatencyRoutingPolicyArgs]] = None,
multivalue_answer_routing_policy: Optional[bool] = None,
name: Optional[str] = None,
records: Optional[Sequence[str]] = None,
set_identifier: Optional[str] = None,
ttl: Optional[int] = None,
type: Optional[Union[str, RecordType]] = None,
weighted_routing_policies: Optional[Sequence[RecordWeightedRoutingPolicyArgs]] = None,
zone_id: Optional[str] = None) -> Recordfunc GetRecord(ctx *Context, name string, id IDInput, state *RecordState, opts ...ResourceOption) (*Record, error)public static Record Get(string name, Input<string> id, RecordState? state, CustomResourceOptions? opts = null)public static Record get(String name, Output<String> id, RecordState state, CustomResourceOptions options)resources: _: type: aws:route53:Record get: id: ${id}- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Aliases
List<Record
Alias> - An alias block. Conflicts with
ttl&records. Documented below. - Allow
Overwrite bool Allow creation of this record to overwrite an existing record, if any. This does not affect the ability to update the record using this provider and does not prevent other resources within this provider or manual Route 53 changes outside this provider from overwriting this record.
falseby default. This configuration is not recommended for most environments.Exactly one of
recordsoraliasmust be specified: this determines whether it's an alias record.- Cidr
Routing RecordPolicy Cidr Routing Policy - A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.
- Failover
Routing List<RecordPolicies Failover Routing Policy> - A block indicating the routing behavior when associated health check fails. Conflicts with any other routing policy. Documented below.
- Fqdn string
- FQDN built using the zone domain and
name. - Geolocation
Routing List<RecordPolicies Geolocation Routing Policy> - A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.
- Health
Check stringId - The health check the record should be associated with.
- Latency
Routing List<RecordPolicies Latency Routing Policy> - A block indicating a routing policy based on the latency between the requestor and an AWS region. Conflicts with any other routing policy. Documented below.
- Multivalue
Answer boolRouting Policy - Set to
trueto indicate a multivalue answer routing policy. Conflicts with any other routing policy. - Name string
- The name of the record.
- Records List<string>
- A string list of records. To specify a single record value longer than 255 characters such as a TXT record for DKIM, add
\"\"inside the provider configuration string (e.g.,"first255characters\"\"morecharacters"). - Set
Identifier string - Unique identifier to differentiate records with routing policies from one another. Required if using
cidr_routing_policy,failover_routing_policy,geolocation_routing_policy,latency_routing_policy,multivalue_answer_routing_policy, orweighted_routing_policy. - Ttl int
- The TTL of the record.
- Type
string | Pulumi.
Aws. Route53. Record Type - The record type. Valid values are
A,AAAA,CAA,CNAME,DS,MX,NAPTR,NS,PTR,SOA,SPF,SRVandTXT. - Weighted
Routing List<RecordPolicies Weighted Routing Policy> - A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.
- Zone
Id string - The ID of the hosted zone to contain this record.
- Aliases
[]Record
Alias Args - An alias block. Conflicts with
ttl&records. Documented below. - Allow
Overwrite bool Allow creation of this record to overwrite an existing record, if any. This does not affect the ability to update the record using this provider and does not prevent other resources within this provider or manual Route 53 changes outside this provider from overwriting this record.
falseby default. This configuration is not recommended for most environments.Exactly one of
recordsoraliasmust be specified: this determines whether it's an alias record.- Cidr
Routing RecordPolicy Cidr Routing Policy Args - A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.
- Failover
Routing []RecordPolicies Failover Routing Policy Args - A block indicating the routing behavior when associated health check fails. Conflicts with any other routing policy. Documented below.
- Fqdn string
- FQDN built using the zone domain and
name. - Geolocation
Routing []RecordPolicies Geolocation Routing Policy Args - A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.
- Health
Check stringId - The health check the record should be associated with.
- Latency
Routing []RecordPolicies Latency Routing Policy Args - A block indicating a routing policy based on the latency between the requestor and an AWS region. Conflicts with any other routing policy. Documented below.
- Multivalue
Answer boolRouting Policy - Set to
trueto indicate a multivalue answer routing policy. Conflicts with any other routing policy. - Name string
- The name of the record.
- Records []string
- A string list of records. To specify a single record value longer than 255 characters such as a TXT record for DKIM, add
\"\"inside the provider configuration string (e.g.,"first255characters\"\"morecharacters"). - Set
Identifier string - Unique identifier to differentiate records with routing policies from one another. Required if using
cidr_routing_policy,failover_routing_policy,geolocation_routing_policy,latency_routing_policy,multivalue_answer_routing_policy, orweighted_routing_policy. - Ttl int
- The TTL of the record.
- Type
string | Record
Type - The record type. Valid values are
A,AAAA,CAA,CNAME,DS,MX,NAPTR,NS,PTR,SOA,SPF,SRVandTXT. - Weighted
Routing []RecordPolicies Weighted Routing Policy Args - A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.
- Zone
Id string - The ID of the hosted zone to contain this record.
- aliases
List<Record
Alias> - An alias block. Conflicts with
ttl&records. Documented below. - allow
Overwrite Boolean Allow creation of this record to overwrite an existing record, if any. This does not affect the ability to update the record using this provider and does not prevent other resources within this provider or manual Route 53 changes outside this provider from overwriting this record.
falseby default. This configuration is not recommended for most environments.Exactly one of
recordsoraliasmust be specified: this determines whether it's an alias record.- cidr
Routing RecordPolicy Cidr Routing Policy - A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.
- failover
Routing List<RecordPolicies Failover Routing Policy> - A block indicating the routing behavior when associated health check fails. Conflicts with any other routing policy. Documented below.
- fqdn String
- FQDN built using the zone domain and
name. - geolocation
Routing List<RecordPolicies Geolocation Routing Policy> - A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.
- health
Check StringId - The health check the record should be associated with.
- latency
Routing List<RecordPolicies Latency Routing Policy> - A block indicating a routing policy based on the latency between the requestor and an AWS region. Conflicts with any other routing policy. Documented below.
- multivalue
Answer BooleanRouting Policy - Set to
trueto indicate a multivalue answer routing policy. Conflicts with any other routing policy. - name String
- The name of the record.
- records List<String>
- A string list of records. To specify a single record value longer than 255 characters such as a TXT record for DKIM, add
\"\"inside the provider configuration string (e.g.,"first255characters\"\"morecharacters"). - set
Identifier String - Unique identifier to differentiate records with routing policies from one another. Required if using
cidr_routing_policy,failover_routing_policy,geolocation_routing_policy,latency_routing_policy,multivalue_answer_routing_policy, orweighted_routing_policy. - ttl Integer
- The TTL of the record.
- type
String | Record
Type - The record type. Valid values are
A,AAAA,CAA,CNAME,DS,MX,NAPTR,NS,PTR,SOA,SPF,SRVandTXT. - weighted
Routing List<RecordPolicies Weighted Routing Policy> - A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.
- zone
Id String - The ID of the hosted zone to contain this record.
- aliases
Record
Alias[] - An alias block. Conflicts with
ttl&records. Documented below. - allow
Overwrite boolean Allow creation of this record to overwrite an existing record, if any. This does not affect the ability to update the record using this provider and does not prevent other resources within this provider or manual Route 53 changes outside this provider from overwriting this record.
falseby default. This configuration is not recommended for most environments.Exactly one of
recordsoraliasmust be specified: this determines whether it's an alias record.- cidr
Routing RecordPolicy Cidr Routing Policy - A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.
- failover
Routing RecordPolicies Failover Routing Policy[] - A block indicating the routing behavior when associated health check fails. Conflicts with any other routing policy. Documented below.
- fqdn string
- FQDN built using the zone domain and
name. - geolocation
Routing RecordPolicies Geolocation Routing Policy[] - A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.
- health
Check stringId - The health check the record should be associated with.
- latency
Routing RecordPolicies Latency Routing Policy[] - A block indicating a routing policy based on the latency between the requestor and an AWS region. Conflicts with any other routing policy. Documented below.
- multivalue
Answer booleanRouting Policy - Set to
trueto indicate a multivalue answer routing policy. Conflicts with any other routing policy. - name string
- The name of the record.
- records string[]
- A string list of records. To specify a single record value longer than 255 characters such as a TXT record for DKIM, add
\"\"inside the provider configuration string (e.g.,"first255characters\"\"morecharacters"). - set
Identifier string - Unique identifier to differentiate records with routing policies from one another. Required if using
cidr_routing_policy,failover_routing_policy,geolocation_routing_policy,latency_routing_policy,multivalue_answer_routing_policy, orweighted_routing_policy. - ttl number
- The TTL of the record.
- type
string | Record
Type - The record type. Valid values are
A,AAAA,CAA,CNAME,DS,MX,NAPTR,NS,PTR,SOA,SPF,SRVandTXT. - weighted
Routing RecordPolicies Weighted Routing Policy[] - A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.
- zone
Id string - The ID of the hosted zone to contain this record.
- aliases
Sequence[Record
Alias Args] - An alias block. Conflicts with
ttl&records. Documented below. - allow_
overwrite bool Allow creation of this record to overwrite an existing record, if any. This does not affect the ability to update the record using this provider and does not prevent other resources within this provider or manual Route 53 changes outside this provider from overwriting this record.
falseby default. This configuration is not recommended for most environments.Exactly one of
recordsoraliasmust be specified: this determines whether it's an alias record.- cidr_
routing_ Recordpolicy Cidr Routing Policy Args - A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.
- failover_
routing_ Sequence[Recordpolicies Failover Routing Policy Args] - A block indicating the routing behavior when associated health check fails. Conflicts with any other routing policy. Documented below.
- fqdn str
- FQDN built using the zone domain and
name. - geolocation_
routing_ Sequence[Recordpolicies Geolocation Routing Policy Args] - A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.
- health_
check_ strid - The health check the record should be associated with.
- latency_
routing_ Sequence[Recordpolicies Latency Routing Policy Args] - A block indicating a routing policy based on the latency between the requestor and an AWS region. Conflicts with any other routing policy. Documented below.
- multivalue_
answer_ boolrouting_ policy - Set to
trueto indicate a multivalue answer routing policy. Conflicts with any other routing policy. - name str
- The name of the record.
- records Sequence[str]
- A string list of records. To specify a single record value longer than 255 characters such as a TXT record for DKIM, add
\"\"inside the provider configuration string (e.g.,"first255characters\"\"morecharacters"). - set_
identifier str - Unique identifier to differentiate records with routing policies from one another. Required if using
cidr_routing_policy,failover_routing_policy,geolocation_routing_policy,latency_routing_policy,multivalue_answer_routing_policy, orweighted_routing_policy. - ttl int
- The TTL of the record.
- type
str | Record
Type - The record type. Valid values are
A,AAAA,CAA,CNAME,DS,MX,NAPTR,NS,PTR,SOA,SPF,SRVandTXT. - weighted_
routing_ Sequence[Recordpolicies Weighted Routing Policy Args] - A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.
- zone_
id str - The ID of the hosted zone to contain this record.
- aliases List<Property Map>
- An alias block. Conflicts with
ttl&records. Documented below. - allow
Overwrite Boolean Allow creation of this record to overwrite an existing record, if any. This does not affect the ability to update the record using this provider and does not prevent other resources within this provider or manual Route 53 changes outside this provider from overwriting this record.
falseby default. This configuration is not recommended for most environments.Exactly one of
recordsoraliasmust be specified: this determines whether it's an alias record.- cidr
Routing Property MapPolicy - A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.
- failover
Routing List<Property Map>Policies - A block indicating the routing behavior when associated health check fails. Conflicts with any other routing policy. Documented below.
- fqdn String
- FQDN built using the zone domain and
name. - geolocation
Routing List<Property Map>Policies - A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.
- health
Check StringId - The health check the record should be associated with.
- latency
Routing List<Property Map>Policies - A block indicating a routing policy based on the latency between the requestor and an AWS region. Conflicts with any other routing policy. Documented below.
- multivalue
Answer BooleanRouting Policy - Set to
trueto indicate a multivalue answer routing policy. Conflicts with any other routing policy. - name String
- The name of the record.
- records List<String>
- A string list of records. To specify a single record value longer than 255 characters such as a TXT record for DKIM, add
\"\"inside the provider configuration string (e.g.,"first255characters\"\"morecharacters"). - set
Identifier String - Unique identifier to differentiate records with routing policies from one another. Required if using
cidr_routing_policy,failover_routing_policy,geolocation_routing_policy,latency_routing_policy,multivalue_answer_routing_policy, orweighted_routing_policy. - ttl Number
- The TTL of the record.
- type String | "A" | "AAAA" | "CNAME" | "CAA" | "MX" | "NAPTR" | "NS" | "PTR" | "SOA" | "SPF" | "SRV" | "TXT"
- The record type. Valid values are
A,AAAA,CAA,CNAME,DS,MX,NAPTR,NS,PTR,SOA,SPF,SRVandTXT. - weighted
Routing List<Property Map>Policies - A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.
- zone
Id String - The ID of the hosted zone to contain this record.
Supporting Types
RecordAlias, RecordAliasArgs
- Evaluate
Target boolHealth - Set to
trueif you want Route 53 to determine whether to respond to DNS queries using this resource record set by checking the health of the resource record set. Some resources have special requirements, see related part of documentation. - Name string
- DNS domain name for a CloudFront distribution, S3 bucket, ELB, or another resource record set in this hosted zone.
- Zone
Id string - Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See
resource_elb.zone_idfor example.
- Evaluate
Target boolHealth - Set to
trueif you want Route 53 to determine whether to respond to DNS queries using this resource record set by checking the health of the resource record set. Some resources have special requirements, see related part of documentation. - Name string
- DNS domain name for a CloudFront distribution, S3 bucket, ELB, or another resource record set in this hosted zone.
- Zone
Id string - Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See
resource_elb.zone_idfor example.
- evaluate
Target BooleanHealth - Set to
trueif you want Route 53 to determine whether to respond to DNS queries using this resource record set by checking the health of the resource record set. Some resources have special requirements, see related part of documentation. - name String
- DNS domain name for a CloudFront distribution, S3 bucket, ELB, or another resource record set in this hosted zone.
- zone
Id String - Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See
resource_elb.zone_idfor example.
- evaluate
Target booleanHealth - Set to
trueif you want Route 53 to determine whether to respond to DNS queries using this resource record set by checking the health of the resource record set. Some resources have special requirements, see related part of documentation. - name string
- DNS domain name for a CloudFront distribution, S3 bucket, ELB, or another resource record set in this hosted zone.
- zone
Id string - Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See
resource_elb.zone_idfor example.
- evaluate_
target_ boolhealth - Set to
trueif you want Route 53 to determine whether to respond to DNS queries using this resource record set by checking the health of the resource record set. Some resources have special requirements, see related part of documentation. - name str
- DNS domain name for a CloudFront distribution, S3 bucket, ELB, or another resource record set in this hosted zone.
- zone_
id str - Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See
resource_elb.zone_idfor example.
- evaluate
Target BooleanHealth - Set to
trueif you want Route 53 to determine whether to respond to DNS queries using this resource record set by checking the health of the resource record set. Some resources have special requirements, see related part of documentation. - name String
- DNS domain name for a CloudFront distribution, S3 bucket, ELB, or another resource record set in this hosted zone.
- zone
Id String - Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See
resource_elb.zone_idfor example.
RecordCidrRoutingPolicy, RecordCidrRoutingPolicyArgs
- Collection
Id string - The CIDR collection ID. See the
aws_route53_cidr_collectionresource for more details. - Location
Name string - The CIDR collection location name. See the
aws_route53_cidr_locationresource for more details. Alocation_namewith an asterisk"*"can be used to create a default CIDR record.collection_idis still required for default record.
- Collection
Id string - The CIDR collection ID. See the
aws_route53_cidr_collectionresource for more details. - Location
Name string - The CIDR collection location name. See the
aws_route53_cidr_locationresource for more details. Alocation_namewith an asterisk"*"can be used to create a default CIDR record.collection_idis still required for default record.
- collection
Id String - The CIDR collection ID. See the
aws_route53_cidr_collectionresource for more details. - location
Name String - The CIDR collection location name. See the
aws_route53_cidr_locationresource for more details. Alocation_namewith an asterisk"*"can be used to create a default CIDR record.collection_idis still required for default record.
- collection
Id string - The CIDR collection ID. See the
aws_route53_cidr_collectionresource for more details. - location
Name string - The CIDR collection location name. See the
aws_route53_cidr_locationresource for more details. Alocation_namewith an asterisk"*"can be used to create a default CIDR record.collection_idis still required for default record.
- collection_
id str - The CIDR collection ID. See the
aws_route53_cidr_collectionresource for more details. - location_
name str - The CIDR collection location name. See the
aws_route53_cidr_locationresource for more details. Alocation_namewith an asterisk"*"can be used to create a default CIDR record.collection_idis still required for default record.
- collection
Id String - The CIDR collection ID. See the
aws_route53_cidr_collectionresource for more details. - location
Name String - The CIDR collection location name. See the
aws_route53_cidr_locationresource for more details. Alocation_namewith an asterisk"*"can be used to create a default CIDR record.collection_idis still required for default record.
RecordFailoverRoutingPolicy, RecordFailoverRoutingPolicyArgs
- Type string
PRIMARYorSECONDARY. APRIMARYrecord will be served if its healthcheck is passing, otherwise theSECONDARYwill be served. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.html#dns-failover-failover-rrsets
- Type string
PRIMARYorSECONDARY. APRIMARYrecord will be served if its healthcheck is passing, otherwise theSECONDARYwill be served. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.html#dns-failover-failover-rrsets
- type String
PRIMARYorSECONDARY. APRIMARYrecord will be served if its healthcheck is passing, otherwise theSECONDARYwill be served. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.html#dns-failover-failover-rrsets
- type string
PRIMARYorSECONDARY. APRIMARYrecord will be served if its healthcheck is passing, otherwise theSECONDARYwill be served. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.html#dns-failover-failover-rrsets
- type str
PRIMARYorSECONDARY. APRIMARYrecord will be served if its healthcheck is passing, otherwise theSECONDARYwill be served. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.html#dns-failover-failover-rrsets
- type String
PRIMARYorSECONDARY. APRIMARYrecord will be served if its healthcheck is passing, otherwise theSECONDARYwill be served. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.html#dns-failover-failover-rrsets
RecordGeolocationRoutingPolicy, RecordGeolocationRoutingPolicyArgs
- Continent string
- A two-letter continent code. See http://docs.aws.amazon.com/Route53/latest/APIReference/API_GetGeoLocation.html for code details. Either
continentorcountrymust be specified. - Country string
- A two-character country code or
*to indicate a default resource record set. - Subdivision string
- A subdivision code for a country.
- Continent string
- A two-letter continent code. See http://docs.aws.amazon.com/Route53/latest/APIReference/API_GetGeoLocation.html for code details. Either
continentorcountrymust be specified. - Country string
- A two-character country code or
*to indicate a default resource record set. - Subdivision string
- A subdivision code for a country.
- continent String
- A two-letter continent code. See http://docs.aws.amazon.com/Route53/latest/APIReference/API_GetGeoLocation.html for code details. Either
continentorcountrymust be specified. - country String
- A two-character country code or
*to indicate a default resource record set. - subdivision String
- A subdivision code for a country.
- continent string
- A two-letter continent code. See http://docs.aws.amazon.com/Route53/latest/APIReference/API_GetGeoLocation.html for code details. Either
continentorcountrymust be specified. - country string
- A two-character country code or
*to indicate a default resource record set. - subdivision string
- A subdivision code for a country.
- continent str
- A two-letter continent code. See http://docs.aws.amazon.com/Route53/latest/APIReference/API_GetGeoLocation.html for code details. Either
continentorcountrymust be specified. - country str
- A two-character country code or
*to indicate a default resource record set. - subdivision str
- A subdivision code for a country.
- continent String
- A two-letter continent code. See http://docs.aws.amazon.com/Route53/latest/APIReference/API_GetGeoLocation.html for code details. Either
continentorcountrymust be specified. - country String
- A two-character country code or
*to indicate a default resource record set. - subdivision String
- A subdivision code for a country.
RecordLatencyRoutingPolicy, RecordLatencyRoutingPolicyArgs
- Region string
- An AWS region from which to measure latency. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-latency
- Region string
- An AWS region from which to measure latency. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-latency
- region String
- An AWS region from which to measure latency. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-latency
- region string
- An AWS region from which to measure latency. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-latency
- region str
- An AWS region from which to measure latency. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-latency
- region String
- An AWS region from which to measure latency. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-latency
RecordType, RecordTypeArgs
- A
A- AAAA
AAAA- CNAME
CNAME- CAA
CAA- MX
MX- NAPTR
NAPTR- NS
NS- PTR
PTR- SOA
SOA- SPF
SPF- SRV
SRV- TXT
TXT
- Record
Type A A- Record
Type AAAA AAAA- Record
Type CNAME CNAME- Record
Type CAA CAA- Record
Type MX MX- Record
Type NAPTR NAPTR- Record
Type NS NS- Record
Type PTR PTR- Record
Type SOA SOA- Record
Type SPF SPF- Record
Type SRV SRV- Record
Type TXT TXT
- A
A- AAAA
AAAA- CNAME
CNAME- CAA
CAA- MX
MX- NAPTR
NAPTR- NS
NS- PTR
PTR- SOA
SOA- SPF
SPF- SRV
SRV- TXT
TXT
- A
A- AAAA
AAAA- CNAME
CNAME- CAA
CAA- MX
MX- NAPTR
NAPTR- NS
NS- PTR
PTR- SOA
SOA- SPF
SPF- SRV
SRV- TXT
TXT
- A
A- AAAA
AAAA- CNAME
CNAME- CAA
CAA- MX
MX- NAPTR
NAPTR- NS
NS- PTR
PTR- SOA
SOA- SPF
SPF- SRV
SRV- TXT
TXT
- "A"
A- "AAAA"
AAAA- "CNAME"
CNAME- "CAA"
CAA- "MX"
MX- "NAPTR"
NAPTR- "NS"
NS- "PTR"
PTR- "SOA"
SOA- "SPF"
SPF- "SRV"
SRV- "TXT"
TXT
RecordWeightedRoutingPolicy, RecordWeightedRoutingPolicyArgs
- Weight int
- A numeric value indicating the relative weight of the record. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-weighted.
- Weight int
- A numeric value indicating the relative weight of the record. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-weighted.
- weight Integer
- A numeric value indicating the relative weight of the record. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-weighted.
- weight number
- A numeric value indicating the relative weight of the record. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-weighted.
- weight int
- A numeric value indicating the relative weight of the record. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-weighted.
- weight Number
- A numeric value indicating the relative weight of the record. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-weighted.
Import
Route53 Records can be imported using ID of the record, which is the zone identifier, record name, and record type, separated by underscores (_)E.g.,
$ pulumi import aws:route53/record:Record myrecord Z4KAPRWWNC7JR_dev.example.com_NS
If the record also contains a set identifier, it should be appended
$ pulumi import aws:route53/record:Record myrecord Z4KAPRWWNC7JR_dev.example.com_NS_dev
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- AWS Classic pulumi/pulumi-aws
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
awsTerraform Provider.
published on Tuesday, Mar 10, 2026 by Pulumi
