@aws-cdk/aws-route53

Amazon Route53 Construct Library

---

This is a developer preview (public beta) module. Releases might lack important features and might have future breaking changes.

---

To add a public hosted zone:

import route53 = require('@aws-cdk/aws-route53');

new route53.PublicHostedZone(this, 'HostedZone', {
  zoneName: 'fully.qualified.domain.com'
});

To add a private hosted zone, use PrivateHostedZone. Note that enableDnsHostnames and enableDnsSupport must have been enabled for the VPC you're configuring for private hosted zones.

import ec2 = require('@aws-cdk/aws-ec2');
import route53 = require('@aws-cdk/aws-route53');

const vpc = new ec2.Vpc(this, 'VPC');

const zone = new route53.PrivateHostedZone(this, 'HostedZone', {
  zoneName: 'fully.qualified.domain.com',
  vpc    // At least one VPC has to be added to a Private Hosted Zone.
});

Additional VPCs can be added with zone.addVPC().

Adding Records

To add a TXT record to your zone:

import route53 = require('@aws-cdk/aws-route53');

new route53.TxtRecord(this, 'TXTRecord', {
  zone: myZone,
  recordName: '_foo',  // If the name ends with a ".", it will be used as-is;
                       // if it ends with a "." followed by the zone name, a trailing "." will be added automatically;
                       // otherwise, a ".", the zone name, and a trailing "." will be added automatically.
                       // Defaults to zone root if not specified.
  values: [            // Will be quoted for you, and " will be escaped automatically.
    'Bar!',
    'Baz?'
  ],
  ttl: 90,             // Optional - default is 1800
});

To add a A record to your zone:

import route53 = require('@aws-cdk/aws-route53');

new route53.ARecord(this, 'ARecord', {
  zone: myZone,
  target: route53.AddressRecordTarget.fromIpAddresses('1.2.3.4', '5.6.7.8')
})

To add a AAAA record pointing to a CloudFront distribution:

import route53 = require('@aws-cdk/aws-route53');
import targets = require('@aws-cdk/aws-route53-targets');

new route53.AaaaRecord(this, 'Alias', {
  zone: myZone,
  target: route53.AddressRecordTarget.fromAlias(new targets.CloudFrontTarget(distribution))
})

Constructs are available for A, AAAA, CAA, CNAME, MX, NS, SRV and TXT records.

Use the CaaAmazonRecord construct to easily restrict certificate authorities allowed to issue certificates for a domain to Amazon only.

Adding records to existing hosted zones

If you know the ID and Name of a Hosted Zone, you can import it directly:

const zone = HostedZone.import(this, 'MyZone', {
  zoneName: 'example.com',
  hostedZoneId: 'ZOJJZC49E0EPZ',
});

If you don't know the ID of a Hosted Zone, you can use the HostedZoneProvider to discover and import it:

const zone = new HostedZoneProvider(this, {
  domainName: 'example.com'
}).findAndImport(this, 'MyZone');

Changelog

0.38.0 (2019-07-08)

Bug Fixes

• cli: exclusively is also '-e' for destroy (#3216) (d6f5207), closes #2367
• cloudwatch: AlarmWidget takes IAlarm (#3219) (9948bfd), closes #3068
• core: fix build errors in fsharp init-template (#3229) (7d020f1)
• core: UpdateReplacePolicy mirrors DeletionPolicy (#3217) (d61bd2c), closes #2901
• ecr: repository grant uses correct resource ARN (#3220) (cc2275c), closes #2473
• iam: fix managed policies for User (#3221) (ec1c5b7), closes #2557
• make capitalization of Ip/Az consistent (#3202) (d60d673)

Features

• use classes for structs in Python (#3232) (161a459)
• codebuild: allow specifying principals and credentials for pulling build images. (#3049) (3319fe5), closes #2175

BREAKING CHANGES TO EXPERIMENTAL FEATURES

• codebuild: LinuxBuildImage.fromDockerHub() has been renamed to fromDockerRegistry() and WindowsBuildImage.fromDockerHub() has been renamed to fromDockerRegistry()
• iam: aws-iam.User and Group: managedPolicyArns => managedPolicies.
• in all identifiers, renamed IPv4 => Ipv4, IPv6 => Ipv6, AZs => Azs.