software.amazon.awscdk.services.apigateway

Interface DomainNameOptions

All Known Subinterfaces:

DomainNameProps

All Known Implementing Classes:

DomainNameOptions.Jsii$Proxy, DomainNameProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.63.2 (build a8a8833)",
           date="2022-08-02T20:25:34.846Z")
public interface DomainNameOptions

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 java.lang.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.
java.lang.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.

Method Detail

getCertificate

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

java.lang.String getDomainName()

The custom domain name for your API.

Uppercase letters are not supported.

getBasePath

default java.lang.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

default EndpointType getEndpointType()

The type of endpoint for this DomainName.

Default: REGIONAL

getMtls

default MTLSConfig getMtls()

The mutual TLS authentication configuration for a custom domain name.

Default: - mTLS is not configured.

getSecurityPolicy

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

static DomainNameOptions.Builder builder()

Returns:

a DomainNameOptions.Builder of DomainNameOptions