Route53Configuration

为 API 配置 Route53 记录集。

语法

要在您的 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资源并将提供的资源的 Type 设置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::RecordSetGroup RecordSet 数据类型的 Region 属性。

SetIdentifier

具有简单策略以外的路由策略的资源记录集：用于区分具有相同名称和类型组合的多个资源记录集的标识符，如名为 acme.example.com 且类型为 A 的多个加权资源记录集。在一组具有相同名称和类型的资源记录集中，每个资源记录集的 SetIdentifier 值必须唯一。

有关路由策略的信息，请参阅《Amazon Route 53 开发人员指南》中的选择路由策略。

类型：字符串

必需：否

AWS CloudFormation 兼容性：此属性直接传递给 AWS::Route53::RecordSetGroup RecordSet 数据类型的 SetIdentifier 属性。

示例

Route 53 配置示例

此示例演示了如何配置 Route 53。

YAML

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