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

PRIMARY or SECONDARY. A PRIMARY record will be served if its healthcheck is passing, otherwise the SECONDARY will be served. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.html#dns-failover-failover-rrsets

ZoneId string

Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See resource_elb.zone_id for example.

Aliases List<RecordAliasArgs>

An alias block. Conflicts with ttl & records. Alias record documented below.

AllowOverwrite 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. false by default. This configuration is not recommended for most environments.

FailoverRoutingPolicies List<RecordFailoverRoutingPolicyArgs>

A block indicating the routing behavior when associated health check fails. Conflicts with any other routing policy. Documented below.

GeolocationRoutingPolicies List<RecordGeolocationRoutingPolicyArgs>

A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.

HealthCheckId string

The health check the record should be associated with.

LatencyRoutingPolicies List<RecordLatencyRoutingPolicyArgs>

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.

MultivalueAnswerRoutingPolicy bool

Set to true to 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").

SetIdentifier string

Unique identifier to differentiate records with routing policies from one another. Required if using failover, geolocation, latency, or weighted routing policies documented below.

Ttl int

The TTL of the record.

WeightedRoutingPolicies List<RecordWeightedRoutingPolicyArgs>

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{}

PRIMARY or SECONDARY. A PRIMARY record will be served if its healthcheck is passing, otherwise the SECONDARY will be served. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.html#dns-failover-failover-rrsets

ZoneId string

Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See resource_elb.zone_id for example.

Aliases []RecordAlias

An alias block. Conflicts with ttl & records. Alias record documented below.

AllowOverwrite 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. false by default. This configuration is not recommended for most environments.

FailoverRoutingPolicies []RecordFailoverRoutingPolicy

A block indicating the routing behavior when associated health check fails. Conflicts with any other routing policy. Documented below.

GeolocationRoutingPolicies []RecordGeolocationRoutingPolicy

A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.

HealthCheckId string

The health check the record should be associated with.

LatencyRoutingPolicies []RecordLatencyRoutingPolicy

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.

MultivalueAnswerRoutingPolicy bool

Set to true to 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").

SetIdentifier string

Unique identifier to differentiate records with routing policies from one another. Required if using failover, geolocation, latency, or weighted routing policies documented below.

Ttl int

The TTL of the record.

WeightedRoutingPolicies []RecordWeightedRoutingPolicy

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 | RecordType

PRIMARY or SECONDARY. A PRIMARY record will be served if its healthcheck is passing, otherwise the SECONDARY will be served. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.html#dns-failover-failover-rrsets

zoneId string

Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See resource_elb.zone_id for example.

aliases RecordAlias[]

An alias block. Conflicts with ttl & records. Alias record documented below.

allowOverwrite 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. false by default. This configuration is not recommended for most environments.

failoverRoutingPolicies RecordFailoverRoutingPolicy[]

A block indicating the routing behavior when associated health check fails. Conflicts with any other routing policy. Documented below.

geolocationRoutingPolicies RecordGeolocationRoutingPolicy[]

A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.

healthCheckId string

The health check the record should be associated with.

latencyRoutingPolicies RecordLatencyRoutingPolicy[]

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.

multivalueAnswerRoutingPolicy boolean

Set to true to 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").

setIdentifier string

Unique identifier to differentiate records with routing policies from one another. Required if using failover, geolocation, latency, or weighted routing policies documented below.

ttl number

The TTL of the record.

weightedRoutingPolicies RecordWeightedRoutingPolicy[]

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

PRIMARY or SECONDARY. A PRIMARY record will be served if its healthcheck is passing, otherwise the SECONDARY will 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_id for example.

aliases List[RecordAlias]

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. false by default. This configuration is not recommended for most environments.

failover_routing_policies List[RecordFailoverRoutingPolicy]

A block indicating the routing behavior when associated health check fails. Conflicts with any other routing policy. Documented below.

geolocation_routing_policies List[RecordGeolocationRoutingPolicy]

A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.

health_check_id str

The health check the record should be associated with.

latency_routing_policies List[RecordLatencyRoutingPolicy]

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_routing_policy bool

Set to true to 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, or weighted routing policies documented below.

ttl float

The TTL of the record.

weighted_routing_policies List[RecordWeightedRoutingPolicy]

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:

Fqdn string

FQDN built using the zone domain and name.

Id string
The provider-assigned unique ID for this managed resource.
Fqdn string

FQDN built using the zone domain and name.

Id string
The provider-assigned unique ID for this managed resource.
fqdn string

FQDN built using the zone domain and name.

id string
The provider-assigned unique ID for this managed resource.
fqdn str

FQDN built using the zone domain and name.

id str
The provider-assigned unique ID for this managed resource.

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): Record
static 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<RecordAliasArgs>

An alias block. Conflicts with ttl & records. Alias record documented below.

AllowOverwrite 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. false by default. This configuration is not recommended for most environments.

FailoverRoutingPolicies List<RecordFailoverRoutingPolicyArgs>

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.

GeolocationRoutingPolicies List<RecordGeolocationRoutingPolicyArgs>

A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.

HealthCheckId string

The health check the record should be associated with.

LatencyRoutingPolicies List<RecordLatencyRoutingPolicyArgs>

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.

MultivalueAnswerRoutingPolicy bool

Set to true to 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").

SetIdentifier string

Unique identifier to differentiate records with routing policies from one another. Required if using failover, geolocation, latency, or weighted routing policies documented below.

Ttl int

The TTL of the record.

Type string

PRIMARY or SECONDARY. A PRIMARY record will be served if its healthcheck is passing, otherwise the SECONDARY will be served. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.html#dns-failover-failover-rrsets

WeightedRoutingPolicies List<RecordWeightedRoutingPolicyArgs>

A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.

ZoneId string

Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See resource_elb.zone_id for example.

Aliases []RecordAlias

An alias block. Conflicts with ttl & records. Alias record documented below.

AllowOverwrite 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. false by default. This configuration is not recommended for most environments.

FailoverRoutingPolicies []RecordFailoverRoutingPolicy

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.

GeolocationRoutingPolicies []RecordGeolocationRoutingPolicy

A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.

HealthCheckId string

The health check the record should be associated with.

LatencyRoutingPolicies []RecordLatencyRoutingPolicy

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.

MultivalueAnswerRoutingPolicy bool

Set to true to 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").

SetIdentifier string

Unique identifier to differentiate records with routing policies from one another. Required if using failover, geolocation, latency, or weighted routing policies documented below.

Ttl int

The TTL of the record.

Type interface{}

PRIMARY or SECONDARY. A PRIMARY record will be served if its healthcheck is passing, otherwise the SECONDARY will be served. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.html#dns-failover-failover-rrsets

WeightedRoutingPolicies []RecordWeightedRoutingPolicy

A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.

ZoneId string

Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See resource_elb.zone_id for example.

aliases RecordAlias[]

An alias block. Conflicts with ttl & records. Alias record documented below.

allowOverwrite 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. false by default. This configuration is not recommended for most environments.

failoverRoutingPolicies RecordFailoverRoutingPolicy[]

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.

geolocationRoutingPolicies RecordGeolocationRoutingPolicy[]

A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.

healthCheckId string

The health check the record should be associated with.

latencyRoutingPolicies RecordLatencyRoutingPolicy[]

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.

multivalueAnswerRoutingPolicy boolean

Set to true to 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").

setIdentifier string

Unique identifier to differentiate records with routing policies from one another. Required if using failover, geolocation, latency, or weighted routing policies documented below.

ttl number

The TTL of the record.

type string | RecordType

PRIMARY or SECONDARY. A PRIMARY record will be served if its healthcheck is passing, otherwise the SECONDARY will be served. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.html#dns-failover-failover-rrsets

weightedRoutingPolicies RecordWeightedRoutingPolicy[]

A block indicating a weighted routing policy. Conflicts with any other routing policy. Documented below.

zoneId string

Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See resource_elb.zone_id for example.

aliases List[RecordAlias]

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. false by default. This configuration is not recommended for most environments.

failover_routing_policies List[RecordFailoverRoutingPolicy]

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_policies List[RecordGeolocationRoutingPolicy]

A block indicating a routing policy based on the geolocation of the requestor. Conflicts with any other routing policy. Documented below.

health_check_id str

The health check the record should be associated with.

latency_routing_policies List[RecordLatencyRoutingPolicy]

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_routing_policy bool

Set to true to 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, or weighted routing policies documented below.

ttl float

The TTL of the record.

type string | str

PRIMARY or SECONDARY. A PRIMARY record will be served if its healthcheck is passing, otherwise the SECONDARY will be served. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.html#dns-failover-failover-rrsets

weighted_routing_policies List[RecordWeightedRoutingPolicy]

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_id for example.

Supporting Types

RecordAlias

See the input and output API doc for this type.

See the input and output API doc for this type.

See the input and output API doc for this type.

EvaluateTargetHealth bool

Set to true if 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.

ZoneId string

Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See resource_elb.zone_id for example.

EvaluateTargetHealth bool

Set to true if 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.

ZoneId string

Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See resource_elb.zone_id for example.

evaluateTargetHealth boolean

Set to true if 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.

zoneId string

Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, or Route 53 hosted zone. See resource_elb.zone_id for example.

evaluateTargetHealth bool

Set to true if 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_id for example.

RecordFailoverRoutingPolicy

See the input and output API doc for this type.

See the input and output API doc for this type.

See the input and output API doc for this type.

Type string

PRIMARY or SECONDARY. A PRIMARY record will be served if its healthcheck is passing, otherwise the SECONDARY will be served. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.html#dns-failover-failover-rrsets

Type string

PRIMARY or SECONDARY. A PRIMARY record will be served if its healthcheck is passing, otherwise the SECONDARY will be served. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.html#dns-failover-failover-rrsets

type string

PRIMARY or SECONDARY. A PRIMARY record will be served if its healthcheck is passing, otherwise the SECONDARY will be served. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.html#dns-failover-failover-rrsets

type str

PRIMARY or SECONDARY. A PRIMARY record will be served if its healthcheck is passing, otherwise the SECONDARY will be served. See http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.html#dns-failover-failover-rrsets

RecordGeolocationRoutingPolicy

See the input and output API doc for this type.

See the input and output API doc for this type.

See the input and output API doc for this type.

Continent string

A two-letter continent code. See http://docs.aws.amazon.com/Route53/latest/APIReference/API_GetGeoLocation.html for code details. Either continent or country must 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 continent or country must 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 continent or country must 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 continent or country must 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

See the input and output API doc for this type.

See the input and output API doc for this type.

See the input and output API doc for this type.

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

See the input and output API doc for this type.

See the input and output API doc for this type.

See the input and output API doc for this type.

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 aws Terraform Provider.