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.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:36.160Z")
 @Stability(value=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 and Description
static class	DomainNameOptions.Builder A builder for DomainNameOptions
static class	DomainNameOptions.Jsii$Proxy An implementation for DomainNameOptions

Method Summary

Modifier and Type	Method and 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 Detail

getCertificate

@Stability(value=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(value=Stable)
 @NotNull
String getDomainName()

The custom domain name for your API.

Uppercase letters are not supported.

getBasePath

@Stability(value=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`). If this is undefined, no additional mappings will be allowed on this domain name.

getEndpointType

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

The type of endpoint for this DomainName.

Default: REGIONAL

getMtls

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

The mutual TLS authentication configuration for a custom domain name.

Default: - mTLS is not configured.

getSecurityPolicy

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

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

Default: SecurityPolicy.TLS_1_0

See Also:

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

builder

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

Returns:

a DomainNameOptions.Builder of DomainNameOptions