Security News
JavaScript Leaders Demand Oracle Release the JavaScript Trademark
In an open letter, JavaScript community leaders urge Oracle to give up the JavaScript trademark, arguing that it has been effectively abandoned through nonuse.
@aws-cdk/aws-route53
Advanced tools
@aws-cdk/aws-route53 is an AWS Cloud Development Kit (CDK) library that allows you to define and manage Amazon Route 53 resources using code. It provides a high-level, object-oriented abstraction to create and manage DNS zones, records, and other Route 53 features.
Create a Hosted Zone
This code sample demonstrates how to create a new hosted zone in Route 53 using the AWS CDK. A hosted zone is a container for DNS records for a specific domain.
const route53 = require('@aws-cdk/aws-route53');
const cdk = require('@aws-cdk/core');
const app = new cdk.App();
const stack = new cdk.Stack(app, 'MyStack');
const zone = new route53.HostedZone(stack, 'MyHostedZone', {
zoneName: 'example.com',
});
app.synth();
Create an A Record
This code sample demonstrates how to create an A record in a hosted zone. An A record maps a domain name to an IPv4 address.
const route53 = require('@aws-cdk/aws-route53');
const cdk = require('@aws-cdk/core');
const app = new cdk.App();
const stack = new cdk.Stack(app, 'MyStack');
const zone = new route53.HostedZone(stack, 'MyHostedZone', {
zoneName: 'example.com',
});
new route53.ARecord(stack, 'MyARecord', {
zone,
target: route53.RecordTarget.fromIpAddresses('1.2.3.4'),
});
app.synth();
Create a CNAME Record
This code sample demonstrates how to create a CNAME record in a hosted zone. A CNAME record maps a domain name to another domain name.
const route53 = require('@aws-cdk/aws-route53');
const cdk = require('@aws-cdk/core');
const app = new cdk.App();
const stack = new cdk.Stack(app, 'MyStack');
const zone = new route53.HostedZone(stack, 'MyHostedZone', {
zoneName: 'example.com',
});
new route53.CnameRecord(stack, 'MyCnameRecord', {
zone,
domainName: 'example.com',
recordName: 'www',
});
app.synth();
Create an Alias Record
This code sample demonstrates how to create an alias record in a hosted zone. An alias record maps a domain name to an AWS resource, such as an Elastic Load Balancer.
const route53 = require('@aws-cdk/aws-route53');
const cdk = require('@aws-cdk/core');
const targets = require('@aws-cdk/aws-route53-targets');
const elbv2 = require('@aws-cdk/aws-elasticloadbalancingv2');
const app = new cdk.App();
const stack = new cdk.Stack(app, 'MyStack');
const zone = new route53.HostedZone(stack, 'MyHostedZone', {
zoneName: 'example.com',
});
const lb = new elbv2.ApplicationLoadBalancer(stack, 'LB', {
vpc,
internetFacing: true,
});
new route53.ARecord(stack, 'AliasRecord', {
zone,
target: route53.RecordTarget.fromAlias(new targets.LoadBalancerTarget(lb)),
});
app.synth();
The aws-sdk package is the official AWS SDK for JavaScript. It provides low-level access to all AWS services, including Route 53. Unlike @aws-cdk/aws-route53, which is a high-level abstraction for defining infrastructure as code, aws-sdk requires more detailed and manual configuration.
The serverless framework allows you to build and deploy serverless applications on AWS and other cloud providers. It includes plugins for managing Route 53 resources. While it provides a higher-level abstraction than aws-sdk, it is not as integrated with infrastructure as code as the AWS CDK.
Terraform is an open-source infrastructure as code software tool created by HashiCorp. It allows you to define and provision data center infrastructure using a high-level configuration language. Terraform has a provider for AWS, including Route 53 resources. It is similar to AWS CDK in that it allows you to define infrastructure as code, but it uses a different syntax and approach.
To add a public hosted zone:
import * as route53 from '@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 * as ec2 from '@aws-cdk/aws-ec2';
import * as route53 from '@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()
.
To add a TXT record to your zone:
import * as route53 from '@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: Duration.minutes(90), // Optional - default is 30 minutes
});
To add a A record to your zone:
import * as route53 from '@aws-cdk/aws-route53';
new route53.ARecord(this, 'ARecord', {
zone: myZone,
target: route53.RecordTarget.fromIpAddresses('1.2.3.4', '5.6.7.8')
});
To add a AAAA record pointing to a CloudFront distribution:
import * as route53 from '@aws-cdk/aws-route53';
import * as targets from '@aws-cdk/aws-route53-targets';
new route53.AaaaRecord(this, 'Alias', {
zone: myZone,
target: route53.RecordTarget.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.
If you don't know the ID of the Hosted Zone to import, you can use the
HostedZone.fromLookup
:
HostedZone.fromLookup(this, 'MyZone', {
domainName: 'example.com'
});
HostedZone.fromLookup
requires an environment to be configured. Check
out the documentation for more documentation and examples. CDK
automatically looks into your ~/.aws/config
file for the [default]
profile.
If you want to specify a different account run cdk deploy --profile [profile]
.
new MyDevStack(app, 'dev', {
env: {
account: process.env.CDK_DEFAULT_ACCOUNT,
region: process.env.CDK_DEFAULT_REGION
}});
If you know the ID and Name of a Hosted Zone, you can import it directly:
const zone = HostedZone.fromHostedZoneAttributes(this, 'MyZone', {
zoneName: 'example.com',
hostedZoneId: 'ZOJJZC49E0EPZ',
});
Alternatively, use the HostedZone.fromHostedZoneId
to import hosted zones if
you know the ID and the retrieval for the zoneName
is undesirable.
const zone = HostedZone.fromHostedZoneId(this, 'MyZone', {
hostedZoneId: 'ZOJJZC49E0EPZ',
});
1.72.0 (2020-11-06)
enableHttpEndpoint
renamed to enableDataApi
outputLocation
in the experimental Athena StartQueryExecution
has been changed to s3.Location
from string
Environment
from attributes (#10932) (d395b5e), closes #10931--no-previous-parameters
incorrectly skips updates (#11288) (1bfc649)FAQs
The CDK Construct Library for AWS::Route53
We found that @aws-cdk/aws-route53 demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 4 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
In an open letter, JavaScript community leaders urge Oracle to give up the JavaScript trademark, arguing that it has been effectively abandoned through nonuse.
Security News
The initial version of the Socket Python SDK is now on PyPI, enabling developers to more easily interact with the Socket REST API in Python projects.
Security News
Floating dependency ranges in npm can introduce instability and security risks into your project by allowing unverified or incompatible versions to be installed automatically, leading to unpredictable behavior and potential conflicts.