Route53Configuration

設定 API 的路由 53 記錄集。

語法

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

YAML

  DistributionDomainName: String
  EvaluateTargetHealth: Boolean
  HostedZoneId: String
  HostedZoneName: String
  IpV6: Boolean
  Region: String
  SetIdentifier: String

屬性

DistributionDomainName

設定 API 自訂網域名稱的自訂分發。

類型：字串

必要：否

預設值：使用 API Gateway 分發。

AWS CloudFormation兼容性：此屬性直接傳遞給AWS::Route53::RecordSetGroup AliasTarget資源的DNSName屬性。

其他注意事項：CloudFront發行版的網域名稱。

EvaluateTargetHealth

當 EvaluateTargetHealth 為 true 時，別名記錄會繼承參考AWS資源的健全狀況，例如 Elastic Load Balancing 負載平衡器或託管區域中的其他記錄。

類型：布林值

必要：否

AWS CloudFormation兼容性：此屬性直接傳遞給AWS::Route53::RecordSetGroup AliasTarget資源的EvaluateTargetHealth屬性。

其他注意事項：當別名目標是 CloudFront 發佈時，您無法設定 EvaluateTargetHealth 為 true。

HostedZoneId

託管區域的 ID，您要在其中建立記錄。

請指定 HostedZoneName 或 HostedZoneId 其中之一。若有多個託管區域的網域名稱相同，則您必須使用 HostedZoneId 以明確指定託管區域。

類型：字串

必要：否

AWS CloudFormation兼容性：此屬性直接傳遞給AWS::Route53::RecordSetGroup RecordSet資源的HostedZoneId屬性。

HostedZoneName

您要在其中建立記錄的託管區域名稱。您必須包含結尾點 (例如 www.example.com.) 作為 HostedZoneName 的一部分。

請指定 HostedZoneName 或 HostedZoneId 其中之一。若有多個託管區域的網域名稱相同，則您必須使用 HostedZoneId 以明確指定託管區域。

類型：字串

必要：否

AWS CloudFormation兼容性：此屬性直接傳遞給AWS::Route53::RecordSetGroup RecordSet資源的HostedZoneName屬性。

IpV6

設定此屬性後，AWS SAM會為提供的建立AWS::Route53::RecordSet資源並將「類型」設定AAAA為 HostedZone。

類型：布林值

必要：否

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

Region

僅限延遲型資源記錄集：您建立資源的 Amazon EC2 區域，這是此資源記錄集指向的資源。資源一般是 AWS 資源 (例如 EC2 執行個體或 ELB 負載平衡器)，且以 IP 地址或 DNS 網域名稱表示 (視記錄類型而定)。

當 Amazon Route 53 收到網域名稱和類型的 DNS 查詢，而您已建立其延遲資源記錄集時，Route 53 會選取最低延遲介於最終使用者與相關聯 Amazon EC2 區域之間的延遲資源記錄集。Route 53 接著會傳回與所選資源記錄集相關聯的值。

注意下列事項：

• 每個延遲資源記錄集只能指定一個 ResourceRecord。

• 每個 Amazon EC2 區域都只能建立一個延遲資源記錄集。

• 您不必為所有的 Amazon EC2 區域建立延遲資源記錄集。Route 53 會從您建立延遲資源記錄集的區域中，選擇具有最佳延遲的區域。

• 您無法建立和延遲資源記錄集的 Name 和 Type 元素具有相同值的非延遲資源記錄集。

類型：字串

必要：否

AWS CloudFormation兼容性：此屬性直接傳遞給AWS::Route53::RecordSetGroupRecordSet數據類型的 Region屬性。

SetIdentifier

沒有簡單路由政策的資源記錄集：在具有相同名稱和類型組合的多個資源記錄集中用以區隔的識別碼，例如，多個加權資源記錄集名為 acme.example.com 且類型為 A。在一組具有相同名稱和類型的資源記錄集中，每個資源記錄集的 SetIdentifier 值都必須是唯一的。

如需有關路由政策的資訊，請參閱 Amazon Route 53 開發人員指南中的選擇路由政策。

類型：字串

必要：否

AWS CloudFormation兼容性：此屬性直接傳遞給AWS::Route53::RecordSetGroupRecordSet數據類型的 SetIdentifier屬性。

範例

Route 53 組態範例

此範例顯示如何設定路由 53。

YAML

Domain:
  DomainName: www.example.com
  CertificateArn: arn-example
  EndpointConfiguration: EDGE
  Route53:
    HostedZoneId: Z1PA6795UKMFR9
    EvaluateTargetHealth: true
    DistributionDomainName: xyz