software.amazon.awscdk.services.route53

Class HostedZone

java.lang.Object

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.Resource

software.amazon.awscdk.services.route53.HostedZone

All Implemented Interfaces:

IConstruct, IDependable, IResource, IHostedZone

Direct Known Subclasses:

PrivateHostedZone, PublicHostedZone

@Generated(value="jsii-pacmak/1.63.2 (build a8a8833)",
           date="2022-08-09T19:16:40.565Z")
public class HostedZone
extends Resource
implements IHostedZone

Container for records, and records contain information about how to route traffic for a specific domain, such as example.com and its subdomains (acme.example.com, zenith.example.com).

Example:

 HostedZone hostedZone = HostedZone.Builder.create(this, "MyHostedZone").zoneName("example.org").build();
 Metric metric = Metric.Builder.create()
         .namespace("AWS/Route53")
         .metricName("DNSQueries")
         .dimensionsMap(Map.of(
                 "HostedZoneId", hostedZone.getHostedZoneId()))
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	HostedZone.Builder A fluent builder for HostedZone.

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.route53.IHostedZone

IHostedZone.Jsii$Default, IHostedZone.Jsii$Proxy

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	HostedZone(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	HostedZone(software.amazon.jsii.JsiiObjectRef objRef)
	HostedZone(software.constructs.Construct scope, java.lang.String id, HostedZoneProps props)

Method Summary

Modifier and Type	Method and Description
void	addVpc(IVpc vpc) Add another VPC to this private hosted zone.
static IHostedZone	fromHostedZoneAttributes(software.constructs.Construct scope, java.lang.String id, HostedZoneAttributes attrs) Imports a hosted zone from another stack.
static IHostedZone	fromHostedZoneId(software.constructs.Construct scope, java.lang.String id, java.lang.String hostedZoneId) Import a Route 53 hosted zone defined either outside the CDK, or in a different CDK stack.
static IHostedZone	fromLookup(software.constructs.Construct scope, java.lang.String id, HostedZoneProviderProps query) Lookup a hosted zone in the current account/region based on query parameters.
java.lang.String	getHostedZoneArn() ARN of this hosted zone, such as arn:${Partition}:route53:::hostedzone/${Id}.
java.lang.String	getHostedZoneId() ID of this hosted zone, such as "Z23ABC4XYZL05B".
java.util.List<java.lang.String>	getHostedZoneNameServers() Returns the set of name servers for the specific hosted zone.
protected java.util.List<CfnHostedZone.VPCProperty>	getVpcs() VPCs to which this hosted zone will be added.
java.lang.String	getZoneName() FQDN of this hosted zone.

Methods inherited from class software.amazon.awscdk.core.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isResource

Methods inherited from class software.amazon.awscdk.core.Construct

getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface software.amazon.awscdk.core.IResource

applyRemovalPolicy, getEnv, getStack

Methods inherited from interface software.amazon.awscdk.core.IConstruct

getNode

Constructor Detail

HostedZone

protected HostedZone(software.amazon.jsii.JsiiObjectRef objRef)

HostedZone

protected HostedZone(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

HostedZone

public HostedZone(software.constructs.Construct scope,
                  java.lang.String id,
                  HostedZoneProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

fromHostedZoneAttributes

public static IHostedZone fromHostedZoneAttributes(software.constructs.Construct scope,
                                                   java.lang.String id,
                                                   HostedZoneAttributes attrs)

Imports a hosted zone from another stack.

Use when both hosted zone ID and hosted zone name are known.

Parameters:

scope - the parent Construct for this Construct. This parameter is required.

id - the logical name of this Construct. This parameter is required.

attrs - the HostedZoneAttributes (hosted zone ID and hosted zone name). This parameter is required.

fromHostedZoneId

public static IHostedZone fromHostedZoneId(software.constructs.Construct scope,
                                           java.lang.String id,
                                           java.lang.String hostedZoneId)

Import a Route 53 hosted zone defined either outside the CDK, or in a different CDK stack.

Use when hosted zone ID is known. Hosted zone name becomes unavailable through this query.

Parameters:

scope - the parent Construct for this Construct. This parameter is required.

id - the logical name of this Construct. This parameter is required.

hostedZoneId - the ID of the hosted zone to import. This parameter is required.

fromLookup

public static IHostedZone fromLookup(software.constructs.Construct scope,
                                     java.lang.String id,
                                     HostedZoneProviderProps query)

Lookup a hosted zone in the current account/region based on query parameters.

Requires environment, you must specify env for the stack.

Use to easily query hosted zones.

Parameters:

scope - This parameter is required.

id - This parameter is required.

query - This parameter is required.

See Also:

https://docs.aws.amazon.com/cdk/latest/guide/environments.html

addVpc

public void addVpc(IVpc vpc)

Add another VPC to this private hosted zone.

Parameters:

vpc - the other VPC to add. This parameter is required.

getHostedZoneArn

public java.lang.String getHostedZoneArn()

ARN of this hosted zone, such as arn:${Partition}:route53:::hostedzone/${Id}.

Specified by:

getHostedZoneArn in interface IHostedZone

getHostedZoneId

public java.lang.String getHostedZoneId()

ID of this hosted zone, such as "Z23ABC4XYZL05B".

Specified by:

getHostedZoneId in interface IHostedZone

getVpcs

protected java.util.List<CfnHostedZone.VPCProperty> getVpcs()

VPCs to which this hosted zone will be added.

getZoneName

public java.lang.String getZoneName()

FQDN of this hosted zone.

Specified by:

getZoneName in interface IHostedZone

getHostedZoneNameServers

public java.util.List<java.lang.String> getHostedZoneNameServers()

Returns the set of name servers for the specific hosted zone. For example: ns1.example.com.

This attribute will be undefined for private hosted zones or hosted zones imported from another stack.

Specified by:

getHostedZoneNameServers in interface IHostedZone