AWS v6.71.0, Mar 7 25

AWS v6.71.0 published on Friday, Mar 7, 2025 by Pulumi

aws.route53.Record

Explore with Pulumi AI

AWS v6.71.0 published on Friday, Mar 7, 2025 by Pulumi

pulumi/pulumi-aws

Example Usage

Simple routing policy

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const www = new aws.route53.Record("www", {
    zoneId: primary.zoneId,
    name: "www.example.com",
    type: aws.route53.RecordType.A,
    ttl: 300,
    records: [lb.publicIp],
});

import pulumi
import pulumi_aws as aws

www = aws.route53.Record("www",
    zone_id=primary["zoneId"],
    name="www.example.com",
    type=aws.route53.RecordType.A,
    ttl=300,
    records=[lb["publicIp"]])

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/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(primary.ZoneId),
			Name:   pulumi.String("www.example.com"),
			Type:   pulumi.String(route53.RecordTypeA),
			Ttl:    pulumi.Int(300),
			Records: pulumi.StringArray{
				lb.PublicIp,
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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 = primary.ZoneId,
        Name = "www.example.com",
        Type = Aws.Route53.RecordType.A,
        Ttl = 300,
        Records = new[]
        {
            lb.PublicIp,
        },
    });

});

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(primary.zoneId())
            .name("www.example.com")
            .type("A")
            .ttl(300)
            .records(lb.publicIp())
            .build());

    }
}

resources:
  www:
    type: aws:route53:Record
    properties:
      zoneId: ${primary.zoneId}
      name: www.example.com
      type: A
      ttl: 300
      records:
        - ${lb.publicIp}

Weighted routing policy

Other routing policies are configured similarly. See Amazon Route 53 Developer Guide for details.

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const www_dev = new aws.route53.Record("www-dev", {
    zoneId: primary.zoneId,
    name: "www",
    type: aws.route53.RecordType.CNAME,
    ttl: 5,
    weightedRoutingPolicies: [{
        weight: 10,
    }],
    setIdentifier: "dev",
    records: ["dev.example.com"],
});
const www_live = new aws.route53.Record("www-live", {
    zoneId: primary.zoneId,
    name: "www",
    type: aws.route53.RecordType.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=primary["zoneId"],
    name="www",
    type=aws.route53.RecordType.CNAME,
    ttl=5,
    weighted_routing_policies=[{
        "weight": 10,
    }],
    set_identifier="dev",
    records=["dev.example.com"])
www_live = aws.route53.Record("www-live",
    zone_id=primary["zoneId"],
    name="www",
    type=aws.route53.RecordType.CNAME,
    ttl=5,
    weighted_routing_policies=[{
        "weight": 90,
    }],
    set_identifier="live",
    records=["live.example.com"])

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/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(primary.ZoneId),
			Name:   pulumi.String("www"),
			Type:   pulumi.String(route53.RecordTypeCNAME),
			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(primary.ZoneId),
			Name:   pulumi.String("www"),
			Type:   pulumi.String(route53.RecordTypeCNAME),
			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
	})
}

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 = primary.ZoneId,
        Name = "www",
        Type = Aws.Route53.RecordType.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 = primary.ZoneId,
        Name = "www",
        Type = Aws.Route53.RecordType.CNAME,
        Ttl = 5,
        WeightedRoutingPolicies = new[]
        {
            new Aws.Route53.Inputs.RecordWeightedRoutingPolicyArgs
            {
                Weight = 90,
            },
        },
        SetIdentifier = "live",
        Records = new[]
        {
            "live.example.com",
        },
    });

});

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(primary.zoneId())
            .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(primary.zoneId())
            .name("www")
            .type("CNAME")
            .ttl(5)
            .weightedRoutingPolicies(RecordWeightedRoutingPolicyArgs.builder()
                .weight(90)
                .build())
            .setIdentifier("live")
            .records("live.example.com")
            .build());

    }
}

resources:
  www-dev:
    type: aws:route53:Record
    properties:
      zoneId: ${primary.zoneId}
      name: www
      type: CNAME
      ttl: 5
      weightedRoutingPolicies:
        - weight: 10
      setIdentifier: dev
      records:
        - dev.example.com
  www-live:
    type: aws:route53:Record
    properties:
      zoneId: ${primary.zoneId}
      name: www
      type: CNAME
      ttl: 5
      weightedRoutingPolicies:
        - weight: 90
      setIdentifier: live
      records:
        - live.example.com

Geoproximity routing policy

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const www = new aws.route53.Record("www", {
    zoneId: primary.zoneId,
    name: "www.example.com",
    type: aws.route53.RecordType.CNAME,
    ttl: 300,
    geoproximityRoutingPolicy: {
        coordinates: [{
            latitude: "49.22",
            longitude: "-74.01",
        }],
    },
    setIdentifier: "dev",
    records: ["dev.example.com"],
});

import pulumi
import pulumi_aws as aws

www = aws.route53.Record("www",
    zone_id=primary["zoneId"],
    name="www.example.com",
    type=aws.route53.RecordType.CNAME,
    ttl=300,
    geoproximity_routing_policy={
        "coordinates": [{
            "latitude": "49.22",
            "longitude": "-74.01",
        }],
    },
    set_identifier="dev",
    records=["dev.example.com"])

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/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(primary.ZoneId),
			Name:   pulumi.String("www.example.com"),
			Type:   pulumi.String(route53.RecordTypeCNAME),
			Ttl:    pulumi.Int(300),
			GeoproximityRoutingPolicy: &route53.RecordGeoproximityRoutingPolicyArgs{
				Coordinates: route53.RecordGeoproximityRoutingPolicyCoordinateArray{
					&route53.RecordGeoproximityRoutingPolicyCoordinateArgs{
						Latitude:  pulumi.String("49.22"),
						Longitude: pulumi.String("-74.01"),
					},
				},
			},
			SetIdentifier: pulumi.String("dev"),
			Records: pulumi.StringArray{
				pulumi.String("dev.example.com"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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 = primary.ZoneId,
        Name = "www.example.com",
        Type = Aws.Route53.RecordType.CNAME,
        Ttl = 300,
        GeoproximityRoutingPolicy = new Aws.Route53.Inputs.RecordGeoproximityRoutingPolicyArgs
        {
            Coordinates = new[]
            {
                new Aws.Route53.Inputs.RecordGeoproximityRoutingPolicyCoordinateArgs
                {
                    Latitude = "49.22",
                    Longitude = "-74.01",
                },
            },
        },
        SetIdentifier = "dev",
        Records = new[]
        {
            "dev.example.com",
        },
    });

});

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.RecordGeoproximityRoutingPolicyArgs;
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(primary.zoneId())
            .name("www.example.com")
            .type("CNAME")
            .ttl(300)
            .geoproximityRoutingPolicy(RecordGeoproximityRoutingPolicyArgs.builder()
                .coordinates(RecordGeoproximityRoutingPolicyCoordinateArgs.builder()
                    .latitude("49.22")
                    .longitude("-74.01")
                    .build())
                .build())
            .setIdentifier("dev")
            .records("dev.example.com")
            .build());

    }
}

resources:
  www:
    type: aws:route53:Record
    properties:
      zoneId: ${primary.zoneId}
      name: www.example.com
      type: CNAME
      ttl: 300
      geoproximityRoutingPolicy:
        coordinates:
          - latitude: '49.22'
            longitude: '-74.01'
      setIdentifier: dev
      records:
        - dev.example.com

Alias record

See related part of Amazon Route 53 Developer Guide to understand differences between alias and non-alias records.

TTL for all alias records is 60 seconds, you cannot change this, therefore ttl has to be omitted in alias records.

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const main = new aws.elb.LoadBalancer("main", {
    name: "foobar-elb",
    availabilityZones: ["us-east-1c"],
    listeners: [{
        instancePort: 80,
        instanceProtocol: "http",
        lbPort: 80,
        lbProtocol: "http",
    }],
});
const www = new aws.route53.Record("www", {
    zoneId: primary.zoneId,
    name: "example.com",
    type: aws.route53.RecordType.A,
    aliases: [{
        name: main.dnsName,
        zoneId: main.zoneId,
        evaluateTargetHealth: true,
    }],
});

import pulumi
import pulumi_aws as aws

main = aws.elb.LoadBalancer("main",
    name="foobar-elb",
    availability_zones=["us-east-1c"],
    listeners=[{
        "instance_port": 80,
        "instance_protocol": "http",
        "lb_port": 80,
        "lb_protocol": "http",
    }])
www = aws.route53.Record("www",
    zone_id=primary["zoneId"],
    name="example.com",
    type=aws.route53.RecordType.A,
    aliases=[{
        "name": main.dns_name,
        "zone_id": main.zone_id,
        "evaluate_target_health": True,
    }])

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/elb"
	"github.com/pulumi/pulumi-aws/sdk/v6/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{
			Name: pulumi.String("foobar-elb"),
			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(primary.ZoneId),
			Name:   pulumi.String("example.com"),
			Type:   pulumi.String(route53.RecordTypeA),
			Aliases: route53.RecordAliasArray{
				&route53.RecordAliasArgs{
					Name:                 main.DnsName,
					ZoneId:               main.ZoneId,
					EvaluateTargetHealth: pulumi.Bool(true),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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()
    {
        Name = "foobar-elb",
        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 = primary.ZoneId,
        Name = "example.com",
        Type = Aws.Route53.RecordType.A,
        Aliases = new[]
        {
            new Aws.Route53.Inputs.RecordAliasArgs
            {
                Name = main.DnsName,
                ZoneId = main.ZoneId,
                EvaluateTargetHealth = true,
            },
        },
    });

});

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()
            .name("foobar-elb")
            .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(primary.zoneId())
            .name("example.com")
            .type("A")
            .aliases(RecordAliasArgs.builder()
                .name(main.dnsName())
                .zoneId(main.zoneId())
                .evaluateTargetHealth(true)
                .build())
            .build());

    }
}

resources:
  main:
    type: aws:elb:LoadBalancer
    properties:
      name: foobar-elb
      availabilityZones:
        - us-east-1c
      listeners:
        - instancePort: 80
          instanceProtocol: http
          lbPort: 80
          lbProtocol: http
  www:
    type: aws:route53:Record
    properties:
      zoneId: ${primary.zoneId}
      name: example.com
      type: A
      aliases:
        - name: ${main.dnsName}
          zoneId: ${main.zoneId}
          evaluateTargetHealth: true

Alias record for AWS Global Accelerator

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const main = new aws.globalaccelerator.Accelerator("main", {
    name: "foobar-pulumi-accelerator",
    enabled: true,
    ipAddressType: "IPV4",
});
const www = new aws.route53.Record("www", {
    zoneId: primary.zoneId,
    name: "example.com",
    type: aws.route53.RecordType.A,
    aliases: [{
        name: main.dnsName,
        zoneId: main.hostedZoneId,
        evaluateTargetHealth: false,
    }],
});

import pulumi
import pulumi_aws as aws

main = aws.globalaccelerator.Accelerator("main",
    name="foobar-pulumi-accelerator",
    enabled=True,
    ip_address_type="IPV4")
www = aws.route53.Record("www",
    zone_id=primary["zoneId"],
    name="example.com",
    type=aws.route53.RecordType.A,
    aliases=[{
        "name": main.dns_name,
        "zone_id": main.hosted_zone_id,
        "evaluate_target_health": False,
    }])

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/globalaccelerator"
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/route53"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		main, err := globalaccelerator.NewAccelerator(ctx, "main", &globalaccelerator.AcceleratorArgs{
			Name:          pulumi.String("foobar-pulumi-accelerator"),
			Enabled:       pulumi.Bool(true),
			IpAddressType: pulumi.String("IPV4"),
		})
		if err != nil {
			return err
		}
		_, err = route53.NewRecord(ctx, "www", &route53.RecordArgs{
			ZoneId: pulumi.Any(primary.ZoneId),
			Name:   pulumi.String("example.com"),
			Type:   pulumi.String(route53.RecordTypeA),
			Aliases: route53.RecordAliasArray{
				&route53.RecordAliasArgs{
					Name:                 main.DnsName,
					ZoneId:               main.HostedZoneId,
					EvaluateTargetHealth: pulumi.Bool(false),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var main = new Aws.GlobalAccelerator.Accelerator("main", new()
    {
        Name = "foobar-pulumi-accelerator",
        Enabled = true,
        IpAddressType = "IPV4",
    });

    var www = new Aws.Route53.Record("www", new()
    {
        ZoneId = primary.ZoneId,
        Name = "example.com",
        Type = Aws.Route53.RecordType.A,
        Aliases = new[]
        {
            new Aws.Route53.Inputs.RecordAliasArgs
            {
                Name = main.DnsName,
                ZoneId = main.HostedZoneId,
                EvaluateTargetHealth = false,
            },
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.globalaccelerator.Accelerator;
import com.pulumi.aws.globalaccelerator.AcceleratorArgs;
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 Accelerator("main", AcceleratorArgs.builder()
            .name("foobar-pulumi-accelerator")
            .enabled(true)
            .ipAddressType("IPV4")
            .build());

        var www = new Record("www", RecordArgs.builder()
            .zoneId(primary.zoneId())
            .name("example.com")
            .type("A")
            .aliases(RecordAliasArgs.builder()
                .name(main.dnsName())
                .zoneId(main.hostedZoneId())
                .evaluateTargetHealth(false)
                .build())
            .build());

    }
}

resources:
  main:
    type: aws:globalaccelerator:Accelerator
    properties:
      name: foobar-pulumi-accelerator
      enabled: true
      ipAddressType: IPV4
  www:
    type: aws:route53:Record
    properties:
      zoneId: ${primary.zoneId}
      name: example.com
      type: A
      aliases:
        - name: ${main.dnsName}
          zoneId: ${main.hostedZoneId}
          evaluateTargetHealth: false

NS and SOA Record Management

When creating Route 53 zones, the NS and SOA records for the zone are automatically created. Enabling the allow_overwrite argument will allow managing these records in a single deployment without the requirement for import.

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.route53.Zone("example", {name: "test.example.com"});
const exampleRecord = new aws.route53.Record("example", {
    allowOverwrite: true,
    name: "test.example.com",
    ttl: 172800,
    type: aws.route53.RecordType.NS,
    zoneId: example.zoneId,
    records: [
        example.nameServers[0],
        example.nameServers[1],
        example.nameServers[2],
        example.nameServers[3],
    ],
});

import pulumi
import pulumi_aws as aws

example = aws.route53.Zone("example", name="test.example.com")
example_record = aws.route53.Record("example",
    allow_overwrite=True,
    name="test.example.com",
    ttl=172800,
    type=aws.route53.RecordType.NS,
    zone_id=example.zone_id,
    records=[
        example.name_servers[0],
        example.name_servers[1],
        example.name_servers[2],
        example.name_servers[3],
    ])

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/route53"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := route53.NewZone(ctx, "example", &route53.ZoneArgs{
			Name: pulumi.String("test.example.com"),
		})
		if err != nil {
			return err
		}
		_, err = route53.NewRecord(ctx, "example", &route53.RecordArgs{
			AllowOverwrite: pulumi.Bool(true),
			Name:           pulumi.String("test.example.com"),
			Ttl:            pulumi.Int(172800),
			Type:           pulumi.String(route53.RecordTypeNS),
			ZoneId:         example.ZoneId,
			Records: pulumi.StringArray{
				example.NameServers.ApplyT(func(nameServers []string) (string, error) {
					return nameServers[0], nil
				}).(pulumi.StringOutput),
				example.NameServers.ApplyT(func(nameServers []string) (string, error) {
					return nameServers[1], nil
				}).(pulumi.StringOutput),
				example.NameServers.ApplyT(func(nameServers []string) (string, error) {
					return nameServers[2], nil
				}).(pulumi.StringOutput),
				example.NameServers.ApplyT(func(nameServers []string) (string, error) {
					return nameServers[3], nil
				}).(pulumi.StringOutput),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = new Aws.Route53.Zone("example", new()
    {
        Name = "test.example.com",
    });

    var exampleRecord = new Aws.Route53.Record("example", new()
    {
        AllowOverwrite = true,
        Name = "test.example.com",
        Ttl = 172800,
        Type = Aws.Route53.RecordType.NS,
        ZoneId = example.ZoneId,
        Records = new[]
        {
            example.NameServers.Apply(nameServers => nameServers[0]),
            example.NameServers.Apply(nameServers => nameServers[1]),
            example.NameServers.Apply(nameServers => nameServers[2]),
            example.NameServers.Apply(nameServers => nameServers[3]),
        },
    });

});

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.ZoneArgs;
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 example = new Zone("example", ZoneArgs.builder()
            .name("test.example.com")
            .build());

        var exampleRecord = new Record("exampleRecord", RecordArgs.builder()
            .allowOverwrite(true)
            .name("test.example.com")
            .ttl(172800)
            .type("NS")
            .zoneId(example.zoneId())
            .records(            
                example.nameServers().applyValue(nameServers -> nameServers[0]),
                example.nameServers().applyValue(nameServers -> nameServers[1]),
                example.nameServers().applyValue(nameServers -> nameServers[2]),
                example.nameServers().applyValue(nameServers -> nameServers[3]))
            .build());

    }
}

resources:
  example:
    type: aws:route53:Zone
    properties:
      name: test.example.com
  exampleRecord:
    type: aws:route53:Record
    name: example
    properties:
      allowOverwrite: true
      name: test.example.com
      ttl: 172800
      type: NS
      zoneId: ${example.zoneId}
      records:
        - ${example.nameServers[0]}
        - ${example.nameServers[1]}
        - ${example.nameServers[2]}
        - ${example.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,
           multivalue_answer_routing_policy: Optional[bool] = None,
           geolocation_routing_policies: Optional[Sequence[RecordGeolocationRoutingPolicyArgs]] = None,
           geoproximity_routing_policy: Optional[RecordGeoproximityRoutingPolicyArgs] = None,
           health_check_id: Optional[str] = None,
           latency_routing_policies: Optional[Sequence[RecordLatencyRoutingPolicyArgs]] = None,
           aliases: Optional[Sequence[RecordAliasArgs]] = 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",
    MultivalueAnswerRoutingPolicy = false,
    GeolocationRoutingPolicies = new[]
    {
        new Aws.Route53.Inputs.RecordGeolocationRoutingPolicyArgs
        {
            Continent = "string",
            Country = "string",
            Subdivision = "string",
        },
    },
    GeoproximityRoutingPolicy = new Aws.Route53.Inputs.RecordGeoproximityRoutingPolicyArgs
    {
        AwsRegion = "string",
        Bias = 0,
        Coordinates = new[]
        {
            new Aws.Route53.Inputs.RecordGeoproximityRoutingPolicyCoordinateArgs
            {
                Latitude = "string",
                Longitude = "string",
            },
        },
        LocalZoneGroup = "string",
    },
    HealthCheckId = "string",
    LatencyRoutingPolicies = new[]
    {
        new Aws.Route53.Inputs.RecordLatencyRoutingPolicyArgs
        {
            Region = "string",
        },
    },
    Aliases = new[]
    {
        new Aws.Route53.Inputs.RecordAliasArgs
        {
            EvaluateTargetHealth = false,
            Name = "string",
            ZoneId = "string",
        },
    },
    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"),
	MultivalueAnswerRoutingPolicy: pulumi.Bool(false),
	GeolocationRoutingPolicies: route53.RecordGeolocationRoutingPolicyArray{
		&route53.RecordGeolocationRoutingPolicyArgs{
			Continent:   pulumi.String("string"),
			Country:     pulumi.String("string"),
			Subdivision: pulumi.String("string"),
		},
	},
	GeoproximityRoutingPolicy: &route53.RecordGeoproximityRoutingPolicyArgs{
		AwsRegion: pulumi.String("string"),
		Bias:      pulumi.Int(0),
		Coordinates: route53.RecordGeoproximityRoutingPolicyCoordinateArray{
			&route53.RecordGeoproximityRoutingPolicyCoordinateArgs{
				Latitude:  pulumi.String("string"),
				Longitude: pulumi.String("string"),
			},
		},
		LocalZoneGroup: pulumi.String("string"),
	},
	HealthCheckId: pulumi.String("string"),
	LatencyRoutingPolicies: route53.RecordLatencyRoutingPolicyArray{
		&route53.RecordLatencyRoutingPolicyArgs{
			Region: pulumi.String("string"),
		},
	},
	Aliases: route53.RecordAliasArray{
		&route53.RecordAliasArgs{
			EvaluateTargetHealth: pulumi.Bool(false),
			Name:                 pulumi.String("string"),
			ZoneId:               pulumi.String("string"),
		},
	},
	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")
    .multivalueAnswerRoutingPolicy(false)
    .geolocationRoutingPolicies(RecordGeolocationRoutingPolicyArgs.builder()
        .continent("string")
        .country("string")
        .subdivision("string")
        .build())
    .geoproximityRoutingPolicy(RecordGeoproximityRoutingPolicyArgs.builder()
        .awsRegion("string")
        .bias(0)
        .coordinates(RecordGeoproximityRoutingPolicyCoordinateArgs.builder()
            .latitude("string")
            .longitude("string")
            .build())
        .localZoneGroup("string")
        .build())
    .healthCheckId("string")
    .latencyRoutingPolicies(RecordLatencyRoutingPolicyArgs.builder()
        .region("string")
        .build())
    .aliases(RecordAliasArgs.builder()
        .evaluateTargetHealth(false)
        .name("string")
        .zoneId("string")
        .build())
    .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",
    multivalue_answer_routing_policy=False,
    geolocation_routing_policies=[{
        "continent": "string",
        "country": "string",
        "subdivision": "string",
    }],
    geoproximity_routing_policy={
        "aws_region": "string",
        "bias": 0,
        "coordinates": [{
            "latitude": "string",
            "longitude": "string",
        }],
        "local_zone_group": "string",
    },
    health_check_id="string",
    latency_routing_policies=[{
        "region": "string",
    }],
    aliases=[{
        "evaluate_target_health": False,
        "name": "string",
        "zone_id": "string",
    }],
    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",
    multivalueAnswerRoutingPolicy: false,
    geolocationRoutingPolicies: [{
        continent: "string",
        country: "string",
        subdivision: "string",
    }],
    geoproximityRoutingPolicy: {
        awsRegion: "string",
        bias: 0,
        coordinates: [{
            latitude: "string",
            longitude: "string",
        }],
        localZoneGroup: "string",
    },
    healthCheckId: "string",
    latencyRoutingPolicies: [{
        region: "string",
    }],
    aliases: [{
        evaluateTargetHealth: false,
        name: "string",
        zoneId: "string",
    }],
    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
    geoproximityRoutingPolicy:
        awsRegion: string
        bias: 0
        coordinates:
            - latitude: string
              longitude: string
        localZoneGroup: 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.RecordType

The record type. Valid values are A, AAAA, CAA, CNAME, DS, MX, NAPTR, NS, PTR, SOA, SPF, SRV and TXT.

ZoneId string

The ID of the hosted zone to contain this record.

Aliases List<RecordAlias>

An alias block. Conflicts with ttl & records. 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.

Exactly one of records or alias must be specified: this determines whether it's an alias record.

CidrRoutingPolicy RecordCidrRoutingPolicy

A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.

FailoverRoutingPolicies List<RecordFailoverRoutingPolicy>

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

GeolocationRoutingPolicies List<RecordGeolocationRoutingPolicy>

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

GeoproximityRoutingPolicy RecordGeoproximityRoutingPolicy

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

HealthCheckId string

The health check the record should be associated with.

LatencyRoutingPolicies 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.

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 provider configuration string (e.g., "first255characters\"\"morecharacters").

SetIdentifier string

Unique identifier to differentiate records with routing policies from one another. Required if using cidr_routing_policy, failover_routing_policy, geolocation_routing_policy,geoproximity_routing_policy, latency_routing_policy, multivalue_answer_routing_policy, or weighted_routing_policy.

Ttl int

The TTL of the record.

WeightedRoutingPolicies List<RecordWeightedRoutingPolicy>

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

Name string

The name of the record.

Type string | RecordType

The record type. Valid values are A, AAAA, CAA, CNAME, DS, MX, NAPTR, NS, PTR, SOA, SPF, SRV and TXT.

ZoneId string

The ID of the hosted zone to contain this record.

Aliases []RecordAliasArgs

An alias block. Conflicts with ttl & records. Documented below.

AllowOverwrite bool

Exactly one of records or alias must be specified: this determines whether it's an alias record.

CidrRoutingPolicy RecordCidrRoutingPolicyArgs

A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.

FailoverRoutingPolicies []RecordFailoverRoutingPolicyArgs

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

GeolocationRoutingPolicies []RecordGeolocationRoutingPolicyArgs

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

GeoproximityRoutingPolicy RecordGeoproximityRoutingPolicyArgs

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

HealthCheckId string

The health check the record should be associated with.

LatencyRoutingPolicies []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 []string

SetIdentifier string

Ttl int

The TTL of the record.

WeightedRoutingPolicies []RecordWeightedRoutingPolicyArgs

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

name String

The name of the record.

type String | RecordType

The record type. Valid values are A, AAAA, CAA, CNAME, DS, MX, NAPTR, NS, PTR, SOA, SPF, SRV and TXT.

zoneId String

The ID of the hosted zone to contain this record.

aliases List<RecordAlias>

An alias block. Conflicts with ttl & records. Documented below.

allowOverwrite Boolean

Exactly one of records or alias must be specified: this determines whether it's an alias record.

cidrRoutingPolicy RecordCidrRoutingPolicy

A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.

failoverRoutingPolicies List<RecordFailoverRoutingPolicy>

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

geolocationRoutingPolicies List<RecordGeolocationRoutingPolicy>

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

geoproximityRoutingPolicy RecordGeoproximityRoutingPolicy

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

healthCheckId String

The health check the record should be associated with.

latencyRoutingPolicies 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.

multivalueAnswerRoutingPolicy Boolean

Set to true to indicate a multivalue answer routing policy. Conflicts with any other routing policy.

records List<String>

setIdentifier String

ttl Integer

The TTL of the record.

weightedRoutingPolicies List<RecordWeightedRoutingPolicy>

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

name string

The name of the record.

type string | RecordType

The record type. Valid values are A, AAAA, CAA, CNAME, DS, MX, NAPTR, NS, PTR, SOA, SPF, SRV and TXT.

zoneId string

The ID of the hosted zone to contain this record.

aliases RecordAlias[]

An alias block. Conflicts with ttl & records. Documented below.

allowOverwrite boolean

Exactly one of records or alias must be specified: this determines whether it's an alias record.

cidrRoutingPolicy RecordCidrRoutingPolicy

A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.

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.

geoproximityRoutingPolicy RecordGeoproximityRoutingPolicy

A block indicating a routing policy based on the geoproximity 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[]

setIdentifier string

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

The name of the record.

type str | RecordType

The record type. Valid values are A, AAAA, CAA, CNAME, DS, MX, NAPTR, NS, PTR, SOA, SPF, SRV and TXT.

zone_id str

The ID of the hosted zone to contain this record.

aliases Sequence[RecordAliasArgs]

An alias block. Conflicts with ttl & records. Documented below.

allow_overwrite bool

Exactly one of records or alias must be specified: this determines whether it's an alias record.

cidr_routing_policy RecordCidrRoutingPolicyArgs

A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.

failover_routing_policies Sequence[RecordFailoverRoutingPolicyArgs]

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

geolocation_routing_policies Sequence[RecordGeolocationRoutingPolicyArgs]

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

geoproximity_routing_policy RecordGeoproximityRoutingPolicyArgs

A block indicating a routing policy based on the geoproximity 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 Sequence[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.

multivalue_answer_routing_policy bool

Set to true to indicate a multivalue answer routing policy. Conflicts with any other routing policy.

records Sequence[str]

set_identifier str

ttl int

The TTL of the record.

weighted_routing_policies Sequence[RecordWeightedRoutingPolicyArgs]

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, SRV and TXT.

zoneId String

The ID of the hosted zone to contain this record.

aliases List<Property Map>

An alias block. Conflicts with ttl & records. Documented below.

allowOverwrite Boolean

Exactly one of records or alias must be specified: this determines whether it's an alias record.

cidrRoutingPolicy Property Map

A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.

failoverRoutingPolicies List<Property Map>

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

geolocationRoutingPolicies List<Property Map>

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

geoproximityRoutingPolicy Property Map

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

healthCheckId String

The health check the record should be associated with.

latencyRoutingPolicies List<Property Map>

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 List<String>

setIdentifier String

ttl Number

The TTL of the record.

weightedRoutingPolicies List<Property Map>

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

fqdn String: FQDN built using the zone domain and name.
id String: The provider-assigned unique ID for this managed resource.

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,
        geoproximity_routing_policy: Optional[RecordGeoproximityRoutingPolicyArgs] = 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) -> Record

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)

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.

The following state arguments are supported:

Aliases List<RecordAlias>

An alias block. Conflicts with ttl & records. Documented below.

AllowOverwrite bool

Exactly one of records or alias must be specified: this determines whether it's an alias record.

CidrRoutingPolicy RecordCidrRoutingPolicy

A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.

FailoverRoutingPolicies List<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 List<RecordGeolocationRoutingPolicy>

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

GeoproximityRoutingPolicy RecordGeoproximityRoutingPolicy

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

HealthCheckId string

The health check the record should be associated with.

LatencyRoutingPolicies 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.

MultivalueAnswerRoutingPolicy bool

Set to true to indicate a multivalue answer routing policy. Conflicts with any other routing policy.

Name string

The name of the record.

Records List<string>

SetIdentifier string

Ttl int

The TTL of the record.

Type string | Pulumi.Aws.Route53.RecordType

The record type. Valid values are A, AAAA, CAA, CNAME, DS, MX, NAPTR, NS, PTR, SOA, SPF, SRV and TXT.

WeightedRoutingPolicies List<RecordWeightedRoutingPolicy>

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

ZoneId string

The ID of the hosted zone to contain this record.

Aliases []RecordAliasArgs

An alias block. Conflicts with ttl & records. Documented below.

AllowOverwrite bool

Exactly one of records or alias must be specified: this determines whether it's an alias record.

CidrRoutingPolicy RecordCidrRoutingPolicyArgs

A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.

FailoverRoutingPolicies []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 []RecordGeolocationRoutingPolicyArgs

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

GeoproximityRoutingPolicy RecordGeoproximityRoutingPolicyArgs

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

HealthCheckId string

The health check the record should be associated with.

LatencyRoutingPolicies []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

The name of the record.

Records []string

SetIdentifier string

Ttl int

The TTL of the record.

Type string | RecordType

The record type. Valid values are A, AAAA, CAA, CNAME, DS, MX, NAPTR, NS, PTR, SOA, SPF, SRV and TXT.

WeightedRoutingPolicies []RecordWeightedRoutingPolicyArgs

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

ZoneId string

The ID of the hosted zone to contain this record.

aliases List<RecordAlias>

An alias block. Conflicts with ttl & records. Documented below.

allowOverwrite Boolean

Exactly one of records or alias must be specified: this determines whether it's an alias record.

cidrRoutingPolicy RecordCidrRoutingPolicy

A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.

failoverRoutingPolicies List<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 List<RecordGeolocationRoutingPolicy>

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

geoproximityRoutingPolicy RecordGeoproximityRoutingPolicy

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

healthCheckId String

The health check the record should be associated with.

latencyRoutingPolicies 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.

multivalueAnswerRoutingPolicy Boolean

Set to true to indicate a multivalue answer routing policy. Conflicts with any other routing policy.

name String

The name of the record.

records List<String>

setIdentifier String

ttl Integer

The TTL of the record.

type String | RecordType

The record type. Valid values are A, AAAA, CAA, CNAME, DS, MX, NAPTR, NS, PTR, SOA, SPF, SRV and TXT.

weightedRoutingPolicies List<RecordWeightedRoutingPolicy>

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

zoneId String

The ID of the hosted zone to contain this record.

aliases RecordAlias[]

An alias block. Conflicts with ttl & records. Documented below.

allowOverwrite boolean

Exactly one of records or alias must be specified: this determines whether it's an alias record.

cidrRoutingPolicy RecordCidrRoutingPolicy

A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.

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.

geoproximityRoutingPolicy RecordGeoproximityRoutingPolicy

A block indicating a routing policy based on the geoproximity 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

The name of the record.

records string[]

setIdentifier string

ttl number

The TTL of the record.

type string | RecordType

The record type. Valid values are A, AAAA, CAA, CNAME, DS, MX, NAPTR, NS, PTR, SOA, SPF, SRV and TXT.

weightedRoutingPolicies RecordWeightedRoutingPolicy[]

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

zoneId string

The ID of the hosted zone to contain this record.

aliases Sequence[RecordAliasArgs]

An alias block. Conflicts with ttl & records. Documented below.

allow_overwrite bool

Exactly one of records or alias must be specified: this determines whether it's an alias record.

cidr_routing_policy RecordCidrRoutingPolicyArgs

A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.

failover_routing_policies Sequence[RecordFailoverRoutingPolicyArgs]

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 Sequence[RecordGeolocationRoutingPolicyArgs]

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

geoproximity_routing_policy RecordGeoproximityRoutingPolicyArgs

A block indicating a routing policy based on the geoproximity 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 Sequence[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.

multivalue_answer_routing_policy bool

Set to true to indicate a multivalue answer routing policy. Conflicts with any other routing policy.

name str

The name of the record.

records Sequence[str]

set_identifier str

ttl int

The TTL of the record.

type str | RecordType

The record type. Valid values are A, AAAA, CAA, CNAME, DS, MX, NAPTR, NS, PTR, SOA, SPF, SRV and TXT.

weighted_routing_policies Sequence[RecordWeightedRoutingPolicyArgs]

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.

allowOverwrite Boolean

Exactly one of records or alias must be specified: this determines whether it's an alias record.

cidrRoutingPolicy Property Map

A block indicating a routing policy based on the IP network ranges of requestors. Conflicts with any other routing policy. Documented below.

failoverRoutingPolicies List<Property Map>

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<Property Map>

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

geoproximityRoutingPolicy Property Map

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

healthCheckId String

The health check the record should be associated with.

latencyRoutingPolicies List<Property Map>

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

The name of the record.

records List<String>

setIdentifier String

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, SRV and TXT.

weightedRoutingPolicies List<Property Map>

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

zoneId String

The ID of the hosted zone to contain this record.

Supporting Types

RecordAlias, RecordAliasArgs

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, AWS Global Accelerator, or another resource record set in this hosted zone.
ZoneId string: Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, AWS Global Accelerator, 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, AWS Global Accelerator, or another resource record set in this hosted zone.
ZoneId string: Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, AWS Global Accelerator, 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, AWS Global Accelerator, or another resource record set in this hosted zone.
zoneId String: Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, AWS Global Accelerator, 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, AWS Global Accelerator, or another resource record set in this hosted zone.
zoneId string: Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, AWS Global Accelerator, or Route 53 hosted zone. See resource_elb.zone_id for example.

evaluate_target_health 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, AWS Global Accelerator, or another resource record set in this hosted zone.
zone_id str: Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, AWS Global Accelerator, 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, AWS Global Accelerator, or another resource record set in this hosted zone.
zoneId String: Hosted zone ID for a CloudFront distribution, S3 bucket, ELB, AWS Global Accelerator, or Route 53 hosted zone. See resource_elb.zone_id for example.

RecordCidrRoutingPolicy, RecordCidrRoutingPolicyArgs

CollectionId string: The CIDR collection ID. See the aws.route53.CidrCollection resource for more details.
LocationName string: The CIDR collection location name. See the aws.route53.CidrLocation resource for more details. A location_name with an asterisk "*" can be used to create a default CIDR record. collection_id is still required for default record.

CollectionId string: The CIDR collection ID. See the aws.route53.CidrCollection resource for more details.
LocationName string: The CIDR collection location name. See the aws.route53.CidrLocation resource for more details. A location_name with an asterisk "*" can be used to create a default CIDR record. collection_id is still required for default record.

collectionId String: The CIDR collection ID. See the aws.route53.CidrCollection resource for more details.
locationName String: The CIDR collection location name. See the aws.route53.CidrLocation resource for more details. A location_name with an asterisk "*" can be used to create a default CIDR record. collection_id is still required for default record.

collectionId string: The CIDR collection ID. See the aws.route53.CidrCollection resource for more details.
locationName string: The CIDR collection location name. See the aws.route53.CidrLocation resource for more details. A location_name with an asterisk "*" can be used to create a default CIDR record. collection_id is still required for default record.

collection_id str: The CIDR collection ID. See the aws.route53.CidrCollection resource for more details.
location_name str: The CIDR collection location name. See the aws.route53.CidrLocation resource for more details. A location_name with an asterisk "*" can be used to create a default CIDR record. collection_id is still required for default record.

collectionId String: The CIDR collection ID. See the aws.route53.CidrCollection resource for more details.
locationName String: The CIDR collection location name. See the aws.route53.CidrLocation resource for more details. A location_name with an asterisk "*" can be used to create a default CIDR record. collection_id is still required for default record.

RecordFailoverRoutingPolicy, RecordFailoverRoutingPolicyArgs

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

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

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

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.

RecordGeoproximityRoutingPolicy, RecordGeoproximityRoutingPolicyArgs

AwsRegion string: A AWS region where the resource is present.
Bias int: Route more traffic or less traffic to the resource by specifying a value ranges between -90 to 90. See https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy-geoproximity.html for bias details.
Coordinates List<RecordGeoproximityRoutingPolicyCoordinate>: Specify latitude and longitude for routing traffic to non-AWS resources.
LocalZoneGroup string: A AWS local zone group where the resource is present. See https://docs.aws.amazon.com/local-zones/latest/ug/available-local-zones.html for local zone group list.

AwsRegion string: A AWS region where the resource is present.
Bias int: Route more traffic or less traffic to the resource by specifying a value ranges between -90 to 90. See https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy-geoproximity.html for bias details.
Coordinates []RecordGeoproximityRoutingPolicyCoordinate: Specify latitude and longitude for routing traffic to non-AWS resources.
LocalZoneGroup string: A AWS local zone group where the resource is present. See https://docs.aws.amazon.com/local-zones/latest/ug/available-local-zones.html for local zone group list.

awsRegion String: A AWS region where the resource is present.
bias Integer: Route more traffic or less traffic to the resource by specifying a value ranges between -90 to 90. See https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy-geoproximity.html for bias details.
coordinates List<RecordGeoproximityRoutingPolicyCoordinate>: Specify latitude and longitude for routing traffic to non-AWS resources.
localZoneGroup String: A AWS local zone group where the resource is present. See https://docs.aws.amazon.com/local-zones/latest/ug/available-local-zones.html for local zone group list.

awsRegion string: A AWS region where the resource is present.
bias number: Route more traffic or less traffic to the resource by specifying a value ranges between -90 to 90. See https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy-geoproximity.html for bias details.
coordinates RecordGeoproximityRoutingPolicyCoordinate[]: Specify latitude and longitude for routing traffic to non-AWS resources.
localZoneGroup string: A AWS local zone group where the resource is present. See https://docs.aws.amazon.com/local-zones/latest/ug/available-local-zones.html for local zone group list.

aws_region str: A AWS region where the resource is present.
bias int: Route more traffic or less traffic to the resource by specifying a value ranges between -90 to 90. See https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy-geoproximity.html for bias details.
coordinates Sequence[RecordGeoproximityRoutingPolicyCoordinate]: Specify latitude and longitude for routing traffic to non-AWS resources.
local_zone_group str: A AWS local zone group where the resource is present. See https://docs.aws.amazon.com/local-zones/latest/ug/available-local-zones.html for local zone group list.

awsRegion String: A AWS region where the resource is present.
bias Number: Route more traffic or less traffic to the resource by specifying a value ranges between -90 to 90. See https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy-geoproximity.html for bias details.
coordinates List<Property Map>: Specify latitude and longitude for routing traffic to non-AWS resources.
localZoneGroup String: A AWS local zone group where the resource is present. See https://docs.aws.amazon.com/local-zones/latest/ug/available-local-zones.html for local zone group list.

RecordGeoproximityRoutingPolicyCoordinate, RecordGeoproximityRoutingPolicyCoordinateArgs

Latitude string
Longitude string

Latitude string
Longitude string

latitude String
longitude String

latitude string
longitude string

latitude str
longitude str

latitude String
longitude String

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

RecordTypeA: A
RecordTypeAAAA: AAAA
RecordTypeCNAME: CNAME
RecordTypeCAA: CAA
RecordTypeMX: MX
RecordTypeNAPTR: NAPTR
RecordTypeNS: NS
RecordTypePTR: PTR
RecordTypeSOA: SOA
RecordTypeSPF: SPF
RecordTypeSRV: SRV
RecordTypeTXT: 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

If the record also contains a set identifier, append it:

If the record name is the empty string, it can be omitted:

Using pulumi import to import Route53 Records using the ID of the record, record name, record type, and set identifier. For example:

Using the ID of the record, which is the zone identifier, record name, and record type, separated by underscores (_):

$ pulumi import aws:route53/record:Record myrecord Z4KAPRWWNC7JR_dev_NS

If the record also contains a set identifier, append it:

$ pulumi import aws:route53/record:Record myrecord Z4KAPRWWNC7JR_dev_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 aws Terraform Provider.

AWS v6.71.0 published on Friday, Mar 7, 2025 by Pulumi

pulumi/pulumi-aws

aws.route53.Record

On this page

On this page

Example Usage

Simple routing policy

Weighted routing policy

Geoproximity routing policy

Alias record

Alias record for AWS Global Accelerator

NS and SOA Record Management

Create Record Resource

Constructor syntax

Parameters

Constructor example

Record Resource Properties

Inputs

Outputs

Look up Existing Record Resource

Supporting Types

RecordAlias, RecordAliasArgs

RecordCidrRoutingPolicy, RecordCidrRoutingPolicyArgs

RecordFailoverRoutingPolicy, RecordFailoverRoutingPolicyArgs

RecordGeolocationRoutingPolicy, RecordGeolocationRoutingPolicyArgs

RecordGeoproximityRoutingPolicy, RecordGeoproximityRoutingPolicyArgs

RecordGeoproximityRoutingPolicyCoordinate, RecordGeoproximityRoutingPolicyCoordinateArgs

RecordLatencyRoutingPolicy, RecordLatencyRoutingPolicyArgs

RecordType, RecordTypeArgs

RecordWeightedRoutingPolicy, RecordWeightedRoutingPolicyArgs

Import

Package Details

On this page

On this page