Package software.amazon.awscdk.services.route53resolver

Class CfnResolverRule

java.lang.Object
software.amazon.jsii.JsiiObject
software.constructs.Construct
software.amazon.awscdk.CfnElement
software.amazon.awscdk.CfnRefElement
software.amazon.awscdk.CfnResource
software.amazon.awscdk.services.route53resolver.CfnResolverRule
All Implemented Interfaces:
IInspectable, IEnvironmentAware, IResolverRuleRef, ITaggable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable
@Generated(value="jsii-pacmak/1.121.0 (build d7af9b9)", date="2025-12-18T18:20:16.981Z") @Stability(Stable) public class CfnResolverRule extends CfnResource implements IInspectable, IResolverRuleRef, ITaggable
For DNS queries that originate in your VPCs, specifies which Resolver endpoint the queries pass through, one domain name that you want to forward to your network, and the IP addresses of the DNS resolvers in your network.

Example: 

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.route53resolver.*;
 CfnResolverRule cfnResolverRule = CfnResolverRule.Builder.create(this, "MyCfnResolverRule")
         .ruleType("ruleType")
         // the properties below are optional
         .delegationRecord("delegationRecord")
         .domainName("domainName")
         .name("name")
         .resolverEndpointId("resolverEndpointId")
         .tags(List.of(CfnTag.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .targetIps(List.of(TargetAddressProperty.builder()
                 .ip("ip")
                 .ipv6("ipv6")
                 .port("port")
                 .protocol("protocol")
                 .serverNameIndication("serverNameIndication")
                 .build()))
         .build();

See Also:

  • Field Details

    • CFN_RESOURCE_TYPE_NAME

      @Stability(Stable) public static final String CFN_RESOURCE_TYPE_NAME
      The CloudFormation resource type name for this resource class.

  • Constructor Details

    • CfnResolverRule

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

    • CfnResolverRule

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

    • CfnResolverRule

      @Stability(Stable) public CfnResolverRule(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull CfnResolverRuleProps props)
      Create a new AWS::Route53Resolver::ResolverRule.

      Parameters:
      scope - Scope in which this resource is defined. This parameter is required.
      id - Construct identifier for this resource (unique in its scope). This parameter is required.
      props - Resource properties. This parameter is required.

  • Method Details

    • arnForResolverRule

      @Stability(Stable) @NotNull public static String arnForResolverRule(@NotNull IResolverRuleRef resource)
      Parameters:
      resource - This parameter is required.

    • isCfnResolverRule

      @Stability(Stable) @NotNull public static Boolean isCfnResolverRule(@NotNull Object x)
      Checks whether the given object is a CfnResolverRule.

      Parameters:
      x - This parameter is required.

    • inspect

      @Stability(Stable) public void inspect(@NotNull TreeInspector inspector)
      Examines the CloudFormation resource and discloses attributes.

      Specified by:
      inspect in interface IInspectable
      Parameters:
      inspector - tree inspector to collect and process attributes. This parameter is required.

    • renderProperties

      @Stability(Stable) @NotNull protected Map<String,Object> renderProperties(@NotNull Map<String,Object> props)
      Overrides:
      renderProperties in class CfnResource
      Parameters:
      props - This parameter is required.

    • getAttrArn

      @Stability(Stable) @NotNull public String getAttrArn()
      The Amazon Resource Name (ARN) of the resolver rule, such as arn:aws:route53resolver:us-east-1:123456789012:resolver-rule/resolver-rule-a1bzhi .

    • getAttrDomainName

      @Stability(Stable) @NotNull public String getAttrDomainName()
      DNS queries for this domain name are forwarded to the IP addresses that are specified in TargetIps.

      If a query matches multiple resolver rules (example.com and www.example.com), the query is routed using the resolver rule that contains the most specific domain name (www.example.com).

    • getAttrName

      @Stability(Stable) @NotNull public String getAttrName()
      A friendly name that lets you easily find a rule in the Resolver dashboard in the Route 53 console.

    • getAttrResolverEndpointId

      @Stability(Stable) @NotNull public String getAttrResolverEndpointId()
      The ID of the outbound endpoint that the rule is associated with, such as rslvr-out-fdc049932dexample .

    • getAttrResolverRuleId

      @Stability(Stable) @NotNull public String getAttrResolverRuleId()
      When the value of RuleType is FORWARD , the ID that Resolver assigned to the resolver rule when you created it, such as rslvr-rr-5328a0899aexample .

      This value isn't applicable when RuleType is SYSTEM .

    • getAttrTargetIps

      @Stability(Stable) @NotNull public IResolvable getAttrTargetIps()
      When the value of RuleType is FORWARD , the IP addresses that the outbound endpoint forwards DNS queries to, typically the IP addresses for DNS resolvers on your network.

      This value isn't applicable when RuleType is SYSTEM .

      TargetIps is available only when the value of RuleType is FORWARD . You should not provide TargetIps when the RuleType is DELEGATE .

    • getCfnProperties

      @Stability(Stable) @NotNull protected Map<String,Object> getCfnProperties()
      Overrides:
      getCfnProperties in class CfnResource

    • getResolverRuleRef

      @Stability(Stable) @NotNull public ResolverRuleReference getResolverRuleRef()
      A reference to a ResolverRule resource.
      Specified by:
      getResolverRuleRef in interface IResolverRuleRef

    • getTags

      @Stability(Stable) @NotNull public TagManager getTags()
      Tag Manager which manages the tags for this resource.
      Specified by:
      getTags in interface ITaggable

    • getRuleType

      @Stability(Stable) @NotNull public String getRuleType()
      When you want to forward DNS queries for specified domain name to resolvers on your network, specify FORWARD or DELEGATE .

    • setRuleType

      @Stability(Stable) public void setRuleType(@NotNull String value)
      When you want to forward DNS queries for specified domain name to resolvers on your network, specify FORWARD or DELEGATE .

    • getDelegationRecord

      @Stability(Stable) @Nullable public String getDelegationRecord()
      DNS queries with delegation records that point to this domain name are forwarded to resolvers on your network.

    • setDelegationRecord

      @Stability(Stable) public void setDelegationRecord(@Nullable String value)
      DNS queries with delegation records that point to this domain name are forwarded to resolvers on your network.

    • getDomainName

      @Stability(Stable) @Nullable public String getDomainName()
      DNS queries for this domain name are forwarded to the IP addresses that are specified in TargetIps .

    • setDomainName

      @Stability(Stable) public void setDomainName(@Nullable String value)
      DNS queries for this domain name are forwarded to the IP addresses that are specified in TargetIps .

    • getName

      @Stability(Stable) @Nullable public String getName()
      The name for the Resolver rule, which you specified when you created the Resolver rule.

    • setName

      @Stability(Stable) public void setName(@Nullable String value)
      The name for the Resolver rule, which you specified when you created the Resolver rule.

    • getResolverEndpointId

      @Stability(Stable) @Nullable public String getResolverEndpointId()
      The ID of the endpoint that the rule is associated with.

    • setResolverEndpointId

      @Stability(Stable) public void setResolverEndpointId(@Nullable String value)
      The ID of the endpoint that the rule is associated with.

    • getTagsRaw

      @Stability(Stable) @Nullable public List<CfnTag> getTagsRaw()
      Tags help organize and categorize your Resolver rules.

    • setTagsRaw

      @Stability(Stable) public void setTagsRaw(@Nullable List<CfnTag> value)
      Tags help organize and categorize your Resolver rules.

    • getTargetIps

      @Stability(Stable) @Nullable public Object getTargetIps()
      An array that contains the IP addresses and ports that an outbound endpoint forwards DNS queries to.

      Returns union: either IResolvable or Listinvalid input: '<'either IResolvable or CfnResolverRule.TargetAddressProperty>

    • setTargetIps

      @Stability(Stable) public void setTargetIps(@Nullable IResolvable value)
      An array that contains the IP addresses and ports that an outbound endpoint forwards DNS queries to.

    • setTargetIps

      @Stability(Stable) public void setTargetIps(@Nullable List<Object> value)
      An array that contains the IP addresses and ports that an outbound endpoint forwards DNS queries to.