Package software.amazon.awscdk.services.apigateway

Interface DomainNameOptions

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Subinterfaces:

DomainNameProps

All Known Implementing Classes:

DomainNameOptions.Jsii$Proxy, DomainNameProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.113.0 (build fc68b25)",
           date="2025-10-14T12:28:04.112Z")
@Stability(Stable)
public interface DomainNameOptions
extends software.amazon.jsii.JsiiSerializable

Example:

 Object acmCertificateForExampleCom;
 RestApi api = RestApi.Builder.create(this, "MyDomain")
         .domainName(DomainNameOptions.builder()
                 .domainName("example.com")
                 .certificate(acmCertificateForExampleCom)
                 .build())
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	DomainNameOptions.Builder	A builder for DomainNameOptions
static final class	DomainNameOptions.Jsii$Proxy	An implementation for DomainNameOptions

Method Summary

Modifier and Type	Method	Description
static DomainNameOptions.Builder	builder()
default String	getBasePath()	The base path name that callers of the API must provide in the URL after the domain name (e.g.
ICertificate	getCertificate()	The reference to an AWS-managed certificate for use by the edge-optimized endpoint for the domain name.
String	getDomainName()	The custom domain name for your API.
default EndpointType	getEndpointType()	The type of endpoint for this DomainName.
default MTLSConfig	getMtls()	The mutual TLS authentication configuration for a custom domain name.
default SecurityPolicy	getSecurityPolicy()	The Transport Layer Security (TLS) version + cipher suite for this domain name.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getCertificate

@Stability(Stable)
@NotNull
ICertificate getCertificate()

The reference to an AWS-managed certificate for use by the edge-optimized endpoint for the domain name.

For "EDGE" domain names, the certificate needs to be in the US East (N. Virginia) region.

getDomainName

@Stability(Stable)
@NotNull
String getDomainName()

The custom domain name for your API.

Uppercase letters are not supported.

getBasePath

@Stability(Stable)
@Nullable
default String getBasePath()

The base path name that callers of the API must provide in the URL after the domain name (e.g. example.com/base-path). If you specify this property, it can't be an empty string.

Default: - map requests from the domain root (e.g. `example.com`).

getEndpointType

@Stability(Stable)
@Nullable
default EndpointType getEndpointType()

The type of endpoint for this DomainName.

Default: REGIONAL

getMtls

@Stability(Stable)
@Nullable
default MTLSConfig getMtls()

The mutual TLS authentication configuration for a custom domain name.

Default: - mTLS is not configured.

getSecurityPolicy

@Stability(Stable)
@Nullable
default SecurityPolicy getSecurityPolicy()

The Transport Layer Security (TLS) version + cipher suite for this domain name.

Default: SecurityPolicy.TLS_1_2

See Also:

• https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainname.html

builder

@Stability(Stable)
static DomainNameOptions.Builder builder()

Returns:

a DomainNameOptions.Builder of DomainNameOptions