HttpApiDomainConfiguration

設定 API 的自訂網域。

語法

若要在 AWS Serverless Application Model (AWS SAM) 範本中宣告此實體，請使用下列語法。

YAML

  BasePath: List
  CertificateArn: String
  DomainName: String
  EndpointConfiguration: String
  MutualTlsAuthentication: MutualTlsAuthentication
  OwnershipVerificationCertificateArn: String
  Route53: Route53Configuration
  SecurityPolicy: String

屬性

BasePath

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

類型：清單

必要：否

預設值：/

AWS CloudFormation兼容性：此屬性類似於AWS::ApiGatewayV2::ApiMapping資源的ApiMappingKey屬性。 AWS SAM會建立多個AWS::ApiGatewayV2::ApiMapping資源，每個在此屬性中指定的值一個資源。

CertificateArn

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

類型：字串

必要：是

AWS CloudFormation兼容性：此屬性直接傳遞給AWS::ApiGateway2::DomainName DomainNameConfiguration資源的CertificateArn屬性。

DomainName

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

AWS SAM設置此屬性時生成一個AWS::ApiGatewayV2::DomainName資源。如需有關此案例的資訊，請參閱DomainName屬性已指定。如需有關已產生AWS CloudFormation資源的資訊，請參閱產生的 AWS CloudFormation 資源。

類型：字串

必要：是

AWS CloudFormation兼容性：此屬性直接傳遞給AWS::ApiGateway2::DomainName資源的DomainName屬性。

EndpointConfiguration

定義要對應至自訂網域的 API Gateway 端點類型。此屬性的值決定了對應CertificateArn性質的方式AWS CloudFormation。

HTTP API 的唯一有效值是REGIONAL。

類型：字串

必要：否

預設：REGIONAL

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

MutualTlsAuthentication

自訂網域名稱的相互傳輸層安全性 (TLS) 驗證組態。

類型:MutualTlsAuthentication

必要：否

AWS CloudFormation兼容性：此屬性直接傳遞給AWS::ApiGatewayV2::DomainName資源的MutualTlsAuthentication屬性。

OwnershipVerificationCertificateArn

ACM 核發之公有憑證的 ARN，用於驗證您的自訂網域的擁有權。只有當您設定相互 TLS，並指定 ACM 匯入或私有 CA 憑證 ARN 給. CertificateArn

類型：字串

必要：否

AWS CloudFormation兼容性：此屬性直接傳遞給AWS::ApiGatewayV2::DomainNameDomainNameConfiguration數據類型的OwnershipVerificationCertificateArn屬性。

Route53

定義 Amazon 路線 53 配置。

類型：路線 53 配置

必要：否

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

SecurityPolicy

此網域名稱的安全性原則的 TLS 版本。

HTTP API 的唯一有效值是TLS_1_2。

類型：字串

必要：否

AWS CloudFormation兼容性：此屬性直接傳遞給AWS::ApiGatewayV2::DomainNameDomainNameConfiguration數據類型的SecurityPolicy屬性。

範例

DomainName

DomainName 例子

YAML

Domain:
  DomainName: www.example.com
  CertificateArn: arn-example
  EndpointConfiguration: REGIONAL
  Route53:
    HostedZoneId: Z1PA6795UKMFR9
  BasePath:
    - foo
    - bar