Record
Provides a Route53 record resource.
Example Usage
Weighted routing policy
using Pulumi;
using Aws = Pulumi.Aws;
class MyStack : Stack
{
public MyStack()
{
var www_dev = new Aws.Route53.Record("www-dev", new Aws.Route53.RecordArgs
{
Name = "www",
Records =
{
"dev.example.com",
},
SetIdentifier = "dev",
Ttl = 5,
Type = "CNAME",
WeightedRoutingPolicies =
{
new Aws.Route53.Inputs.RecordWeightedRoutingPolicyArgs
{
Weight = 10,
},
},
ZoneId = aws_route53_zone.Primary.Zone_id,
});
var www_live = new Aws.Route53.Record("www-live", new Aws.Route53.RecordArgs
{
Name = "www",
Records =
{
"live.example.com",
},
SetIdentifier = "live",
Ttl = 5,
Type = "CNAME",
WeightedRoutingPolicies =
{
new Aws.Route53.Inputs.RecordWeightedRoutingPolicyArgs
{
Weight = 90,
},
},
ZoneId = aws_route53_zone.Primary.Zone_id,
});
}
}
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v2/go/aws/route53"
"github.com/pulumi/pulumi/sdk/v2/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := route53.NewRecord(ctx, "www_dev", &route53.RecordArgs{
Name: pulumi.String("www"),
Records: pulumi.StringArray{
pulumi.String("dev.example.com"),
},
SetIdentifier: pulumi.String("dev"),
Ttl: pulumi.Int(5),
Type: pulumi.String("CNAME"),
WeightedRoutingPolicies: route53.RecordWeightedRoutingPolicyArray{
&route53.RecordWeightedRoutingPolicyArgs{
Weight: pulumi.Int(10),
},
},
ZoneId: pulumi.String(aws_route53_zone.Primary.Zone_id),
})
if err != nil {
return err
}
_, err = route53.NewRecord(ctx, "www_live", &route53.RecordArgs{
Name: pulumi.String("www"),
Records: pulumi.StringArray{
pulumi.String("live.example.com"),
},
SetIdentifier: pulumi.String("live"),
Ttl: pulumi.Int(5),
Type: pulumi.String("CNAME"),
WeightedRoutingPolicies: route53.RecordWeightedRoutingPolicyArray{
&route53.RecordWeightedRoutingPolicyArgs{
Weight: pulumi.Int(90),
},
},
ZoneId: pulumi.String(aws_route53_zone.Primary.Zone_id),
})
if err != nil {
return err
}
return nil
})
}import pulumi
import pulumi_aws as aws
www_dev = aws.route53.Record("www-dev",
name="www",
records=["dev.example.com"],
set_identifier="dev",
ttl="5",
type="CNAME",
weighted_routing_policies=[{
"weight": 10,
}],
zone_id=aws_route53_zone["primary"]["zone_id"])
www_live = aws.route53.Record("www-live",
name="www",
records=["live.example.com"],
set_identifier="live",
ttl="5",
type="CNAME",
weighted_routing_policies=[{
"weight": 90,
}],
zone_id=aws_route53_zone["primary"]["zone_id"])import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const www_dev = new aws.route53.Record("www-dev", {
name: "www",
records: ["dev.example.com"],
setIdentifier: "dev",
ttl: 5,
type: "CNAME",
weightedRoutingPolicies: [{
weight: 10,
}],
zoneId: aws_route53_zone_primary.zoneId,
});
const www_live = new aws.route53.Record("www-live", {
name: "www",
records: ["live.example.com"],
setIdentifier: "live",
ttl: 5,
type: "CNAME",
weightedRoutingPolicies: [{
weight: 90,
}],
zoneId: aws_route53_zone_primary.zoneId,
});Alias record
using Pulumi;
using Aws = Pulumi.Aws;
class MyStack : Stack
{
public MyStack()
{
var main = new Aws.Elb.LoadBalancer("main", new Aws.Elb.LoadBalancerArgs
{
AvailabilityZones =
{
"us-east-1c",
},
Listeners =
{
new Aws.Elb.Inputs.LoadBalancerListenerArgs
{
InstancePort = 80,
InstanceProtocol = "http",
LbPort = 80,
LbProtocol = "http",
},
},
});
var www = new Aws.Route53.Record("www", new Aws.Route53.RecordArgs
{
Aliases =
{
new Aws.Route53.Inputs.RecordAliasArgs
{
EvaluateTargetHealth = true,
Name = main.DnsName,
ZoneId = main.ZoneId,
},
},
Name = "example.com",
Type = "A",
ZoneId = aws_route53_zone.Primary.Zone_id,
});
}
}
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v2/go/aws/elb"
"github.com/pulumi/pulumi-aws/sdk/v2/go/aws/route53"
"github.com/pulumi/pulumi/sdk/v2/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{
Aliases: route53.RecordAliasArray{
&route53.RecordAliasArgs{
EvaluateTargetHealth: pulumi.Bool(true),
Name: main.DnsName,
ZoneId: main.ZoneId,
},
},
Name: pulumi.String("example.com"),
Type: pulumi.String("A"),
ZoneId: pulumi.String(aws_route53_zone.Primary.Zone_id),
})
if err != nil {
return err
}
return nil
})
}import pulumi
import pulumi_aws as aws
main = aws.elb.LoadBalancer("main",
availability_zones=["us-east-1c"],
listeners=[{
"instance_port": 80,
"instanceProtocol": "http",
"lb_port": 80,
"lbProtocol": "http",
}])
www = aws.route53.Record("www",
aliases=[{
"evaluateTargetHealth": True,
"name": main.dns_name,
"zone_id": main.zone_id,
}],
name="example.com",
type="A",
zone_id=aws_route53_zone["primary"]["zone_id"])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", {
aliases: [{
evaluateTargetHealth: true,
name: main.dnsName,
zoneId: main.zoneId,
}],
name: "example.com",
type: "A",
zoneId: aws_route53_zone_primary.zoneId,
});NS and SOA Record Management
using Pulumi;
using Aws = Pulumi.Aws;
class MyStack : Stack
{
public MyStack()
{
var exampleZone = new Aws.Route53.Zone("exampleZone", new Aws.Route53.ZoneArgs
{
});
var exampleRecord = new Aws.Route53.Record("exampleRecord", new Aws.Route53.RecordArgs
{
AllowOverwrite = true,
Name = "test.example.com",
Records =
{
exampleZone.NameServers.Apply(nameServers => nameServers[0]),
exampleZone.NameServers.Apply(nameServers => nameServers[1]),
exampleZone.NameServers.Apply(nameServers => nameServers[2]),
exampleZone.NameServers.Apply(nameServers => nameServers[3]),
},
Ttl = 30,
Type = "NS",
ZoneId = exampleZone.ZoneId,
});
}
}
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v2/go/aws/route53"
"github.com/pulumi/pulumi/sdk/v2/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"),
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),
},
Ttl: pulumi.Int(30),
Type: pulumi.String("NS"),
ZoneId: exampleZone.ZoneId,
})
if err != nil {
return err
}
return nil
})
}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",
records=[
example_zone.name_servers[0],
example_zone.name_servers[1],
example_zone.name_servers[2],
example_zone.name_servers[3],
],
ttl=30,
type="NS",
zone_id=example_zone.zone_id)import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const exampleZone = new aws.route53.Zone("example", {});
const exampleRecord = new aws.route53.Record("example", {
allowOverwrite: true,
name: "test.example.com",
records: [
exampleZone.nameServers[0],
exampleZone.nameServers[1],
exampleZone.nameServers[2],
exampleZone.nameServers[3],
],
ttl: 30,
type: "NS",
zoneId: exampleZone.zoneId,
});Create a Record Resource
new Record(name: string, args: RecordArgs, opts?: CustomResourceOptions);def Record(resource_name, opts=None, aliases=None, allow_overwrite=None, failover_routing_policies=None, geolocation_routing_policies=None, health_check_id=None, latency_routing_policies=None, multivalue_answer_routing_policy=None, name=None, records=None, set_identifier=None, ttl=None, type=None, weighted_routing_policies=None, zone_id=None, __props__=None);func NewRecord(ctx *Context, name string, args RecordArgs, opts ...ResourceOption) (*Record, error)public Record(string name, RecordArgs args, CustomResourceOptions? opts = null)- 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.
- opts ResourceOptions
- A bag of options that control this 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.
Record Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Programming Model docs.
Inputs
The Record resource accepts the following input properties:
- Name string
DNS domain name for a CloudFront distribution, S3 bucket, ELB, or another resource record set in this hosted zone.
- 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- Zone
Id string Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See
resource_elb.zone_idfor example.- Aliases
List<Record
Alias Args> An alias block. Conflicts with
ttl&records. Alias record 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.- Failover
Routing List<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 List<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 List<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 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 configuration string (e.g."first255characters\"\"morecharacters").- Set
Identifier string Unique identifier to differentiate records with routing policies from one another. Required if using
failover,geolocation,latency, orweightedrouting policies documented below.- Ttl int
The TTL of the record.
- Weighted
Routing List<RecordPolicies Weighted Routing Policy Args> A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.
- Name string
DNS domain name for a CloudFront distribution, S3 bucket, ELB, or another resource record set in this hosted zone.
- Type interface{}
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- Zone
Id string Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See
resource_elb.zone_idfor example.- Aliases
[]Record
Alias An alias block. Conflicts with
ttl&records. Alias record 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.- 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 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 configuration string (e.g."first255characters\"\"morecharacters").- Set
Identifier string Unique identifier to differentiate records with routing policies from one another. Required if using
failover,geolocation,latency, orweightedrouting policies documented below.- Ttl int
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 string
DNS domain name for a CloudFront distribution, S3 bucket, ELB, or another resource record set in this hosted zone.
- type
string | Record
Type 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- zone
Id string Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See
resource_elb.zone_idfor example.- aliases
Record
Alias[] An alias block. Conflicts with
ttl&records. Alias record 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.- 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 configuration string (e.g."first255characters\"\"morecharacters").- set
Identifier string Unique identifier to differentiate records with routing policies from one another. Required if using
failover,geolocation,latency, orweightedrouting policies documented below.- 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
DNS domain name for a CloudFront distribution, S3 bucket, ELB, or another resource record set in this hosted zone.
- type string | 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- zone_
id str Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See
resource_elb.zone_idfor example.- aliases
List[Record
Alias] An alias block. Conflicts with
ttl&records. Alias record 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.- 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_ strid 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[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 configuration string (e.g."first255characters\"\"morecharacters").- set_
identifier str Unique identifier to differentiate records with routing policies from one another. Required if using
failover,geolocation,latency, orweightedrouting policies documented below.- ttl float
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.
Outputs
All input properties are implicitly available as output properties. Additionally, the Record resource produces the following output properties:
Look up an 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): Recordstatic get(resource_name, id, opts=None, aliases=None, allow_overwrite=None, failover_routing_policies=None, fqdn=None, geolocation_routing_policies=None, health_check_id=None, latency_routing_policies=None, multivalue_answer_routing_policy=None, name=None, records=None, set_identifier=None, ttl=None, type=None, weighted_routing_policies=None, zone_id=None, __props__=None);func 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)- 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.
The following state arguments are supported:
- Aliases
List<Record
Alias Args> An alias block. Conflicts with
ttl&records. Alias record 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.- Failover
Routing List<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 List<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 List<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
DNS domain name for a CloudFront distribution, S3 bucket, ELB, or another resource record set in this hosted zone.
- 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 configuration string (e.g."first255characters\"\"morecharacters").- Set
Identifier string Unique identifier to differentiate records with routing policies from one another. Required if using
failover,geolocation,latency, orweightedrouting policies documented below.- Ttl int
The TTL of the record.
- 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- Weighted
Routing List<RecordPolicies Weighted Routing Policy Args> A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.
- Zone
Id string Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See
resource_elb.zone_idfor example.
- Aliases
[]Record
Alias An alias block. Conflicts with
ttl&records. Alias record 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.- 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 boolRouting Policy Set to
trueto indicate a multivalue answer routing policy. Conflicts with any other routing policy.- Name string
DNS domain name for a CloudFront distribution, S3 bucket, ELB, or another resource record set in this hosted zone.
- 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 configuration string (e.g."first255characters\"\"morecharacters").- Set
Identifier string Unique identifier to differentiate records with routing policies from one another. Required if using
failover,geolocation,latency, orweightedrouting policies documented below.- Ttl int
The TTL of the record.
- Type interface{}
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- Weighted
Routing []RecordPolicies Weighted Routing Policy A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.
- Zone
Id string Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See
resource_elb.zone_idfor example.
- aliases
Record
Alias[] An alias block. Conflicts with
ttl&records. Alias record 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.- 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
DNS domain name for a CloudFront distribution, S3 bucket, ELB, or another resource record set in this hosted zone.
- 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 configuration string (e.g."first255characters\"\"morecharacters").- set
Identifier string Unique identifier to differentiate records with routing policies from one another. Required if using
failover,geolocation,latency, orweightedrouting policies documented below.- ttl number
The TTL of the record.
- type
string | Record
Type 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- weighted
Routing RecordPolicies Weighted Routing Policy[] A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.
- zone
Id string Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See
resource_elb.zone_idfor example.
- aliases
List[Record
Alias] An alias block. Conflicts with
ttl&records. Alias record 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.- 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 str
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_ strid 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 str
DNS domain name for a CloudFront distribution, S3 bucket, ELB, or another resource record set in this hosted zone.
- records List[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 configuration string (e.g."first255characters\"\"morecharacters").- set_
identifier str Unique identifier to differentiate records with routing policies from one another. Required if using
failover,geolocation,latency, orweightedrouting policies documented below.- ttl float
The TTL of the record.
- type string | 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- weighted_
routing_ List[Recordpolicies Weighted Routing Policy] A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.
- zone_
id str Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See
resource_elb.zone_idfor example.
Supporting Types
RecordAlias
- 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 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.
RecordFailoverRoutingPolicy
- 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
RecordGeolocationRoutingPolicy
- 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.
RecordLatencyRoutingPolicy
- 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
RecordWeightedRoutingPolicy
- 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 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 float
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.
Package Details
- Repository
- https://github.com/pulumi/pulumi-aws
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
awsTerraform Provider.