DomainConfiguration

產生 AWS::ApiGateway::DomainNameAccessAssociation資源所需的組態。

AWS SAM 會在設定此屬性時產生 AWS::ApiGateway::DomainNameAccessAssociation 資源。如需已產生 AWS CloudFormation 資源的資訊，請參閱 產生的 AWS CloudFormation 資源 AWS SAM。

類型：DomainAccessAssociation

必要：否

AWS CloudFormation 相容性：此屬性對 是唯一的 AWS SAM ，並且沒有 AWS CloudFormation 同等的。

使用 Amazon API Gateway 網域名稱設定的基本路徑清單。

類型：列出

必要：否

預設：/

AWS CloudFormation 相容性：此屬性類似於 AWS::ApiGateway::BasePathMapping 資源的 BasePath 屬性。 會 AWS SAM 建立多個AWS::ApiGateway::BasePathMapping資源，每個資源在此屬性中BasePath指定一個。

此網域名稱端點受 AWS 管憑證的 Amazon Resource Name (ARN)。 AWS Certificate Manager 是唯一支援的來源。

類型：字串

必要：是

AWS CloudFormation 相容性：此屬性類似於 AWS::ApiGateway::DomainName 資源的 CertificateArn 屬性。如果 EndpointConfiguration 設定為 REGIONAL（預設值），則 會CertificateArn映射至 中的 RegionalCertificateArnAWS::ApiGateway::DomainName。如果 EndpointConfiguration 設定為 EDGE，則 會CertificateArn映射至 中的 CertificateArnAWS::ApiGateway::DomainName。如果 EndpointConfiguration 設定為 PRIVATE，則此屬性會傳遞至 AWS：：ApiGateway：：DomainNameV2 資源。

其他備註：對於 EDGE端點，您必須在 us-east-1 AWS 區域中建立憑證。

API Gateway API 的自訂網域名稱。不支援大寫字母。

AWS SAM 會在設定此屬性時產生 AWS::ApiGateway::DomainName 資源。如需此案例的資訊，請參閱 已指定 DomainName 屬性。如需所產生 AWS CloudFormation 資源的資訊，請參閱 產生的 AWS CloudFormation 資源 AWS SAM。

類型：字串

必要：是

AWS CloudFormation 相容性：此屬性會直接傳遞至 AWS::ApiGateway::DomainName 資源的 DomainName 屬性，或在 EndpointConfiguration 設定為 AWS::ApiGateway::DomainNameV2時傳遞至 PRIVATE。

定義要映射到自訂網域的 API Gateway 端點類型。此屬性的值會決定CertificateArn屬性的映射方式 AWS CloudFormation。

有效值：EDGE、REGIONAL 或 PRIVATE

類型：字串

必要：否

預設：REGIONAL

AWS CloudFormation 相容性：此屬性對 是唯一的 AWS SAM ，並且沒有 AWS CloudFormation 同等的。

自訂網域名稱的交互 Transport Layer Security (TLS) 身分驗證組態。

類型：MutualTlsAuthentication

必要：否

AWS CloudFormation 相容性：此屬性會直接傳遞至 AWS::ApiGateway::DomainName 資源的 MutualTlsAuthentication 屬性。

指出BasePath屬性定義的 Basepaths 中是否允許非英數字元。設為 時True，會從 basepaths 中移除非英數字元。

NormalizeBasePath 搭配 BasePath 屬性使用 。

類型：布林值

必要：否

預設：True

AWS CloudFormation 相容性：此屬性對 是唯一的 AWS SAM ，並且沒有 AWS CloudFormation 同等的。

ACM 核發之公有憑證的 ARN，用於驗證您的自訂網域的擁有權。只有在您設定交互 TLS 並指定 的 ACM 匯入或私有 CA 憑證 ARN 時才需要CertificateArn。

類型：字串

必要：否

AWS CloudFormation 相容性：此屬性會直接傳遞至 AWS::ApiGateway::DomainName 資源的 OwnershipVerificationCertificateArn 屬性。

要連接至 API Gateway 網域名稱的 IAM 政策。僅適用於 EndpointConfiguration 設為 時PRIVATE。

類型：Json

必要：否

AWS CloudFormation 相容性：EndpointConfiguration當 設定為 時，此屬性會直接傳遞至 AWS::ApiGateway::DomainNameV2 資源的 Policy 屬性PRIVATE。如需有效政策文件的範例，請參閱 AWS：：ApiGateway：：DomainNameV2。

定義 Amazon Route 53 組態。

類型：Route53Configuration

必要：否

AWS CloudFormation 相容性：此屬性對 是唯一的 AWS SAM ，並且沒有 AWS CloudFormation 同等的。

此網域名稱的 TLS 版本加上密碼套件。

類型：字串

必要：否

AWS CloudFormation 相容性：此屬性會直接傳遞至 AWS::ApiGateway::DomainName 資源的 SecurityPolicy 屬性，或在 EndpointConfiguration 設定為 AWS::ApiGateway::DomainNameV2時傳遞至 PRIVATE。對於PRIVATE端點，僅支援 TLS_1_2。