Class DomainNameOptions
Inheritance
Implements
Namespace: Amazon.CDK.AWS.APIGateway
Assembly: Amazon.CDK.Lib.dll
Syntax (csharp)
public class DomainNameOptions : Object, IDomainNameOptions
Syntax (vb)
Public Class DomainNameOptions
Inherits Object
Implements IDomainNameOptions
Remarks
ExampleMetadata: infused
Examples
var acmCertificateForExampleCom;
var api = new RestApi(this, "MyDomain", new RestApiProps {
DomainName = new DomainNameOptions {
DomainName = "example.com",
Certificate = acmCertificateForExampleCom
}
});
Synopsis
Constructors
DomainNameOptions() |
Properties
BasePath | The base path name that callers of the API must provide in the URL after the domain name (e.g. |
Certificate | The reference to an AWS-managed certificate for use by the edge-optimized endpoint for the domain name. |
DomainName | The custom domain name for your API. |
EndpointType | The type of endpoint for this DomainName. |
Mtls | The mutual TLS authentication configuration for a custom domain name. |
SecurityPolicy | The Transport Layer Security (TLS) version + cipher suite for this domain name. |
Constructors
DomainNameOptions()
public DomainNameOptions()
Properties
BasePath
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.
public string BasePath { get; set; }
Property Value
System.String
Remarks
Default: - map requests from the domain root (e.g. example.com
).
Certificate
The reference to an AWS-managed certificate for use by the edge-optimized endpoint for the domain name.
public ICertificate Certificate { get; set; }
Property Value
Remarks
For "EDGE" domain names, the certificate needs to be in the US East (N. Virginia) region.
DomainName
The custom domain name for your API.
public string DomainName { get; set; }
Property Value
System.String
Remarks
Uppercase letters are not supported.
EndpointType
The type of endpoint for this DomainName.
public Nullable<EndpointType> EndpointType { get; set; }
Property Value
System.Nullable<EndpointType>
Remarks
Default: REGIONAL
Mtls
The mutual TLS authentication configuration for a custom domain name.
public IMTLSConfig Mtls { get; set; }
Property Value
Remarks
Default: - mTLS is not configured.
SecurityPolicy
The Transport Layer Security (TLS) version + cipher suite for this domain name.
public Nullable<SecurityPolicy> SecurityPolicy { get; set; }
Property Value
System.Nullable<SecurityPolicy>
Remarks
Default: SecurityPolicy.TLS_1_2