Package software.amazon.awscdk.services.apigateway

Class CfnDomainName

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.apigateway.CfnDomainName
All Implemented Interfaces:
IInspectable, ITaggable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable
@Generated(value="jsii-pacmak/1.101.0 (build b95fe5d)", date="2024-07-12T19:33:56.703Z") @Stability(Stable) public class CfnDomainName extends CfnResource implements IInspectable, ITaggable
The AWS::ApiGateway::DomainName resource specifies a custom domain name for your API in API Gateway.

You can use a custom domain name to provide a URL that's more intuitive and easier to recall. For more information about using custom domain names, see Set up Custom Domain Name for an API in API Gateway in the API Gateway Developer Guide .

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.apigateway.*;
 CfnDomainName cfnDomainName = CfnDomainName.Builder.create(this, "MyCfnDomainName")
         .certificateArn("certificateArn")
         .domainName("domainName")
         .endpointConfiguration(EndpointConfigurationProperty.builder()
                 .types(List.of("types"))
                 .build())
         .mutualTlsAuthentication(MutualTlsAuthenticationProperty.builder()
                 .truststoreUri("truststoreUri")
                 .truststoreVersion("truststoreVersion")
                 .build())
         .ownershipVerificationCertificateArn("ownershipVerificationCertificateArn")
         .regionalCertificateArn("regionalCertificateArn")
         .securityPolicy("securityPolicy")
         .tags(List.of(CfnTag.builder()
                 .key("key")
                 .value("value")
                 .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

    • CfnDomainName

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

    • CfnDomainName

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

    • CfnDomainName

      @Stability(Stable) public CfnDomainName(@NotNull software.constructs.Construct scope, @NotNull String id, @Nullable CfnDomainNameProps props)
      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.

    • CfnDomainName

      @Stability(Stable) public CfnDomainName(@NotNull software.constructs.Construct scope, @NotNull String id)
      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.

  • Method Details

    • 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.

    • getAttrDistributionDomainName

      @Stability(Stable) @NotNull public String getAttrDistributionDomainName()
      The Amazon CloudFront distribution domain name that's mapped to the custom domain name.

      This is only applicable for endpoints whose type is EDGE .

      Example: d111111abcdef8.cloudfront.net

    • getAttrDistributionHostedZoneId

      @Stability(Stable) @NotNull public String getAttrDistributionHostedZoneId()
      The region-agnostic Amazon Route 53 Hosted Zone ID of the edge-optimized endpoint.

      The only valid value is Z2FDTNDATAQYW2 for all regions.

    • getAttrRegionalDomainName

      @Stability(Stable) @NotNull public String getAttrRegionalDomainName()
      The domain name associated with the regional endpoint for this custom domain name.

      You set up this association by adding a DNS record that points the custom domain name to this regional domain name.

    • getAttrRegionalHostedZoneId

      @Stability(Stable) @NotNull public String getAttrRegionalHostedZoneId()
      The region-specific Amazon Route 53 Hosted Zone ID of the regional endpoint.

    • getCfnProperties

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

    • getTags

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

    • getCertificateArn

      @Stability(Stable) @Nullable public String getCertificateArn()
      The reference to an AWS -managed certificate that will be used by edge-optimized endpoint for this domain name.

    • setCertificateArn

      @Stability(Stable) public void setCertificateArn(@Nullable String value)
      The reference to an AWS -managed certificate that will be used by edge-optimized endpoint for this domain name.

    • getDomainName

      @Stability(Stable) @Nullable public String getDomainName()
      The custom domain name as an API host name, for example, my-api.example.com .

    • setDomainName

      @Stability(Stable) public void setDomainName(@Nullable String value)
      The custom domain name as an API host name, for example, my-api.example.com .

    • getEndpointConfiguration

      @Stability(Stable) @Nullable public Object getEndpointConfiguration()
      The endpoint configuration of this DomainName showing the endpoint types of the domain name.

    • setEndpointConfiguration

      @Stability(Stable) public void setEndpointConfiguration(@Nullable IResolvable value)
      The endpoint configuration of this DomainName showing the endpoint types of the domain name.

    • setEndpointConfiguration

      @Stability(Stable) public void setEndpointConfiguration(@Nullable CfnDomainName.EndpointConfigurationProperty value)
      The endpoint configuration of this DomainName showing the endpoint types of the domain name.

    • getMutualTlsAuthentication

      @Stability(Stable) @Nullable public Object getMutualTlsAuthentication()
      The mutual TLS authentication configuration for a custom domain name.

    • setMutualTlsAuthentication

      @Stability(Stable) public void setMutualTlsAuthentication(@Nullable IResolvable value)
      The mutual TLS authentication configuration for a custom domain name.

    • setMutualTlsAuthentication

      @Stability(Stable) public void setMutualTlsAuthentication(@Nullable CfnDomainName.MutualTlsAuthenticationProperty value)
      The mutual TLS authentication configuration for a custom domain name.

    • getOwnershipVerificationCertificateArn

      @Stability(Stable) @Nullable public String getOwnershipVerificationCertificateArn()
      The ARN of the public certificate issued by ACM to validate ownership of your custom domain.

    • setOwnershipVerificationCertificateArn

      @Stability(Stable) public void setOwnershipVerificationCertificateArn(@Nullable String value)
      The ARN of the public certificate issued by ACM to validate ownership of your custom domain.

    • getRegionalCertificateArn

      @Stability(Stable) @Nullable public String getRegionalCertificateArn()
      The reference to an AWS -managed certificate that will be used for validating the regional domain name.

    • setRegionalCertificateArn

      @Stability(Stable) public void setRegionalCertificateArn(@Nullable String value)
      The reference to an AWS -managed certificate that will be used for validating the regional domain name.

    • getSecurityPolicy

      @Stability(Stable) @Nullable public String getSecurityPolicy()
      The Transport Layer Security (TLS) version + cipher suite for this DomainName.

    • setSecurityPolicy

      @Stability(Stable) public void setSecurityPolicy(@Nullable String value)
      The Transport Layer Security (TLS) version + cipher suite for this DomainName.

    • getTagsRaw

      @Stability(Stable) @Nullable public List<CfnTag> getTagsRaw()
      The collection of tags.

    • setTagsRaw

      @Stability(Stable) public void setTagsRaw(@Nullable List<CfnTag> value)
      The collection of tags.