Package software.amazon.awscdk.cfnpropertymixins.services.route53

Class CfnHostedZonePropsMixin

java.lang.Object
software.amazon.jsii.JsiiObject
software.amazon.awscdk.Mixin
software.amazon.awscdk.cfnpropertymixins.services.route53.CfnHostedZonePropsMixin
All Implemented Interfaces:
software.amazon.jsii.JsiiSerializable, software.constructs.IMixin
@Generated(value="jsii-pacmak/1.127.0 (build 2117ad5)", date="2026-03-27T13:12:20.018Z") @Stability(Stable) public class CfnHostedZonePropsMixin extends Mixin implements software.constructs.IMixin
Creates a new public or private hosted zone.

You create records in a public hosted zone to define how you want to route traffic on the internet for a domain, such as example.com, and its subdomains (apex.example.com, acme.example.com). You create records in a private hosted zone to define how you want to route traffic for a domain and its subdomains within one or more Amazon Virtual Private Clouds (Amazon VPCs).

You can't convert a public hosted zone to a private hosted zone or vice versa. Instead, you must create a new hosted zone with the same name and create new resource record sets.

For more information about charges for hosted zones, see Amazon Route 53 Pricing .

Note the following:

  • You can't create a hosted zone for a top-level domain (TLD) such as .com.
  • If your domain is registered with a registrar other than Route 53, you must update the name servers with your registrar to make Route 53 the DNS service for the domain. For more information, see Migrating DNS Service for an Existing Domain to Amazon Route 53 in the Amazon Route 53 Developer Guide .

When you submit a CreateHostedZone request, the initial status of the hosted zone is PENDING . For public hosted zones, this means that the NS and SOA records are not yet available on all Route 53 DNS servers. When the NS and SOA records are available, the status of the zone changes to INSYNC .

The CreateHostedZone request requires the caller to have an ec2:DescribeVpcs permission.

When creating private hosted zones, the Amazon VPC must belong to the same partition where the hosted zone is created. A partition is a group of AWS Regions . Each AWS account is scoped to one partition.

The following are the supported partitions:

  • aws - AWS Regions
  • aws-cn - China Regions
  • aws-us-gov - AWS GovCloud (US) Region

For more information, see Access Management in the AWS General Reference .

Example: 

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.cfnpropertymixins.services.route53.*;
 import software.amazon.awscdk.*;
 IMergeStrategy mergeStrategy;
 CfnHostedZonePropsMixin cfnHostedZonePropsMixin = CfnHostedZonePropsMixin.Builder.create(CfnHostedZoneMixinProps.builder()
         .hostedZoneConfig(HostedZoneConfigProperty.builder()
                 .comment("comment")
                 .build())
         .hostedZoneFeatures(HostedZoneFeaturesProperty.builder()
                 .enableAcceleratedRecovery(false)
                 .build())
         .hostedZoneTags(List.of(HostedZoneTagProperty.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .name("name")
         .queryLoggingConfig(QueryLoggingConfigProperty.builder()
                 .cloudWatchLogsLogGroupArn("cloudWatchLogsLogGroupArn")
                 .build())
         .vpcs(List.of(VPCProperty.builder()
                 .vpcId("vpcId")
                 .vpcRegion("vpcRegion")
                 .build()))
         .build())
 .strategy(mergeStrategy)
 .build();

See Also:

  • Field Details

    • CFN_PROPERTY_KEYS

      @Stability(Stable) protected static final List<String> CFN_PROPERTY_KEYS

  • Constructor Details

    • CfnHostedZonePropsMixin

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

    • CfnHostedZonePropsMixin

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

    • CfnHostedZonePropsMixin

      @Stability(Stable) public CfnHostedZonePropsMixin(@NotNull CfnHostedZoneMixinProps props, @Nullable CfnPropertyMixinOptions options)
      Create a mixin to apply properties to AWS::Route53::HostedZone.

      Parameters:
      props - L1 properties to apply. This parameter is required.
      options - Mixin options.

    • CfnHostedZonePropsMixin

      @Stability(Stable) public CfnHostedZonePropsMixin(@NotNull CfnHostedZoneMixinProps props)
      Create a mixin to apply properties to AWS::Route53::HostedZone.

      Parameters:
      props - L1 properties to apply. This parameter is required.

  • Method Details

    • applyTo

      @Stability(Stable) public void applyTo(@NotNull software.constructs.IConstruct construct)
      Apply the mixin properties to the construct.

      Specified by:
      applyTo in interface software.constructs.IMixin
      Specified by:
      applyTo in class Mixin
      Parameters:
      construct - This parameter is required.

    • supports

      @Stability(Stable) @NotNull public Boolean supports(@NotNull software.constructs.IConstruct construct)
      Check if this mixin supports the given construct.

      Specified by:
      supports in interface software.constructs.IMixin
      Overrides:
      supports in class Mixin
      Parameters:
      construct - This parameter is required.

    • getProps

      @Stability(Stable) @NotNull protected CfnHostedZoneMixinProps getProps()

    • getStrategy

      @Stability(Stable) @NotNull protected IMergeStrategy getStrategy()