AWS Classic v6.2.1, Sep 22 23

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.2.1 published on Friday, Sep 22, 2023 by Pulumi

pulumi/pulumi-aws

aws.route53.Record

Explore with Pulumi AI

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.2.1 published on Friday, Sep 22, 2023 by Pulumi

pulumi/pulumi-aws

Example Usage

Simple routing policy

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

return await Deployment.RunAsync(() => 
{
    var www = new Aws.Route53.Record("www", new()
    {
        ZoneId = aws_route53_zone.Primary.Zone_id,
        Name = "www.example.com",
        Type = "A",
        Ttl = 300,
        Records = new[]
        {
            aws_eip.Lb.Public_ip,
        },
    });

});

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/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(aws_route53_zone.Primary.Zone_id),
			Name:   pulumi.String("www.example.com"),
			Type:   pulumi.String("A"),
			Ttl:    pulumi.Int(300),
			Records: pulumi.StringArray{
				aws_eip.Lb.Public_ip,
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.route53.Record;
import com.pulumi.aws.route53.RecordArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var www = new Record("www", RecordArgs.builder()        
            .zoneId(aws_route53_zone.primary().zone_id())
            .name("www.example.com")
            .type("A")
            .ttl(300)
            .records(aws_eip.lb().public_ip())
            .build());

    }
}

import pulumi
import pulumi_aws as aws

www = aws.route53.Record("www",
    zone_id=aws_route53_zone["primary"]["zone_id"],
    name="www.example.com",
    type="A",
    ttl=300,
    records=[aws_eip["lb"]["public_ip"]])

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

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

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

Weighted routing policy

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

return await Deployment.RunAsync(() => 
{
    var www_dev = new Aws.Route53.Record("www-dev", new()
    {
        ZoneId = aws_route53_zone.Primary.Zone_id,
        Name = "www",
        Type = "CNAME",
        Ttl = 5,
        WeightedRoutingPolicies = new[]
        {
            new Aws.Route53.Inputs.RecordWeightedRoutingPolicyArgs
            {
                Weight = 10,
            },
        },
        SetIdentifier = "dev",
        Records = new[]
        {
            "dev.example.com",
        },
    });

    var www_live = new Aws.Route53.Record("www-live", new()
    {
        ZoneId = aws_route53_zone.Primary.Zone_id,
        Name = "www",
        Type = "CNAME",
        Ttl = 5,
        WeightedRoutingPolicies = new[]
        {
            new Aws.Route53.Inputs.RecordWeightedRoutingPolicyArgs
            {
                Weight = 90,
            },
        },
        SetIdentifier = "live",
        Records = new[]
        {
            "live.example.com",
        },
    });

});

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/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(aws_route53_zone.Primary.Zone_id),
			Name:   pulumi.String("www"),
			Type:   pulumi.String("CNAME"),
			Ttl:    pulumi.Int(5),
			WeightedRoutingPolicies: route53.RecordWeightedRoutingPolicyArray{
				&route53.RecordWeightedRoutingPolicyArgs{
					Weight: pulumi.Int(10),
				},
			},
			SetIdentifier: pulumi.String("dev"),
			Records: pulumi.StringArray{
				pulumi.String("dev.example.com"),
			},
		})
		if err != nil {
			return err
		}
		_, err = route53.NewRecord(ctx, "www-live", &route53.RecordArgs{
			ZoneId: pulumi.Any(aws_route53_zone.Primary.Zone_id),
			Name:   pulumi.String("www"),
			Type:   pulumi.String("CNAME"),
			Ttl:    pulumi.Int(5),
			WeightedRoutingPolicies: route53.RecordWeightedRoutingPolicyArray{
				&route53.RecordWeightedRoutingPolicyArgs{
					Weight: pulumi.Int(90),
				},
			},
			SetIdentifier: pulumi.String("live"),
			Records: pulumi.StringArray{
				pulumi.String("live.example.com"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.route53.Record;
import com.pulumi.aws.route53.RecordArgs;
import com.pulumi.aws.route53.inputs.RecordWeightedRoutingPolicyArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var www_dev = new Record("www-dev", RecordArgs.builder()        
            .zoneId(aws_route53_zone.primary().zone_id())
            .name("www")
            .type("CNAME")
            .ttl(5)
            .weightedRoutingPolicies(RecordWeightedRoutingPolicyArgs.builder()
                .weight(10)
                .build())
            .setIdentifier("dev")
            .records("dev.example.com")
            .build());

        var www_live = new Record("www-live", RecordArgs.builder()        
            .zoneId(aws_route53_zone.primary().zone_id())
            .name("www")
            .type("CNAME")
            .ttl(5)
            .weightedRoutingPolicies(RecordWeightedRoutingPolicyArgs.builder()
                .weight(90)
                .build())
            .setIdentifier("live")
            .records("live.example.com")
            .build());

    }
}

import pulumi
import pulumi_aws as aws

www_dev = aws.route53.Record("www-dev",
    zone_id=aws_route53_zone["primary"]["zone_id"],
    name="www",
    type="CNAME",
    ttl=5,
    weighted_routing_policies=[aws.route53.RecordWeightedRoutingPolicyArgs(
        weight=10,
    )],
    set_identifier="dev",
    records=["dev.example.com"])
www_live = aws.route53.Record("www-live",
    zone_id=aws_route53_zone["primary"]["zone_id"],
    name="www",
    type="CNAME",
    ttl=5,
    weighted_routing_policies=[aws.route53.RecordWeightedRoutingPolicyArgs(
        weight=90,
    )],
    set_identifier="live",
    records=["live.example.com"])

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

const www_dev = new aws.route53.Record("www-dev", {
    zoneId: aws_route53_zone.primary.zone_id,
    name: "www",
    type: "CNAME",
    ttl: 5,
    weightedRoutingPolicies: [{
        weight: 10,
    }],
    setIdentifier: "dev",
    records: ["dev.example.com"],
});
const www_live = new aws.route53.Record("www-live", {
    zoneId: aws_route53_zone.primary.zone_id,
    name: "www",
    type: "CNAME",
    ttl: 5,
    weightedRoutingPolicies: [{
        weight: 90,
    }],
    setIdentifier: "live",
    records: ["live.example.com"],
});

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

Alias record

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

return await Deployment.RunAsync(() => 
{
    var main = new Aws.Elb.LoadBalancer("main", new()
    {
        AvailabilityZones = new[]
        {
            "us-east-1c",
        },
        Listeners = new[]
        {
            new Aws.Elb.Inputs.LoadBalancerListenerArgs
            {
                InstancePort = 80,
                InstanceProtocol = "http",
                LbPort = 80,
                LbProtocol = "http",
            },
        },
    });

    var www = new Aws.Route53.Record("www", new()
    {
        ZoneId = aws_route53_zone.Primary.Zone_id,
        Name = "example.com",
        Type = "A",
        Aliases = new[]
        {
            new Aws.Route53.Inputs.RecordAliasArgs
            {
                Name = main.DnsName,
                ZoneId = main.ZoneId,
                EvaluateTargetHealth = true,
            },
        },
    });

});

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/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{
			AvailabilityZones: pulumi.StringArray{
				pulumi.String("us-east-1c"),
			},
			Listeners: elb.LoadBalancerListenerArray{
				&elb.LoadBalancerListenerArgs{
					InstancePort:     pulumi.Int(80),
					InstanceProtocol: pulumi.String("http"),
					LbPort:           pulumi.Int(80),
					LbProtocol:       pulumi.String("http"),
				},
			},
		})
		if err != nil {
			return err
		}
		_, err = route53.NewRecord(ctx, "www", &route53.RecordArgs{
			ZoneId: pulumi.Any(aws_route53_zone.Primary.Zone_id),
			Name:   pulumi.String("example.com"),
			Type:   pulumi.String("A"),
			Aliases: route53.RecordAliasArray{
				&route53.RecordAliasArgs{
					Name:                 main.DnsName,
					ZoneId:               main.ZoneId,
					EvaluateTargetHealth: pulumi.Bool(true),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.elb.LoadBalancer;
import com.pulumi.aws.elb.LoadBalancerArgs;
import com.pulumi.aws.elb.inputs.LoadBalancerListenerArgs;
import com.pulumi.aws.route53.Record;
import com.pulumi.aws.route53.RecordArgs;
import com.pulumi.aws.route53.inputs.RecordAliasArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var main = new LoadBalancer("main", LoadBalancerArgs.builder()        
            .availabilityZones("us-east-1c")
            .listeners(LoadBalancerListenerArgs.builder()
                .instancePort(80)
                .instanceProtocol("http")
                .lbPort(80)
                .lbProtocol("http")
                .build())
            .build());

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

    }
}

import pulumi
import pulumi_aws as aws

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

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

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

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

NS and SOA Record Management

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

return await Deployment.RunAsync(() => 
{
    var exampleZone = new Aws.Route53.Zone("exampleZone");

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

});

package main

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

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

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.route53.Zone;
import com.pulumi.aws.route53.Record;
import com.pulumi.aws.route53.RecordArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var exampleZone = new Zone("exampleZone");

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

    }
}

import pulumi
import pulumi_aws as aws

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

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

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

resources:
  exampleZone:
    type: aws:route53:Zone
  exampleRecord:
    type: aws:route53:Record
    properties:
      allowOverwrite: true
      name: test.example.com
      ttl: 172800
      type: NS
      zoneId: ${exampleZone.zoneId}
      records:
        - ${exampleZone.nameServers[0]}
        - ${exampleZone.nameServers[1]}
        - ${exampleZone.nameServers[2]}
        - ${exampleZone.nameServers[3]}

Create Record Resource

new Record(name: string, args: RecordArgs, opts?: CustomResourceOptions);

@overload
def Record(resource_name: 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,
           geolocation_routing_policies: Optional[Sequence[RecordGeolocationRoutingPolicyArgs]] = None,
           health_check_id: Optional[str] = None,
           latency_routing_policies: Optional[Sequence[RecordLatencyRoutingPolicyArgs]] = None,
           multivalue_answer_routing_policy: Optional[bool] = None,
           name: Optional[str] = None,
           records: Optional[Sequence[str]] = None,
           set_identifier: Optional[str] = None,
           ttl: Optional[int] = None,
           type: Optional[Union[str, RecordType]] = None,
           weighted_routing_policies: Optional[Sequence[RecordWeightedRoutingPolicyArgs]] = None,
           zone_id: Optional[str] = None)
@overload
def Record(resource_name: str,
           args: RecordArgs,
           opts: Optional[ResourceOptions] = 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.

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.

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

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.

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

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.

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.

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.

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.

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

Resource lookup is not supported in YAML

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.

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.

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.

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.

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.

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.

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

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

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.

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.

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

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

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

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

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

 $ pulumi import aws:route53/record:Record myrecord Z4KAPRWWNC7JR_dev.example.com_NS_dev

Package Details

Repository: AWS Classic pulumi/pulumi-aws
License: Apache-2.0
Notes: This Pulumi package is based on the aws Terraform Provider.

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.2.1 published on Friday, Sep 22, 2023 by Pulumi

pulumi/pulumi-aws

aws.route53.Record

On this page

On this page

Example Usage

Simple routing policy

Weighted routing policy

Alias record

NS and SOA Record Management

Create Record Resource

Record Resource Properties

Inputs

Outputs

Look up Existing Record Resource

Supporting Types

RecordAlias, RecordAliasArgs

RecordCidrRoutingPolicy, RecordCidrRoutingPolicyArgs

RecordFailoverRoutingPolicy, RecordFailoverRoutingPolicyArgs

RecordGeolocationRoutingPolicy, RecordGeolocationRoutingPolicyArgs

RecordLatencyRoutingPolicy, RecordLatencyRoutingPolicyArgs

RecordType, RecordTypeArgs

RecordWeightedRoutingPolicy, RecordWeightedRoutingPolicyArgs

Import

Package Details

On this page

On this page