你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Microsoft.AwsConnector route53ResourceRecordSets 2024-12-01

Bicep 资源定义

可以使用目标操作部署 route53ResourceRecordSets 资源类型:

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.AwsConnector/route53ResourceRecordSets 资源,请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.AwsConnector/route53ResourceRecordSets@2024-12-01' = {
  location: 'string'
  name: 'string'
  properties: {
    arn: 'string'
    awsAccountId: 'string'
    awsProperties: {
      aliasTarget: {
        dnsName: 'string'
        evaluateTargetHealth: bool
        hostedZoneId: 'string'
      }
      cidrRoutingConfig: {
        collectionId: 'string'
        locationName: 'string'
      }
      failover: {
        value: 'string'
      }
      geoLocation: {
        continentCode: 'string'
        countryCode: 'string'
        subdivisionCode: 'string'
      }
      geoProximityLocation: {
        awsRegion: 'string'
        bias: int
        coordinates: {
          latitude: 'string'
          longitude: 'string'
        }
        localZoneGroup: 'string'
      }
      healthCheckId: 'string'
      multiValueAnswer: bool
      name: 'string'
      region: {
        value: 'string'
      }
      resourceRecords: [
        {
          value: 'string'
        }
      ]
      setIdentifier: 'string'
      trafficPolicyInstanceId: 'string'
      ttl: int
      type: {
        value: 'string'
      }
      weight: int
    }
    awsRegion: 'string'
    awsSourceSchema: 'string'
    awsTags: {
      {customized property}: 'string'
    }
    publicCloudConnectorsResourceId: 'string'
    publicCloudResourceName: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

属性值

Microsoft.AwsConnector/route53ResourceRecordSets

名字 描述 价值
位置 资源所在的地理位置 string (必需)
名字 资源名称 字符串

约束:
模式 = ^(?=.{0,259}[^\s.]$)(?!.*[<>%&\?/#]) (必需)
性能 此资源的资源特定属性。 Route53ResourceRecordSet属性
标签 资源标记 标记名称和值的字典。 请参阅模板 中的 标记

别名目标

名字 描述 价值
dns名称 <p><i>别名资源记录集:</i> 指定的值取决于要路由查询的位置:</p><dl><dt>Amazon API Gateway 自定义区域 API 和边缘优化 API</dt><dd><p>指定 API 的适用域名。 可以使用 CLI 命令 <href='https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-domain-names.html'>get-domain-names</a /a>获取适用值:</p><ul><li><p>对于区域 API,请指定区域 API<regionalDomainName>/code<>代码的值。</p></li><li><p>对于边缘优化 API,请指定 <代码的值>distributionDomainName</code>。 这是关联的 CloudFront 分发的名称,例如 <代码>da1b2c3d4e5.cloudfront.net</code>。</p></li></ul><注释><p>创建的记录的名称必须与 API 的自定义域名匹配,例如 <代码>api.example.com</code>。</p></note></dd><dt>Amazon Virtual Private Cloud interface</dt><dd><p>输入接口终结点的 API 终结点,例如 <代码>vpce-123456789abcdef01-example-us-east-1a.elasticloadbalancing.us-east-1.vpce.amazonaws.com</code>。 对于边缘优化的 API,这是相应 CloudFront 分发的域名。 可以使用 CLI 命令 <href='>'<describe->'</a /a /https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-vpc-endpoints.html获取 >代码的值<DnsName>/code<。>/p<>/dd<>dt<CloudFront 分发>/dt<>dd<>p<指定创建分发时 CloudFront 分配的域名。>/p<>pCloudFront 分发必须包含与资源记录集名称匹配的备用域名。 例如,如果资源记录集的名称 <i>acme.example.com</i>,则 CloudFront 分发必须包含 <i>acme.example.com</i> 作为备用域名之一。 有关详细信息,请参阅 <ihttps://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/CNAMEs.htmlAmazon CloudFront 开发人员指南>/i<>/i<<使用备用域名</a><href='>。</p><p>无法在专用托管区域中创建资源记录集以将流量路由到 CloudFront 分发。</p><注释>p对于故障转移别名记录,不能同时为主要记录和辅助记录指定 CloudFront 分发。 分发必须包含与记录名称匹配的备用域名。 但是,主记录和辅助记录具有相同的名称,并且不能在多个分发版中包含相同的备用域名。 </p></note></dd><dt>Elastic Beanstalk 环境</dt><dd><p>如果 Elastic Beanstalk 环境的域名包括在其中部署环境的区域,则可以创建将流量路由到环境的别名记录。 例如,域名 <代码>my-environment。<i>us-west-2</i>.elasticbeanstalk.com</code> 是区域化域名。 </p><重要的><p>对于在 2016 年初创建的环境,域名不包括该区域。 若要将流量路由到这些环境,必须创建 CNAME 记录而不是别名记录。 请注意,无法为根域名创建 CNAME 记录。 例如,如果域名 example.com,则可以创建一条记录,用于将 acme.example.com 流量路由到 Elastic Beanstalk 环境,但无法创建将 example.com 流量路由到 Elastic Beanstalk 环境的记录。对于具有区域化子域的弹性 Beanstalk 环境,</p></important></>p,请为环境指定 <代码>CNAME</code> 属性。 可以使用以下方法获取 CNAME 属性的值:</p><ul><li><p><i>Amazon Web Services Management Console</i>:有关如何使用主机获取值的信息, 请参阅 <ihttps://docs.aws.amazon.com/elasticbeanstalk/latest/dg/customdomains.htmlElastic Beanstalk 开发人员指南>/i 中的 <href='>'<将自定义域与弹性 Beanstalk>/a< 配合使用>。</p></li><li><p><i>Elastic Beanstalk API</i>:使用 <代码>DescribeEnvironments</code> 操作获取 <代码>CNAME</code> 属性的值。 有关详细信息,请参阅 <ihttps://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_DescribeEnvironments.htmlElastic Beanstalk API 参考>/i>/i> 中的<describeEnvironments><'>'<href='>。</p></li><li><p><i>CLI</i>:使用 <代码>描述环境</code> 命令获取 <代码>CNAME/code 属性的值。 有关详细信息,请参阅 <https://docs.aws.amazon.com/cli/latest/reference/elasticbeanstalk/describe-environments.htmlCLI 命令参考>/i<中的>描述环境</a><href='>。</p></li></ul></dd><dt>ELB 负载均衡器</dt><dd><p>指定与负载均衡器关联的 DNS 名称。 使用 Amazon Web Services 管理控制台、ELB API 或 CLI 获取 DNS 名称。 </p><ul><li><p><b>Amazon Web Services 管理控制台</b>: 转到 EC2 页, 在导航窗格中选择 <b>负载均衡器</b>,选择负载均衡器,选择 <b>说明</b> 选项卡,并获取 <b>DNS 名称</b> 字段的值。 </p><p>如果要将流量路由到经典负载均衡器,请获取以 <b>dualstack</b>开头的值。 如果要将流量路由到另一种类型的负载均衡器,请获取应用于记录类型 A 或 AAAA 的值。</p></li><li><p><b>弹性负载均衡 API</b>:使用 <代码>DescribeLoadBalancers</code> 获取 <代码>DNSName</code>的值。 有关详细信息, 请参阅适用的指南:</p><ul><li><p>经典负载均衡器:<href='https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_DescribeLoadBalancers.html'>DescribeLoadBalancers</a /></p></li><li><p>应用程序和网络负载均衡器:<href='https://docs.aws.amazon.com/elasticloadbalancing/latest/APIReference/API_DescribeLoadBalancers.html'>DescribeLoadBalancers</a /></p></li></ul></li><li><p><b>CLI</b>:使用 <代码>描述负载均衡器</code> 获取 <代码的值>DNSName</code>。 有关详细信息, 请参阅适用的指南:</p><ul><li><p>经典负载均衡器:<href='http://docs.aws.amazon.com/cli/latest/reference/elb/describe-load-balancers.html'>describe-load-balancers</a></p></li><li><p>应用程序和网络负载均衡器:<href='http://docs.aws.amazon.com/cli/latest/reference/elbv2/describe-load-balancers.html'>describe-load-balancers</a /></p></li></ul></li></ul></dd><dt>Global Accelerator accelerator</dt><dd><p>指定加速器的 DNS 名称:</p><ul><li><p><b>Global Accelerator API:</b> 获取 DNS 名称, 使用 <href='https://docs.aws.amazon.com/global-accelerator/latest/api/API_DescribeAccelerator.html'>DescribeAccelerator</a>.</p></li><li><p><b>CLI:</b> 若要获取 DNS 名称,请使用 <href='https://docs.aws.amazon.com/cli/latest/reference/globalaccelerator/describe-accelerator.html'>describe-accelerator</a />。</p></li></ul></dd><dt>Amazon S3 存储桶,该存储桶配置为静态网站</dt><dd><p>指定在其中创建了存储桶的 Amazon S3 网站终结点的域名,例如,<代码>s3-website.us-east-2.amazonaws.com</code>。 有关有效值的详细信息,请参阅 <ihttps://docs.aws.amazon.com/general/latest/gr/s3.html#s3_website_region_endpointsAmazon Web Services 常规参考>/i<>amazon S3 网站终结点</> a<的表 >href='<。 有关将 S3 存储桶用于网站的详细信息,请参阅 <ihttps://docs.aws.amazon.com/Route53/latest/DeveloperGuide/getting-started.htmlAmazon Route 53 开发人员指南中的 >href='<>“>Amazon Route 53 入门>/a<。>/i<>/p<>/dd<>dt<另一个路由 53 资源记录集>/dt<>dd<>p<指定当前托管区域中资源记录集 >代码<名称>/code< 元素的值。>/p<>注释<>p<如果要创建与托管区域(称为区域顶点)同名的别名记录,则无法为 >代码<类型>/code<>代码<CNAME>/code的记录指定域名。 这是因为别名记录的类型必须与要将流量路由到的记录具有相同的类型,并且即使别名记录也不支持为区域顶点创建 CNAME 记录。</p></note></dd></dl> 字符串
评估目标健康 <p><i>仅适用于别名, 故障转移别名、地理位置别名、延迟别名和加权别名资源记录集:</i> 当 <代码>EvaluateTargetHealth</code><代码>true</code>,别名资源记录集将继承引用的 Amazon Web Services 资源的运行状况, 例如 ELB 负载均衡器或托管区域中的其他资源记录集。</p><p>请注意:</p><dl><dt>cloudFront 分发版</dt><dd><p><当别名目标为 CloudFront 分发时,无法将 evaluateTargetHealth>/code<><true>/code< 的代码设置为 >代码。</p></dd><dt>具有区域化子域的弹性 Beanstalk 环境</dt><dd><p>如果在 dnsName<DNSName>/code< 中指定弹性 Beanstalk >环境,并且环境包含 ELB 负载均衡器, 弹性负载均衡仅将查询路由到向负载均衡器注册的正常运行的 Amazon EC2 实例。 (如果环境包含多个 Amazon EC2 实例,则会自动包含 ELB 负载均衡器。如果将 <代码>EvaluateTargetHealth</code> 设置为 <代码,>true</code> 且没有 Amazon EC2 实例正常,或者负载均衡器本身不正常,则 Route 53 会将查询路由到运行正常的其他可用资源(如果有)。 </p><p>如果环境包含单个 Amazon EC2 实例,则没有特殊要求。</p></dd><dt>ELB 负载均衡器</dt><dd><p>运行状况检查行为取决于负载均衡器的类型:</p><ul><li><p><b>经典负载均衡器</b>:如果在 DNSName</code><>代码中指定 ELB 经典负载均衡器, 弹性负载均衡仅将查询路由到向负载均衡器注册的正常运行的 Amazon EC2 实例。 如果将 <代码>EvaluateTargetHealth</code> 设置为 <代码,>true</code> 且没有 EC2 实例正常或负载均衡器本身不正常,则 Route 53 会将查询路由到其他资源。</p></li><li><p><p>应用程序和网络负载均衡器</b>:如果指定 ELB 应用程序或网络负载均衡器,并且设置了 <代码>< EvaluateTargetHealth>/code<><true>/code<,路由 53 将查询路由到负载均衡器,具体取决于与负载均衡器关联的目标组的运行状况:>/p<>ul<>li<>p要使应用程序或网络负载均衡器被视为正常,包含目标的每个目标组必须至少包含一个正常的目标。 如果任何目标组仅包含不正常的目标,则负载均衡器被视为不正常,路由 53 会将查询路由到其他资源。</p></li><li><p>没有已注册目标的目标组被视为不正常。</p></li></ul></li></ul><注释><p>创建负载均衡器时,请配置弹性负载均衡运行状况检查的设置;它们不是 Route 53 运行状况检查,但它们执行类似的功能。 不要为向 ELB 负载均衡器注册的 EC2 实例创建路由 53 运行状况检查。 </p></note></dd><dt>S3 存储桶</dt><dd><p>没有特殊 将 <代码>EvaluateTargetHealth</code> 设置为在别名目标为 S3 存储桶时,<true>/code<>代码的要求。</p></dd><dt>同一托管区域中的其他记录</dt><dd><p>如果 <代码中指定的 Amazon Web Services 资源>DNSName</code> 是记录或一组记录(例如,一组加权记录),但不是另一个别名记录, 建议将运行状况检查与别名目标中的所有记录相关联。 有关详细信息,请参阅 <href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-complex-configs.html#dns-failover-complex-configs-hc-omitting'>省略运行状况检查时会发生什么情况?<i>Amazon Route 53 开发人员指南</i>中的</a>。</p></dd></dl><p>有关详细信息和示例,请参阅 <https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover.html>Amazon Route 53 运行状况检查和 DNS 故障转移</a><i>Amazon Route 53 开发人员指南</i>。</p> 布尔
托管区域 ID <p><i>别名资源记录仅设置</i>:使用的值取决于要路由流量的位置:</p><dl><dt>Amazon API 网关自定义区域 API 和边缘优化 API</dt><dd><p>指定 API 的托管区域 ID。 可以使用 CLI 命令 <href='https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-domain-names.html'>get-domain-names</a />获取适用值:</p><ul><li><p>对于区域 API,请指定区域 API<区域HostedZoneId>/code<>代码的值。</p></li><li><p>对于边缘优化 API,请指定 <code>distributionHostedZoneId</code>的值。</p></li></ul></dd><dt>Amazon 虚拟私有云接口</dt><dd><p>指定接口终结点的托管区域 ID。 可以使用 CLI 命令 <href='>'<describe->'</a /a /https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-vpc-endpoints.html获取>HostedZoneId</code >< 代码的值。>/p<>/dd<>dt<CloudFront 分发>/dt<>dd<>p<指定 >代码<Z2FDTNDATAQYW2>/code<。>/p<>注释<>p<CloudFront 的别名资源记录集无法在专用区域中创建。>/p<>/note<>/dd<>dt<Elastic Beanstalk 环境>/dt<>dd<>p指定在其中创建环境的区域的托管区域 ID。 环境必须具有区域化子域。 有关区域列表和相应的托管区域 ID,请参阅 <href='https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html'>Elastic Beanstalk 终结点和配额</a><i>Amazon Web Services 常规参考</i>。</p></dd><dt>ELB 负载均衡器</dt><dd><p>指定负载均衡器的托管区域 ID 的值。 使用以下方法获取托管区域 ID:</p><ul><li><p><href='https://docs.aws.amazon.com/general/latest/gr/elb.html'>弹性负载均衡终结点和 <i>Amazon Web Services 常规参考</i>中的配额</a /a> 主题:使用与在其中创建负载均衡器的区域对应的值。 请注意,应用程序和经典负载均衡器以及网络负载均衡器有单独的列。</p></li><li><p><b>Amazon Web Services Management Console</b>: 转到 Amazon EC2 页面, 在导航窗格中选择 <b>负载均衡器</b>,选择负载均衡器,然后在 <b>说明</b> 选项卡上获取 <b>托管区域</b> 字段的值。</p></li><li><p><b>弹性负载均衡 API</b>:使用 <代码>DescribeLoadBalancers</code> 获取适用值。 有关详细信息,请参阅适用的指南:</p><ul><li><p>经典负载均衡器:使用 <href='https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_DescribeLoadBalancers.html'>DescribeLoadBalancers</a /> 获取 <代码的值>CanonicalHostedZoneNameId</code>。</p></li><li><p>应用程序和网络负载均衡器:使用 <href='https://docs.aws.amazon.com/elasticloadbalancing/latest/APIReference/API_DescribeLoadBalancers.html'>DescribeLoadBalancers</a /> 获取 <代码的值>CanonicalHostedZoneId</code>。</p></li></ul></li><><li><p><b>CLI</b>:使用 <代码>describe-load-balancers/code 获取适用值。 有关详细信息,请参阅适用的指南:</p><ul><li><p>经典负载均衡器:使用 <href='http://docs.aws.amazon.com/cli/latest/reference/elb/describe-load-balancers.html'>describe-load-balancers</a> 获取 <代码的值,>CanonicalHostedZoneNameId</code>。</p></li><li><p>应用程序和网络负载均衡器:使用 <href='http://docs.aws.amazon.com/cli/latest/reference/elbv2/describe-load-balancers.html'>描述负载均衡器</a> 获取 <代码的值>CanonicalHostedZoneId</code>。</p></li></ul></li></ul></dd><dt>global Accelerator accelerator</dt><dd><p>指定 <代码>Z2BJ6XQ5FK7U4H</code>。</p></dd><dt>配置为静态网站</dt><dd><p>指定在其中创建存储桶的区域的托管区域 ID。 有关有效值的详细信息,请参阅 <ihttps://docs.aws.amazon.com/general/latest/gr/s3.html#s3_website_region_endpointsAmazon Web Services 常规参考>/i<>amazon S3 网站终结点</> a<的表 >href='<。>/p<>/dd<>dt<托管区域中的另一个路由 53 资源记录集>/dt<>dd<>p指定托管区域的托管区域 ID。 (别名资源记录集不能引用其他托管区域中的资源记录集。</p></dd></dl> 字符串

AwsRoute53ResourceRecordSet属性

名字 描述 价值
aliasTarget <p><i>别名资源记录集:</i> 有关 Amazon Web Services 资源的信息,例如 CloudFront 分发或要向其路由流量的 Amazon S3 存储桶。 </p><p>如果要为专用托管区域创建资源记录集,请注意以下事项:</p><ul><li><p>无法在专用托管区域中创建别名资源记录集以将流量路由到 CloudFront 分发。</p></li><li><p>有关在专用托管区域中创建故障转移资源记录集的信息,请参阅 <href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-private-hosted-zones.html'>在专用托管区域</a><i>Amazon Route 53 开发人员指南</i>。</p></li></ul> 别名目标
cidrRoutingConfig 属性 cidrRoutingConfig CidrRoutingConfig
故障转移 <p><i>故障转移资源记录集:</i> 若要配置故障转移,请将 <代码>故障转移</code> 元素添加到两个资源记录集。 对于一个资源记录集,请将 PRIMARY<PRIMARY>/code< 指定为 ><代码>故障转移</code>的值;对于其他资源记录集,指定 <代码>SECONDARY</code>。 此外,还包括 healthCheckId<healthCheckId>/code< 元素 >代码,并指定希望 Amazon Route 53 针对每个资源记录集执行的运行状况检查。</p><p>,除非另有指出, 以下故障转移行为假定你已将 <代码>HealthCheckId</code> 元素包含在这两个资源记录集中:</p><ul><li><p>当主资源记录集正常运行时,Route 53 会响应具有主要资源记录集中适用值的 DNS 查询,而不考虑辅助资源记录集的运行状况资源记录集。</p></li><li><p>当主资源记录集运行不正常且辅助资源记录集正常时,Route 53 将响应具有辅助资源记录集中适用值的 DNS 查询。</p></li><li><p>当辅助资源记录集运行不正常时,Route 53 将响应具有主要资源记录集中适用值的 DNS 查询,而不管主要资源记录集的运行状况如何。</p></li><li><p>如果省略辅助资源记录集的 <代码>HealthCheckId</code> 元素,如果主要资源记录集运行不正常,则 Route 53 始终响应具有辅助资源记录集中适用值的 DNS 查询。 无论关联的终结点的运行状况如何,这都是真实的。</p></li></ul><p>无法创建与故障转移资源记录集相同的 <代码>名称</code> 和 <代码>类型</code> 元素作为故障转移资源记录集的值。</p><p>对于故障转移别名资源记录集,还必须包括 evaluateTargetHealth</code> 元素<>代码,并将值设置为 true。</p><p>有关为路由 53 配置故障转移的详细信息, 请参阅 <i>Amazon Route 53 开发人员指南</i>中的以下主题:</p><ul><li><p><a href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover.html'>Route 53 运行状况检查和 DNS 故障转移</a></p></li><li><p><href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-private-hosted-zones.html'>在专用托管区域配置故障转移</a></p></li></ul> ResourceRecordSetFailoverEnumValue
地理位置 <p><i>地理位置资源记录集:</i> 一种复杂类型,用于控制 Amazon Route 53 如何根据查询的地理来源响应 DNS 查询。 例如, 如果要将所有来自非洲的查询路由到 IP 地址为 <代码>192.0.2.111</code>的 Web 服务器,请创建具有 <代码>类型>的资源记录集><代码>A</code><>/code<>/code<>/code<>code<AF>/code<。>/pp如果为重叠地理区域创建单独的资源记录集(例如,一个针对一大洲的资源记录集和一个针对同一大洲的国家/地区),优先级将转到最小的地理区域。 这样,就可以将大陆的大多数查询路由到一个资源,并将该大洲国家/地区的查询路由到其他资源。</p><p>无法创建两个指定相同地理位置的地理位置资源记录集。</p><p><>代码<>/code< 的值>CountryCode</code> 元素匹配所有地理位置 在其他地理位置资源记录集中未指定,<代码>名称</code> 和 <代码>类型</code> 元素的值相同。</p><重要的><p>地理位置的工作原理是将 IP 地址映射到位置。但是,某些 IP 地址不会映射到地理位置,因此,即使你创建涵盖所有七大洲的地理位置资源记录集,Route 53 也会从无法识别的位置接收一些 DNS 查询。建议创建一个资源记录集,<代码>CountryCode</code> 的值 <代码></code>。 两组查询将路由到在此记录中指定的资源:查询来自尚未为其创建地理位置资源记录集的位置的查询,以及来自未映射到位置的 IP 地址的查询。 如果未创建 <代码>*</code> 资源记录集,则 Route 53 将返回来自这些位置的查询的“无答案”响应。</p></important><p>无法创建 <代码>名称</code> 值的非地理位置资源记录集,<代码>Type</code> 元素作为地理位置资源记录集。</p> 地理位置
geoProximityLocation <p><i> GeoproximityLocation 资源记录集:</i> 复杂类型,用于控制 Route 53 如何根据查询和资源地理来源响应 DNS 查询。 </p> GeoProximityLocation
healthCheckId <p>如果希望 Amazon Route 53 仅当运行状况检查状态正常时返回此资源记录集,请包含运行状况检查状态<healthCheckId>/code< 元素的 >代码,并指定适用的运行状况检查的 ID。</p><p>Route 53 确定资源记录集是否正常,具体取决于以下项之一:</p><ul><li><p>By 定期将请求发送到在运行状况检查中指定的终结点</p></li><li><p>通过聚合指定运行状况检查组的状态(计算的运行状况检查)</p></li><li><p>通过确定 CloudWatch 警报(CloudWatch 指标运行状况检查)的当前状态</p></li></ul><重要><p>Route 53 不会检查资源记录集中指定的终结点的运行状况, 例如,<代码中 IP 地址指定的终结点>Value</code> 元素。 将 <代码>HealthCheckId</code> 元素添加到资源记录集时,Route 53 会检查在运行状况检查中指定的终结点的运行状况。 </p></important><p>有关详细信息, 请参阅 <i>Amazon Route 53 开发人员指南</i>中的以下主题:</p><ul><li><p><href=“https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-determining-health-of-endpoints.html'>Amazon Route 53 如何确定终结点是否正常</a /></p></li><li><p><href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover.html'>路由 53 运行状况检查和 DNS 故障转移</a></p></li><li><p><href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-private-hosted-zones.html'>配置专用托管区域中的故障转移</a /a></p></li></ul><p><b>何时指定 HealthCheckId</b></p><p><指定 healthCheckId>code>HealthCheckId>/仅当 Route 53 在两个或多个资源记录集之间进行选择以响应 DNS 查询时,代码 才有用,并且希望 Route 53 根据运行状况检查的状态设置选择。 配置运行状况检查仅在以下配置中才有意义:</p><ul><li><p><b>非别名资源记录集</b>:您正在检查一组具有相同路由策略、名称和类型的非别名资源记录集的运行状况(例如,以 A 类型命名www.example.com的多个加权记录),并且您为所有资源记录集指定运行状况检查 ID。 </p><p>如果资源记录集的运行状况检查状态正常,则 Route 53 包含响应 DNS 查询的记录中的记录。</p><p>如果资源记录集的运行状况检查状态不正常,则 Route 53 停止使用该资源记录集的值响应 DNS 查询。</p><p>如果组中所有资源记录集的运行状况检查状态不正常,则 Route 53 会考虑组中的所有资源记录集正常,并相应地响应 DNS 查询。 </p></li><li><p><b>别名资源记录集</b>:您指定以下设置:</p><ul><li><p>您将一组具有相同路由策略、名称和类型的资源记录集中的别名资源记录集的 code<EvaluateTargetHealth>/code< 设置为 >true(例如,以 A 类型命名www.example.com的多个加权记录)。 </p></li><li><p>配置别名资源记录集,以将流量路由到同一托管区域中的非别名资源记录集。</p></li><li><p>为非别名资源记录集指定运行状况检查 ID。 </p></li></ul><p>如果运行状况检查状态正常,则 Route 53 会将别名资源记录设置为正常,并在响应 DNS 查询的记录中包含别名记录。</p><p>如果运行状况检查状态不正常,则 Route 53 会停止使用别名资源记录集响应 DNS 查询。</p><注释><p>别名资源记录集还可以将流量路由到 <i>组</i> 具有相同路由策略、名称和类型的非别名资源记录集。 在该配置中,将运行状况检查与非别名资源记录集中的所有资源记录集相关联。</p></note></li></ul><p><b>地理位置路由</b></p><>对于地理位置资源记录集,如果终结点运行不正常,则 Route 53 会查找更大的关联地理区域的资源记录集。 例如,假设你有一个状态的资源记录集、整个美国、北美的资源记录集,以及一个 <代码></code> 的资源记录集,<代码>CountryCode</code><代码></code>,适用于所有位置。 如果状态资源记录集的终结点不正常, 路由 53 按以下顺序检查正常的资源记录集,直到找到终结点正常运行的资源记录集:</p><ul><li><p>美国</p></li><li><p>p</p></li><li><p>默认资源记录集</p></li></ul><p><b>指定运行状况检查终结点(按域名</b></p><p>如果运行状况检查仅按域名指定终结点,建议为每个终结点创建单独的运行状况检查。 例如,为每个 <代码>HTTP</code> 服务器创建运行状况检查,该服务器为 <代码>www.example.com</code>提供内容。 对于 <代码的值>FullyQualifiedDomainName</code>,请指定服务器的域名(如 <代码>us-east-2-www.example.com</code>),而不是资源记录集的名称(<代码>www.example.com</code>)。如果执行以下操作,</p><><p>运行状况检查结果将不可预知:</p><ul><li><p>创建与资源记录集名称相同的 <代码>FullQualifiedDomainName</code> 的值的运行状况检查。</p></li><li><p>将运行状况检查与资源记录集相关联。</p></li></ul></important> 字符串
multiValueAnswer 多值答案 <p><i>Multivalue 应答资源记录集仅</i>:若要将流量随机路由到多个资源(例如 Web 服务器),请为每个资源创建一个多值应答记录,并为 <代码>MultiValueAnswer</code>指定 <代码>true</code>。 请注意以下事项:</p><ul><li><p>如果将运行状况检查与多值应答资源记录集相关联,则 Amazon Route 53 仅当运行状况检查正常时才响应具有相应 IP 地址的 DNS 查询。</p></li><li><p>如果不将运行状况检查与多值应答记录相关联,则 Route 53 始终将记录视为正常。</p></li><li><p>Route 53 响应最多八条正常记录的 DNS 查询;如果有 8 条或更少条正常记录,则 Route 53 会使用所有正常记录响应所有 DNS 查询。</p></li><li><p>如果你有 8 个以上的正常记录,Route 53 将响应具有不同组合正常记录的不同 DNS 解析程序。</p></li><li><p>当所有记录都运行不正常时,Route 53 将响应最多包含 8 条不正常记录的 DNS 查询。</p></li><li><p>如果解析程序缓存响应后资源不可用,客户端软件通常会尝试响应中的另一个 IP 地址。</p></li></ul><p>无法创建多值应答别名记录。</p> 布尔
名字 <p>对于 <代码>ChangeResourceRecordSets</code> 请求、要创建、更新或删除的记录的名称。 对于 <代码>ListResourceRecordSets</code> 响应,指定托管区域中记录的名称。</p><p><b>ChangeResourceRecordSets only</b></p><>输入完全限定的域名,例如,<代码>www.example.com</code>。 可以选择包含尾随点。 如果省略尾随点,Amazon Route 53 假定指定的域名是完全限定的。 这意味着 Route 53 处理 <代码>www.example.com</code>(无尾随点)和 <代码>www.example.com。</code>(尾随点)相同。</p><p>有关如何 <代码>a-z</code>指定字符的信息,<代码>0-9</code>,以及 <代码>-</code> (连字符)以及如何指定国际化域名, 请参阅 <ihttps://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DomainNameFormat.htmlAmazon Route 53 开发人员指南>/i /i<中的>DNS 域名格式</a >href='<'>。</p><p>可以使用星号()通配符替换域名中最左侧的标签,例如,<代码>.example.com</code>。 请注意以下事项:</p><ul><li><p>* 必须替换整个标签。 例如,不能指定 <代码>prod.example.com</code> 或 <代码>prod.example.com</code>。</p></li><li><p>* 无法替换任何中间标签,例如 marketing.*.example.com。</p></li><li><p>如果在域名中除最左边的标签之外的任何位置包含 * ,DNS 将其视为 * 字符(ASCII 42),而不是通配符。</p><重要的><p>不能对具有 NS 类型的资源记录集使用 * 通配符。</p></important></li></ul> 字符串
地区 <p><i>基于延迟的资源记录集:</i> 在其中创建了此资源记录集引用的资源的 Amazon EC2 区域。 资源通常是 Amazon Web Services 资源,例如 EC2 实例或 ELB 负载均衡器,并根据记录类型由 IP 地址或 DNS 域名引用。</p><p>Amazon Route 53 收到域名和类型 DNS 查询时,已为其创建延迟资源记录集的域名和类型,Route 53 将选择在最终用户与关联的 Amazon EC2 区域之间具有最低延迟的延迟资源记录集。 然后,Route 53 返回与所选资源记录集关联的值。</p><p>请注意:</p><ul><li><p>只能为每个延迟资源记录集指定一个 <代码>ResourceRecord</code>。</p></li><li><p>只能为每个 Amazon EC2 区域创建一个延迟资源记录集。</p></li><li><p>无需为所有 Amazon EC2 区域创建延迟资源记录集。 路由 53 将从创建延迟资源记录集的区域中选择具有最佳延迟的区域。</p></li><li><p>无法创建 <代码>名称</code><代码>类型</code> 元素作为延迟资源记录集的值的非延迟资源记录集。</p></li></ul> ResourceRecordSetRegionEnumValue
resourceRecords <p>要处理的资源记录的信息。</p><注释><p>如果要创建别名资源记录集,请省略 resourceRecords</code><代码 >代码。</p></note> ResourceRecord[]
setIdentifier 的 <p><i>具有非简单路由策略的资源记录集:</i> 区分名称与类型相同的多个资源记录集,例如 acme.example.com 具有 A 类型的多个加权资源记录集。在具有相同名称和类型的一组资源记录集中,<代码的值>SetIdentifier</code> 对于每个资源记录集必须是唯一的。 </p><p>有关路由策略的信息,请参阅 <href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html'>在 <i>Amazon Route 53 开发人员指南</i>中选择路由策略</a>。</p> 字符串
trafficPolicyInstanceId 流量策略实例 ID <p>创建流量策略实例时,Amazon Route 53 会自动创建资源记录集。 <代码>TrafficPolicyInstanceId</code> 是路由 53 创建此资源记录集的流量策略实例的 ID。</p><重要的><p>若要删除与流量策略实例关联的资源记录集,请使用 <代码>DeleteTrafficPolicyInstance</code>。 路由 53 将自动删除资源记录集。 如果使用 <代码删除资源记录集>ChangeResourceRecordSets</code>,则 Route 53 不会自动删除流量策略实例,即使不再使用,也会继续为其收费。 </p></重要> 字符串
ttl <p>资源记录缓存生存时间(TTL),以秒为单位。 请注意以下事项:</p><ul><li><p>如果要创建或更新别名资源记录集,请省略<TTL>/code<>代码。 Amazon Route 53 使用别名目标的 <代码>TTL</code> 的值。 </p></li><li><p>如果要将此资源记录集与运行状况检查相关联(如果要<HealthCheck 添加 >代码 建议</code> 元素)指定一个 <代码,>TTL</code> 60 秒或更短的时间,以便客户端快速响应运行状况更改。</p></li><li><p>一组加权资源记录集中的所有资源记录集必须具有相同的值,<代码>TTL</code>。</p></li><li><p>如果一组加权资源记录集包含别名目标为 ELB 负载均衡器的一个或多个加权别名资源记录集,建议为所有具有相同名称和类型的非别名加权资源记录集指定 TTL<TTL>/code< 60 秒 >代码。 除 60 秒以外的值(负载均衡器的 TTL)将更改为 <代码指定的值的效果,>Weight</code>。</p></li></ul> 整数 (int)
类型 <p>DNS 记录类型。 有关不同记录类型以及如何对数据进行编码的信息,请参阅 <i Amazon Route 53 开发人员指南https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/ResourceRecordTypes.html/i> 中的 <a href='>'<支持的 DNS 资源记录类型>/a<。></p>p 基本资源记录集的有效值:<代码>A</代码> | <><代码>AAAA</代码> | <代码>CAA</代码> | <代码>CNAME/<code> | <代码>DS</code> |<代码>MX</代码> | <代码>NAPTR</code> | <代码>NS/<代码> | <代码>PTR</代码> | <代码>SOA</代码> | <代码>SPF</代码> | <代码>SRV</代码> | <code>TXT</code></p><p>加权、延迟、地理位置和故障转移资源记录集的值:<code>A</code> | <代码>AAAA</代码> | <代码>CAA</代码> | <代码>CNAME/<code> | <代码>MX</代码> | <代码>NAPTR</code> | <代码>PTR</代码> | <代码>SPF</代码> | <代码>SRV</代码> | <代码>TXT</代码>。 在创建一组加权、延迟、地理位置或故障转移资源记录集时,请为组中的所有资源记录集指定相同的值。</p>p 多值答案资源记录集的有效值:<代码>A</code> | <><代码>AAAA</代码> | <代码>MX</代码> | <代码>NAPTR</code> | <代码>PTR</代码> | <代码>SPF</代码> | <代码>SRV</代码> | <code>TXT</code></p><note><p>SPF 记录以前用于验证电子邮件发件人的身份。 但是,我们不再建议创建 <代码的值>类型</code><代码>SPF</code>的资源记录集。 RFC 7208,<i>发件人策略框架(SPF)在电子邮件中授权使用域,版本 1</i>,已更新为“...[i]ts 存在和 [RFC4408] 中定义的机制导致了一些互操作性问题。 因此,其使用不再适用于 SPF 版本 1;实现不使用它。 在 RFC 7208 中,请参阅第 14.1 节,<href='http://tools.ietf.org/html/rfc7208#section-14.1'>SPF DNS 记录类型</a>。</p></note><p>别名资源记录集的值:</p><ul><li><p><b>Amazon API Gateway 自定义区域 API 和边缘 优化 API:</b><代码>A</code></p></li><li><p><b>CloudFront 分发版:</b><代码>A</code></p><p>如果为分发启用了 IPv6, 创建两个资源记录集以将流量路由到分发,一个资源记录集,其中一个值 <代码>A</code>,一个具有 AAAA</code>的值 <>代码。 </p>/li<>li<>p<>b<具有区域化子域>的 Amazon API Gateway 环境/b<:>代码<A>/code<>/p/li<><> li<>p<>b<ELB 负载均衡器:>/b<>代码<A>/code | <><代码>AAAA</code></p></li><li p><><b>Amazon S3 存储桶:</b><代码>A</code></p></li><li><p><b>Amazon Virtual Private Cloud 接口 VPC 终端节点</b><代码>A</code></p></li><li><p><b>此托管区域中的另一个资源记录集:</b>指定要为其创建别名的资源记录集的类型。 除 <NS>/code<>代码>代码和 >代码<SOA>/code<之外,支持所有值。>/p<>注释<>p<如果要创建与托管区域(称为区域顶点)同名的别名记录(称为区域顶点),则无法将流量路由到>类型</code><代码>CNAME</code>的 代码值。 这是因为别名记录的类型必须与将流量路由到的记录具有相同的类型,并且即使别名记录也不支持为区域顶点创建 CNAME 记录。</p></note></li></ul> RRTypeEnumValue
重量 <p><i>加权资源记录集:</i> 在具有相同 DNS 名称和类型组合的资源记录集中,一个值,用于确定 Amazon Route 53 使用当前资源记录集响应的 DNS 查询的比例。 路由 53 计算具有相同 DNS 名称和类型的资源记录集权重的总和。 然后,路由 53 根据资源的权重与总计的比例响应查询。 请注意以下事项:</p><ul><li><p>必须为每个加权资源记录集指定 <代码>Weight</code> 元素的值。</p></li><li><p>只能为每个加权资源记录集指定一个 <代码>ResourceRecord</code>。</p></li><li><p>无法创建与加权资源记录集相同的 <代码>名称</code> 值以及 <代码>类型</code> 元素作为加权资源记录集的值。</p></li><li><p>最多可以创建 100 个加权资源记录集,这些记录集 <>名称</code> 和 <代码>类型</code> 元素。</p></li><li><p>(但不是加权别名)资源记录集,如果将 <代码>权重</code> 设置为 <代码>0</code> 的资源记录集,则 Route 53 永远不会响应具有该资源记录集适用值的查询。 但是,如果将 <代码>权重</code> 设置为 <代码>0</code>,则具有相同 DNS 名称和类型组合的所有资源记录集的流量将路由到概率相等的所有资源。</p><p>将 <代码>权重</code> 设置为 <代码>0</code> 的效果与加权资源记录集相关联时,将运行状况检查与加权资源记录集相关联。 有关详细信息,请参阅 <ihttps://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.htmlAmazon Route 53 开发人员指南>/i<<Active-Active 和 Active-Passive 故障转移</> a<选项 >href='<'<选项。</p></li>/ul 整数 (int)

CidrRoutingConfig

名字 描述 价值
collectionId <p>CIDR 集合 ID。</p> 字符串
location名称 <p>CIDR 集合位置名称。</p> 字符串

坐标

名字 描述 价值
纬度 <p> 指定地球表面地理点(-90 - 90)的南北位置坐标。 </p> 字符串
经度 <p> 指定地球表面地理点(-180- 180)的东-西位置坐标。 </p> 字符串

地理位置

名字 描述 价值
continentCode <p>非洲大陆的双字母代码。</p><p>Amazon Route 53 支持以下大陆代码:</p><ul><li><p><b>AF</b>: 非洲</p></li><li><p><b>AN</b>: 南极洲</p></li><li><p><b>AS</b>: 亚洲</p></li><li><p><b><>b</b>: 欧洲</p></li><li><p><><b>OC</b>: 大洋洲</p></li><li><p><b>NA</b>: 北美</p></li><li><p><b>sa</b>: 南美洲</p></li></ul><p>约束: 指定 <代码><大洲 >代码<CountryCode>/< code> 或 <代码>SubdivisionCode</code> 返回 <代码>InvalidInput/code 错误。/p 字符串
countryCode (国家代码) <p>对于地理位置资源记录集,一个国家/地区的双字母代码。</p><p>Amazon Route 53 使用在 <href='https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2'>ISO 标准 3166-1 alpha-2</a>中指定的双字母国家/地区代码。</p><p>53 路线还支持乌克兰 <b>UA</b> 的国家代码。</p> 字符串
subdivisionCode <p>对于地理位置资源记录集,为美国州的双字母代码。 Route 53 不支持 <代码>SubdivisionCode</code>的任何其他值。 有关州缩写列表,请参阅美国邮政局网站上的 <href='https://pe.usps.com/text/pub28/28apb.htm'>附录 B: 双字母州和所有权缩写</a>。 </p><p>如果指定 <代码>细分代码</code>,还必须为 <代码>CountryCode</code>指定 <代码>>>/code。 </p> 字符串

GeoProximityLocation

名字 描述 价值
awsRegion <p> 要定向 DNS 流量的资源所在的 Amazon Web Services 区域。 </p> 字符串
偏见 <p> 偏差会增加或减少路由 53 路由到资源的地理区域的大小。 </p><p>若要使用 <代码>偏差</code> 更改地理区域的大小,请指定偏差的适用值:</p><ul><li><p>若要扩展路由 53 路由流量到资源的地理区域的大小, 为偏差指定从 1 到 99 的正整数。 路由 53 会缩小相邻区域的大小。 </p></li><li><p>若要缩小路由 53 路由到资源的地理区域的大小,请指定 -1 到 -99 的负偏差。 路由 53 扩展相邻区域的大小。 </p></li></ul> 整数 (int)
坐标 <p> 包含地理区域的经度和纬度。 </p> 坐标
localZoneGroup <p> 指定 Amazon Web Services 本地区域组。 </p><p>本地区域组通常是本地区域代码,没有结束字符。 例如,如果本地区域 <代码>us-east-1-bue-1a</code> 本地区域组 <代码>us-east-1-bue-1</code>。</p><p>可以使用 href=' <href='https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-availability-zones.html'>describe-availability-zone</a /> CLI 命令:</p><p>此命令返回: <代码>'GroupName' :“us-west-2-den-1”</code>,指定本地区域 <代码>us-west-2-den-1a</code> 属于本地区域组 <代码>us-west-2-den-1</code>。</p> 字符串

资源记录

名字 描述 价值
价值 <p>当前或新的 DNS 记录值,不超过 4,000 个字符。 如果 <代码>DELETE</code> 操作,如果当前值与实际值不匹配,则返回错误。 有关如何为不同记录类型设置 <代码>值</code> 的格式的说明,请参阅 <href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/ResourceRecordTypes.html>'>支持的 DNS 资源记录类型>/<>i<Amazon Route 53 开发人员指南>/i<。>/p<>p<可以为所有记录类型指定多个值,但 CNAME>/code>><代码> 和 <代码>SOA/code。 </p><注释><p>如果要创建别名资源记录集,请省略 <代码>值</code>。</p></note> 字符串

ResourceRecordSetFailoverEnumValue

名字 描述 价值
价值 属性值 “PRIMARY”
“SECONDARY”

ResourceRecordSetRegionEnumValue

名字 描述 价值
价值 属性值 “af-south-1”
“ap-east-1”
“ap-northeast-1”
“ap-northeast-2”
“ap-northeast-3”
“ap-south-1”
“ap-south-2”
“ap-southeast-1”
“ap-southeast-2”
“ap-southeast-3”
“ap-southeast-4”
“ca-central-1”
“ca-west-1”
“cn-north-1”
“cn-northwest-1”
“eu-central-1”
“eu-central-2”
“eu-north-1”
“eu-south-1”
“eu-south-2”
“eu-west-1”
“eu-west-2”
“eu-west-3”
“il-central-1”
“me-central-1”
“me-south-1”
“sa-east-1”
“us-east-1”
“us-east-2”
“us-west-1”
“us-west-2”

Route53ResourceRecordSet属性

名字 描述 价值
阿恩 Amazon 资源名称 (ARN) 字符串
awsAccountId AWS 帐户 ID 字符串
awsProperties AWS 属性 AwsRoute53ResourceRecordSet属性
awsRegion AWS 区域 字符串
awsSourceSchema AWS 源架构 字符串
aws标签 AWS 标记 Route53ResourceRecordSetPropertiesAwsTags
publicCloudConnectorsResourceId 公有云连接器资源 ID 字符串
publicCloudResourceName (公共云资源名称) 公有云资源名称 字符串

Route53ResourceRecordSetPropertiesAwsTags

名字 描述 价值

RRTypeEnumValue

名字 描述 价值
价值 属性值 “A”
“AAAA”
“CAA”
“CNAME”
“DS”
“MX”
“NAPTR”
“NS”
“PTR”
“SOA”
“SPF”
“SRV”
“TXT”

TrackedResourceTags

名字 描述 价值

ARM 模板资源定义

可以使用目标操作部署 route53ResourceRecordSets 资源类型:

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.AwsConnector/route53ResourceRecordSets 资源,请将以下 JSON 添加到模板。

{
  "type": "Microsoft.AwsConnector/route53ResourceRecordSets",
  "apiVersion": "2024-12-01",
  "name": "string",
  "location": "string",
  "properties": {
    "arn": "string",
    "awsAccountId": "string",
    "awsProperties": {
      "aliasTarget": {
        "dnsName": "string",
        "evaluateTargetHealth": "bool",
        "hostedZoneId": "string"
      },
      "cidrRoutingConfig": {
        "collectionId": "string",
        "locationName": "string"
      },
      "failover": {
        "value": "string"
      },
      "geoLocation": {
        "continentCode": "string",
        "countryCode": "string",
        "subdivisionCode": "string"
      },
      "geoProximityLocation": {
        "awsRegion": "string",
        "bias": "int",
        "coordinates": {
          "latitude": "string",
          "longitude": "string"
        },
        "localZoneGroup": "string"
      },
      "healthCheckId": "string",
      "multiValueAnswer": "bool",
      "name": "string",
      "region": {
        "value": "string"
      },
      "resourceRecords": [
        {
          "value": "string"
        }
      ],
      "setIdentifier": "string",
      "trafficPolicyInstanceId": "string",
      "ttl": "int",
      "type": {
        "value": "string"
      },
      "weight": "int"
    },
    "awsRegion": "string",
    "awsSourceSchema": "string",
    "awsTags": {
      "{customized property}": "string"
    },
    "publicCloudConnectorsResourceId": "string",
    "publicCloudResourceName": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

属性值

Microsoft.AwsConnector/route53ResourceRecordSets

名字 描述 价值
apiVersion API 版本 '2024-12-01'
位置 资源所在的地理位置 string (必需)
名字 资源名称 字符串

约束:
模式 = ^(?=.{0,259}[^\s.]$)(?!.*[<>%&\?/#]) (必需)
性能 此资源的资源特定属性。 Route53ResourceRecordSet属性
标签 资源标记 标记名称和值的字典。 请参阅模板 中的 标记
类型 资源类型 “Microsoft.AwsConnector/route53ResourceRecordSets”

别名目标

名字 描述 价值
dns名称 <p><i>别名资源记录集:</i> 指定的值取决于要路由查询的位置:</p><dl><dt>Amazon API Gateway 自定义区域 API 和边缘优化 API</dt><dd><p>指定 API 的适用域名。 可以使用 CLI 命令 <href='https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-domain-names.html'>get-domain-names</a /a>获取适用值:</p><ul><li><p>对于区域 API,请指定区域 API<regionalDomainName>/code<>代码的值。</p></li><li><p>对于边缘优化 API,请指定 <代码的值>distributionDomainName</code>。 这是关联的 CloudFront 分发的名称,例如 <代码>da1b2c3d4e5.cloudfront.net</code>。</p></li></ul><注释><p>创建的记录的名称必须与 API 的自定义域名匹配,例如 <代码>api.example.com</code>。</p></note></dd><dt>Amazon Virtual Private Cloud interface</dt><dd><p>输入接口终结点的 API 终结点,例如 <代码>vpce-123456789abcdef01-example-us-east-1a.elasticloadbalancing.us-east-1.vpce.amazonaws.com</code>。 对于边缘优化的 API,这是相应 CloudFront 分发的域名。 可以使用 CLI 命令 <href='>'<describe->'</a /a /https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-vpc-endpoints.html获取 >代码的值<DnsName>/code<。>/p<>/dd<>dt<CloudFront 分发>/dt<>dd<>p<指定创建分发时 CloudFront 分配的域名。>/p<>pCloudFront 分发必须包含与资源记录集名称匹配的备用域名。 例如,如果资源记录集的名称 <i>acme.example.com</i>,则 CloudFront 分发必须包含 <i>acme.example.com</i> 作为备用域名之一。 有关详细信息,请参阅 <ihttps://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/CNAMEs.htmlAmazon CloudFront 开发人员指南>/i<>/i<<使用备用域名</a><href='>。</p><p>无法在专用托管区域中创建资源记录集以将流量路由到 CloudFront 分发。</p><注释>p对于故障转移别名记录,不能同时为主要记录和辅助记录指定 CloudFront 分发。 分发必须包含与记录名称匹配的备用域名。 但是,主记录和辅助记录具有相同的名称,并且不能在多个分发版中包含相同的备用域名。 </p></note></dd><dt>Elastic Beanstalk 环境</dt><dd><p>如果 Elastic Beanstalk 环境的域名包括在其中部署环境的区域,则可以创建将流量路由到环境的别名记录。 例如,域名 <代码>my-environment。<i>us-west-2</i>.elasticbeanstalk.com</code> 是区域化域名。 </p><重要的><p>对于在 2016 年初创建的环境,域名不包括该区域。 若要将流量路由到这些环境,必须创建 CNAME 记录而不是别名记录。 请注意,无法为根域名创建 CNAME 记录。 例如,如果域名 example.com,则可以创建一条记录,用于将 acme.example.com 流量路由到 Elastic Beanstalk 环境,但无法创建将 example.com 流量路由到 Elastic Beanstalk 环境的记录。对于具有区域化子域的弹性 Beanstalk 环境,</p></important></>p,请为环境指定 <代码>CNAME</code> 属性。 可以使用以下方法获取 CNAME 属性的值:</p><ul><li><p><i>Amazon Web Services Management Console</i>:有关如何使用主机获取值的信息, 请参阅 <ihttps://docs.aws.amazon.com/elasticbeanstalk/latest/dg/customdomains.htmlElastic Beanstalk 开发人员指南>/i 中的 <href='>'<将自定义域与弹性 Beanstalk>/a< 配合使用>。</p></li><li><p><i>Elastic Beanstalk API</i>:使用 <代码>DescribeEnvironments</code> 操作获取 <代码>CNAME</code> 属性的值。 有关详细信息,请参阅 <ihttps://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_DescribeEnvironments.htmlElastic Beanstalk API 参考>/i>/i> 中的<describeEnvironments><'>'<href='>。</p></li><li><p><i>CLI</i>:使用 <代码>描述环境</code> 命令获取 <代码>CNAME/code 属性的值。 有关详细信息,请参阅 <https://docs.aws.amazon.com/cli/latest/reference/elasticbeanstalk/describe-environments.htmlCLI 命令参考>/i<中的>描述环境</a><href='>。</p></li></ul></dd><dt>ELB 负载均衡器</dt><dd><p>指定与负载均衡器关联的 DNS 名称。 使用 Amazon Web Services 管理控制台、ELB API 或 CLI 获取 DNS 名称。 </p><ul><li><p><b>Amazon Web Services 管理控制台</b>: 转到 EC2 页, 在导航窗格中选择 <b>负载均衡器</b>,选择负载均衡器,选择 <b>说明</b> 选项卡,并获取 <b>DNS 名称</b> 字段的值。 </p><p>如果要将流量路由到经典负载均衡器,请获取以 <b>dualstack</b>开头的值。 如果要将流量路由到另一种类型的负载均衡器,请获取应用于记录类型 A 或 AAAA 的值。</p></li><li><p><b>弹性负载均衡 API</b>:使用 <代码>DescribeLoadBalancers</code> 获取 <代码>DNSName</code>的值。 有关详细信息, 请参阅适用的指南:</p><ul><li><p>经典负载均衡器:<href='https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_DescribeLoadBalancers.html'>DescribeLoadBalancers</a /></p></li><li><p>应用程序和网络负载均衡器:<href='https://docs.aws.amazon.com/elasticloadbalancing/latest/APIReference/API_DescribeLoadBalancers.html'>DescribeLoadBalancers</a /></p></li></ul></li><li><p><b>CLI</b>:使用 <代码>描述负载均衡器</code> 获取 <代码的值>DNSName</code>。 有关详细信息, 请参阅适用的指南:</p><ul><li><p>经典负载均衡器:<href='http://docs.aws.amazon.com/cli/latest/reference/elb/describe-load-balancers.html'>describe-load-balancers</a></p></li><li><p>应用程序和网络负载均衡器:<href='http://docs.aws.amazon.com/cli/latest/reference/elbv2/describe-load-balancers.html'>describe-load-balancers</a /></p></li></ul></li></ul></dd><dt>Global Accelerator accelerator</dt><dd><p>指定加速器的 DNS 名称:</p><ul><li><p><b>Global Accelerator API:</b> 获取 DNS 名称, 使用 <href='https://docs.aws.amazon.com/global-accelerator/latest/api/API_DescribeAccelerator.html'>DescribeAccelerator</a>.</p></li><li><p><b>CLI:</b> 若要获取 DNS 名称,请使用 <href='https://docs.aws.amazon.com/cli/latest/reference/globalaccelerator/describe-accelerator.html'>describe-accelerator</a />。</p></li></ul></dd><dt>Amazon S3 存储桶,该存储桶配置为静态网站</dt><dd><p>指定在其中创建了存储桶的 Amazon S3 网站终结点的域名,例如,<代码>s3-website.us-east-2.amazonaws.com</code>。 有关有效值的详细信息,请参阅 <ihttps://docs.aws.amazon.com/general/latest/gr/s3.html#s3_website_region_endpointsAmazon Web Services 常规参考>/i<>amazon S3 网站终结点</> a<的表 >href='<。 有关将 S3 存储桶用于网站的详细信息,请参阅 <ihttps://docs.aws.amazon.com/Route53/latest/DeveloperGuide/getting-started.htmlAmazon Route 53 开发人员指南中的 >href='<>“>Amazon Route 53 入门>/a<。>/i<>/p<>/dd<>dt<另一个路由 53 资源记录集>/dt<>dd<>p<指定当前托管区域中资源记录集 >代码<名称>/code< 元素的值。>/p<>注释<>p<如果要创建与托管区域(称为区域顶点)同名的别名记录,则无法为 >代码<类型>/code<>代码<CNAME>/code的记录指定域名。 这是因为别名记录的类型必须与要将流量路由到的记录具有相同的类型,并且即使别名记录也不支持为区域顶点创建 CNAME 记录。</p></note></dd></dl> 字符串
评估目标健康 <p><i>仅适用于别名, 故障转移别名、地理位置别名、延迟别名和加权别名资源记录集:</i> 当 <代码>EvaluateTargetHealth</code><代码>true</code>,别名资源记录集将继承引用的 Amazon Web Services 资源的运行状况, 例如 ELB 负载均衡器或托管区域中的其他资源记录集。</p><p>请注意:</p><dl><dt>cloudFront 分发版</dt><dd><p><当别名目标为 CloudFront 分发时,无法将 evaluateTargetHealth>/code<><true>/code< 的代码设置为 >代码。</p></dd><dt>具有区域化子域的弹性 Beanstalk 环境</dt><dd><p>如果在 dnsName<DNSName>/code< 中指定弹性 Beanstalk >环境,并且环境包含 ELB 负载均衡器, 弹性负载均衡仅将查询路由到向负载均衡器注册的正常运行的 Amazon EC2 实例。 (如果环境包含多个 Amazon EC2 实例,则会自动包含 ELB 负载均衡器。如果将 <代码>EvaluateTargetHealth</code> 设置为 <代码,>true</code> 且没有 Amazon EC2 实例正常,或者负载均衡器本身不正常,则 Route 53 会将查询路由到运行正常的其他可用资源(如果有)。 </p><p>如果环境包含单个 Amazon EC2 实例,则没有特殊要求。</p></dd><dt>ELB 负载均衡器</dt><dd><p>运行状况检查行为取决于负载均衡器的类型:</p><ul><li><p><b>经典负载均衡器</b>:如果在 DNSName</code><>代码中指定 ELB 经典负载均衡器, 弹性负载均衡仅将查询路由到向负载均衡器注册的正常运行的 Amazon EC2 实例。 如果将 <代码>EvaluateTargetHealth</code> 设置为 <代码,>true</code> 且没有 EC2 实例正常或负载均衡器本身不正常,则 Route 53 会将查询路由到其他资源。</p></li><li><p><p>应用程序和网络负载均衡器</b>:如果指定 ELB 应用程序或网络负载均衡器,并且设置了 <代码>< EvaluateTargetHealth>/code<><true>/code<,路由 53 将查询路由到负载均衡器,具体取决于与负载均衡器关联的目标组的运行状况:>/p<>ul<>li<>p要使应用程序或网络负载均衡器被视为正常,包含目标的每个目标组必须至少包含一个正常的目标。 如果任何目标组仅包含不正常的目标,则负载均衡器被视为不正常,路由 53 会将查询路由到其他资源。</p></li><li><p>没有已注册目标的目标组被视为不正常。</p></li></ul></li></ul><注释><p>创建负载均衡器时,请配置弹性负载均衡运行状况检查的设置;它们不是 Route 53 运行状况检查,但它们执行类似的功能。 不要为向 ELB 负载均衡器注册的 EC2 实例创建路由 53 运行状况检查。 </p></note></dd><dt>S3 存储桶</dt><dd><p>没有特殊 将 <代码>EvaluateTargetHealth</code> 设置为在别名目标为 S3 存储桶时,<true>/code<>代码的要求。</p></dd><dt>同一托管区域中的其他记录</dt><dd><p>如果 <代码中指定的 Amazon Web Services 资源>DNSName</code> 是记录或一组记录(例如,一组加权记录),但不是另一个别名记录, 建议将运行状况检查与别名目标中的所有记录相关联。 有关详细信息,请参阅 <href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-complex-configs.html#dns-failover-complex-configs-hc-omitting'>省略运行状况检查时会发生什么情况?<i>Amazon Route 53 开发人员指南</i>中的</a>。</p></dd></dl><p>有关详细信息和示例,请参阅 <https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover.html>Amazon Route 53 运行状况检查和 DNS 故障转移</a><i>Amazon Route 53 开发人员指南</i>。</p> 布尔
托管区域 ID <p><i>别名资源记录仅设置</i>:使用的值取决于要路由流量的位置:</p><dl><dt>Amazon API 网关自定义区域 API 和边缘优化 API</dt><dd><p>指定 API 的托管区域 ID。 可以使用 CLI 命令 <href='https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-domain-names.html'>get-domain-names</a />获取适用值:</p><ul><li><p>对于区域 API,请指定区域 API<区域HostedZoneId>/code<>代码的值。</p></li><li><p>对于边缘优化 API,请指定 <code>distributionHostedZoneId</code>的值。</p></li></ul></dd><dt>Amazon 虚拟私有云接口</dt><dd><p>指定接口终结点的托管区域 ID。 可以使用 CLI 命令 <href='>'<describe->'</a /a /https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-vpc-endpoints.html获取>HostedZoneId</code >< 代码的值。>/p<>/dd<>dt<CloudFront 分发>/dt<>dd<>p<指定 >代码<Z2FDTNDATAQYW2>/code<。>/p<>注释<>p<CloudFront 的别名资源记录集无法在专用区域中创建。>/p<>/note<>/dd<>dt<Elastic Beanstalk 环境>/dt<>dd<>p指定在其中创建环境的区域的托管区域 ID。 环境必须具有区域化子域。 有关区域列表和相应的托管区域 ID,请参阅 <href='https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html'>Elastic Beanstalk 终结点和配额</a><i>Amazon Web Services 常规参考</i>。</p></dd><dt>ELB 负载均衡器</dt><dd><p>指定负载均衡器的托管区域 ID 的值。 使用以下方法获取托管区域 ID:</p><ul><li><p><href='https://docs.aws.amazon.com/general/latest/gr/elb.html'>弹性负载均衡终结点和 <i>Amazon Web Services 常规参考</i>中的配额</a /a> 主题:使用与在其中创建负载均衡器的区域对应的值。 请注意,应用程序和经典负载均衡器以及网络负载均衡器有单独的列。</p></li><li><p><b>Amazon Web Services Management Console</b>: 转到 Amazon EC2 页面, 在导航窗格中选择 <b>负载均衡器</b>,选择负载均衡器,然后在 <b>说明</b> 选项卡上获取 <b>托管区域</b> 字段的值。</p></li><li><p><b>弹性负载均衡 API</b>:使用 <代码>DescribeLoadBalancers</code> 获取适用值。 有关详细信息,请参阅适用的指南:</p><ul><li><p>经典负载均衡器:使用 <href='https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_DescribeLoadBalancers.html'>DescribeLoadBalancers</a /> 获取 <代码的值>CanonicalHostedZoneNameId</code>。</p></li><li><p>应用程序和网络负载均衡器:使用 <href='https://docs.aws.amazon.com/elasticloadbalancing/latest/APIReference/API_DescribeLoadBalancers.html'>DescribeLoadBalancers</a /> 获取 <代码的值>CanonicalHostedZoneId</code>。</p></li></ul></li><><li><p><b>CLI</b>:使用 <代码>describe-load-balancers/code 获取适用值。 有关详细信息,请参阅适用的指南:</p><ul><li><p>经典负载均衡器:使用 <href='http://docs.aws.amazon.com/cli/latest/reference/elb/describe-load-balancers.html'>describe-load-balancers</a> 获取 <代码的值,>CanonicalHostedZoneNameId</code>。</p></li><li><p>应用程序和网络负载均衡器:使用 <href='http://docs.aws.amazon.com/cli/latest/reference/elbv2/describe-load-balancers.html'>描述负载均衡器</a> 获取 <代码的值>CanonicalHostedZoneId</code>。</p></li></ul></li></ul></dd><dt>global Accelerator accelerator</dt><dd><p>指定 <代码>Z2BJ6XQ5FK7U4H</code>。</p></dd><dt>配置为静态网站</dt><dd><p>指定在其中创建存储桶的区域的托管区域 ID。 有关有效值的详细信息,请参阅 <ihttps://docs.aws.amazon.com/general/latest/gr/s3.html#s3_website_region_endpointsAmazon Web Services 常规参考>/i<>amazon S3 网站终结点</> a<的表 >href='<。>/p<>/dd<>dt<托管区域中的另一个路由 53 资源记录集>/dt<>dd<>p指定托管区域的托管区域 ID。 (别名资源记录集不能引用其他托管区域中的资源记录集。</p></dd></dl> 字符串

AwsRoute53ResourceRecordSet属性

名字 描述 价值
aliasTarget <p><i>别名资源记录集:</i> 有关 Amazon Web Services 资源的信息,例如 CloudFront 分发或要向其路由流量的 Amazon S3 存储桶。 </p><p>如果要为专用托管区域创建资源记录集,请注意以下事项:</p><ul><li><p>无法在专用托管区域中创建别名资源记录集以将流量路由到 CloudFront 分发。</p></li><li><p>有关在专用托管区域中创建故障转移资源记录集的信息,请参阅 <href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-private-hosted-zones.html'>在专用托管区域</a><i>Amazon Route 53 开发人员指南</i>。</p></li></ul> 别名目标
cidrRoutingConfig 属性 cidrRoutingConfig CidrRoutingConfig
故障转移 <p><i>故障转移资源记录集:</i> 若要配置故障转移,请将 <代码>故障转移</code> 元素添加到两个资源记录集。 对于一个资源记录集,请将 PRIMARY<PRIMARY>/code< 指定为 ><代码>故障转移</code>的值;对于其他资源记录集,指定 <代码>SECONDARY</code>。 此外,还包括 healthCheckId<healthCheckId>/code< 元素 >代码,并指定希望 Amazon Route 53 针对每个资源记录集执行的运行状况检查。</p><p>,除非另有指出, 以下故障转移行为假定你已将 <代码>HealthCheckId</code> 元素包含在这两个资源记录集中:</p><ul><li><p>当主资源记录集正常运行时,Route 53 会响应具有主要资源记录集中适用值的 DNS 查询,而不考虑辅助资源记录集的运行状况资源记录集。</p></li><li><p>当主资源记录集运行不正常且辅助资源记录集正常时,Route 53 将响应具有辅助资源记录集中适用值的 DNS 查询。</p></li><li><p>当辅助资源记录集运行不正常时,Route 53 将响应具有主要资源记录集中适用值的 DNS 查询,而不管主要资源记录集的运行状况如何。</p></li><li><p>如果省略辅助资源记录集的 <代码>HealthCheckId</code> 元素,如果主要资源记录集运行不正常,则 Route 53 始终响应具有辅助资源记录集中适用值的 DNS 查询。 无论关联的终结点的运行状况如何,这都是真实的。</p></li></ul><p>无法创建与故障转移资源记录集相同的 <代码>名称</code> 和 <代码>类型</code> 元素作为故障转移资源记录集的值。</p><p>对于故障转移别名资源记录集,还必须包括 evaluateTargetHealth</code> 元素<>代码,并将值设置为 true。</p><p>有关为路由 53 配置故障转移的详细信息, 请参阅 <i>Amazon Route 53 开发人员指南</i>中的以下主题:</p><ul><li><p><a href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover.html'>Route 53 运行状况检查和 DNS 故障转移</a></p></li><li><p><href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-private-hosted-zones.html'>在专用托管区域配置故障转移</a></p></li></ul> ResourceRecordSetFailoverEnumValue
地理位置 <p><i>地理位置资源记录集:</i> 一种复杂类型,用于控制 Amazon Route 53 如何根据查询的地理来源响应 DNS 查询。 例如, 如果要将所有来自非洲的查询路由到 IP 地址为 <代码>192.0.2.111</code>的 Web 服务器,请创建具有 <代码>类型>的资源记录集><代码>A</code><>/code<>/code<>/code<>code<AF>/code<。>/pp如果为重叠地理区域创建单独的资源记录集(例如,一个针对一大洲的资源记录集和一个针对同一大洲的国家/地区),优先级将转到最小的地理区域。 这样,就可以将大陆的大多数查询路由到一个资源,并将该大洲国家/地区的查询路由到其他资源。</p><p>无法创建两个指定相同地理位置的地理位置资源记录集。</p><p><>代码<>/code< 的值>CountryCode</code> 元素匹配所有地理位置 在其他地理位置资源记录集中未指定,<代码>名称</code> 和 <代码>类型</code> 元素的值相同。</p><重要的><p>地理位置的工作原理是将 IP 地址映射到位置。但是,某些 IP 地址不会映射到地理位置,因此,即使你创建涵盖所有七大洲的地理位置资源记录集,Route 53 也会从无法识别的位置接收一些 DNS 查询。建议创建一个资源记录集,<代码>CountryCode</code> 的值 <代码></code>。 两组查询将路由到在此记录中指定的资源:查询来自尚未为其创建地理位置资源记录集的位置的查询,以及来自未映射到位置的 IP 地址的查询。 如果未创建 <代码>*</code> 资源记录集,则 Route 53 将返回来自这些位置的查询的“无答案”响应。</p></important><p>无法创建 <代码>名称</code> 值的非地理位置资源记录集,<代码>Type</code> 元素作为地理位置资源记录集。</p> 地理位置
geoProximityLocation <p><i> GeoproximityLocation 资源记录集:</i> 复杂类型,用于控制 Route 53 如何根据查询和资源地理来源响应 DNS 查询。 </p> GeoProximityLocation
healthCheckId <p>如果希望 Amazon Route 53 仅当运行状况检查状态正常时返回此资源记录集,请包含运行状况检查状态<healthCheckId>/code< 元素的 >代码,并指定适用的运行状况检查的 ID。</p><p>Route 53 确定资源记录集是否正常,具体取决于以下项之一:</p><ul><li><p>By 定期将请求发送到在运行状况检查中指定的终结点</p></li><li><p>通过聚合指定运行状况检查组的状态(计算的运行状况检查)</p></li><li><p>通过确定 CloudWatch 警报(CloudWatch 指标运行状况检查)的当前状态</p></li></ul><重要><p>Route 53 不会检查资源记录集中指定的终结点的运行状况, 例如,<代码中 IP 地址指定的终结点>Value</code> 元素。 将 <代码>HealthCheckId</code> 元素添加到资源记录集时,Route 53 会检查在运行状况检查中指定的终结点的运行状况。 </p></important><p>有关详细信息, 请参阅 <i>Amazon Route 53 开发人员指南</i>中的以下主题:</p><ul><li><p><href=“https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-determining-health-of-endpoints.html'>Amazon Route 53 如何确定终结点是否正常</a /></p></li><li><p><href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover.html'>路由 53 运行状况检查和 DNS 故障转移</a></p></li><li><p><href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-private-hosted-zones.html'>配置专用托管区域中的故障转移</a /a></p></li></ul><p><b>何时指定 HealthCheckId</b></p><p><指定 healthCheckId>code>HealthCheckId>/仅当 Route 53 在两个或多个资源记录集之间进行选择以响应 DNS 查询时,代码 才有用,并且希望 Route 53 根据运行状况检查的状态设置选择。 配置运行状况检查仅在以下配置中才有意义:</p><ul><li><p><b>非别名资源记录集</b>:您正在检查一组具有相同路由策略、名称和类型的非别名资源记录集的运行状况(例如,以 A 类型命名www.example.com的多个加权记录),并且您为所有资源记录集指定运行状况检查 ID。 </p><p>如果资源记录集的运行状况检查状态正常,则 Route 53 包含响应 DNS 查询的记录中的记录。</p><p>如果资源记录集的运行状况检查状态不正常,则 Route 53 停止使用该资源记录集的值响应 DNS 查询。</p><p>如果组中所有资源记录集的运行状况检查状态不正常,则 Route 53 会考虑组中的所有资源记录集正常,并相应地响应 DNS 查询。 </p></li><li><p><b>别名资源记录集</b>:您指定以下设置:</p><ul><li><p>您将一组具有相同路由策略、名称和类型的资源记录集中的别名资源记录集的 code<EvaluateTargetHealth>/code< 设置为 >true(例如,以 A 类型命名www.example.com的多个加权记录)。 </p></li><li><p>配置别名资源记录集,以将流量路由到同一托管区域中的非别名资源记录集。</p></li><li><p>为非别名资源记录集指定运行状况检查 ID。 </p></li></ul><p>如果运行状况检查状态正常,则 Route 53 会将别名资源记录设置为正常,并在响应 DNS 查询的记录中包含别名记录。</p><p>如果运行状况检查状态不正常,则 Route 53 会停止使用别名资源记录集响应 DNS 查询。</p><注释><p>别名资源记录集还可以将流量路由到 <i>组</i> 具有相同路由策略、名称和类型的非别名资源记录集。 在该配置中,将运行状况检查与非别名资源记录集中的所有资源记录集相关联。</p></note></li></ul><p><b>地理位置路由</b></p><>对于地理位置资源记录集,如果终结点运行不正常,则 Route 53 会查找更大的关联地理区域的资源记录集。 例如,假设你有一个状态的资源记录集、整个美国、北美的资源记录集,以及一个 <代码></code> 的资源记录集,<代码>CountryCode</code><代码></code>,适用于所有位置。 如果状态资源记录集的终结点不正常, 路由 53 按以下顺序检查正常的资源记录集,直到找到终结点正常运行的资源记录集:</p><ul><li><p>美国</p></li><li><p>p</p></li><li><p>默认资源记录集</p></li></ul><p><b>指定运行状况检查终结点(按域名</b></p><p>如果运行状况检查仅按域名指定终结点,建议为每个终结点创建单独的运行状况检查。 例如,为每个 <代码>HTTP</code> 服务器创建运行状况检查,该服务器为 <代码>www.example.com</code>提供内容。 对于 <代码的值>FullyQualifiedDomainName</code>,请指定服务器的域名(如 <代码>us-east-2-www.example.com</code>),而不是资源记录集的名称(<代码>www.example.com</code>)。如果执行以下操作,</p><><p>运行状况检查结果将不可预知:</p><ul><li><p>创建与资源记录集名称相同的 <代码>FullQualifiedDomainName</code> 的值的运行状况检查。</p></li><li><p>将运行状况检查与资源记录集相关联。</p></li></ul></important> 字符串
multiValueAnswer 多值答案 <p><i>Multivalue 应答资源记录集仅</i>:若要将流量随机路由到多个资源(例如 Web 服务器),请为每个资源创建一个多值应答记录,并为 <代码>MultiValueAnswer</code>指定 <代码>true</code>。 请注意以下事项:</p><ul><li><p>如果将运行状况检查与多值应答资源记录集相关联,则 Amazon Route 53 仅当运行状况检查正常时才响应具有相应 IP 地址的 DNS 查询。</p></li><li><p>如果不将运行状况检查与多值应答记录相关联,则 Route 53 始终将记录视为正常。</p></li><li><p>Route 53 响应最多八条正常记录的 DNS 查询;如果有 8 条或更少条正常记录,则 Route 53 会使用所有正常记录响应所有 DNS 查询。</p></li><li><p>如果你有 8 个以上的正常记录,Route 53 将响应具有不同组合正常记录的不同 DNS 解析程序。</p></li><li><p>当所有记录都运行不正常时,Route 53 将响应最多包含 8 条不正常记录的 DNS 查询。</p></li><li><p>如果解析程序缓存响应后资源不可用,客户端软件通常会尝试响应中的另一个 IP 地址。</p></li></ul><p>无法创建多值应答别名记录。</p> 布尔
名字 <p>对于 <代码>ChangeResourceRecordSets</code> 请求、要创建、更新或删除的记录的名称。 对于 <代码>ListResourceRecordSets</code> 响应,指定托管区域中记录的名称。</p><p><b>ChangeResourceRecordSets only</b></p><>输入完全限定的域名,例如,<代码>www.example.com</code>。 可以选择包含尾随点。 如果省略尾随点,Amazon Route 53 假定指定的域名是完全限定的。 这意味着 Route 53 处理 <代码>www.example.com</code>(无尾随点)和 <代码>www.example.com。</code>(尾随点)相同。</p><p>有关如何 <代码>a-z</code>指定字符的信息,<代码>0-9</code>,以及 <代码>-</code> (连字符)以及如何指定国际化域名, 请参阅 <ihttps://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DomainNameFormat.htmlAmazon Route 53 开发人员指南>/i /i<中的>DNS 域名格式</a >href='<'>。</p><p>可以使用星号()通配符替换域名中最左侧的标签,例如,<代码>.example.com</code>。 请注意以下事项:</p><ul><li><p>* 必须替换整个标签。 例如,不能指定 <代码>prod.example.com</code> 或 <代码>prod.example.com</code>。</p></li><li><p>* 无法替换任何中间标签,例如 marketing.*.example.com。</p></li><li><p>如果在域名中除最左边的标签之外的任何位置包含 * ,DNS 将其视为 * 字符(ASCII 42),而不是通配符。</p><重要的><p>不能对具有 NS 类型的资源记录集使用 * 通配符。</p></important></li></ul> 字符串
地区 <p><i>基于延迟的资源记录集:</i> 在其中创建了此资源记录集引用的资源的 Amazon EC2 区域。 资源通常是 Amazon Web Services 资源,例如 EC2 实例或 ELB 负载均衡器,并根据记录类型由 IP 地址或 DNS 域名引用。</p><p>Amazon Route 53 收到域名和类型 DNS 查询时,已为其创建延迟资源记录集的域名和类型,Route 53 将选择在最终用户与关联的 Amazon EC2 区域之间具有最低延迟的延迟资源记录集。 然后,Route 53 返回与所选资源记录集关联的值。</p><p>请注意:</p><ul><li><p>只能为每个延迟资源记录集指定一个 <代码>ResourceRecord</code>。</p></li><li><p>只能为每个 Amazon EC2 区域创建一个延迟资源记录集。</p></li><li><p>无需为所有 Amazon EC2 区域创建延迟资源记录集。 路由 53 将从创建延迟资源记录集的区域中选择具有最佳延迟的区域。</p></li><li><p>无法创建 <代码>名称</code><代码>类型</code> 元素作为延迟资源记录集的值的非延迟资源记录集。</p></li></ul> ResourceRecordSetRegionEnumValue
resourceRecords <p>要处理的资源记录的信息。</p><注释><p>如果要创建别名资源记录集,请省略 resourceRecords</code><代码 >代码。</p></note> ResourceRecord[]
setIdentifier 的 <p><i>具有非简单路由策略的资源记录集:</i> 区分名称与类型相同的多个资源记录集,例如 acme.example.com 具有 A 类型的多个加权资源记录集。在具有相同名称和类型的一组资源记录集中,<代码的值>SetIdentifier</code> 对于每个资源记录集必须是唯一的。 </p><p>有关路由策略的信息,请参阅 <href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html'>在 <i>Amazon Route 53 开发人员指南</i>中选择路由策略</a>。</p> 字符串
trafficPolicyInstanceId 流量策略实例 ID <p>创建流量策略实例时,Amazon Route 53 会自动创建资源记录集。 <代码>TrafficPolicyInstanceId</code> 是路由 53 创建此资源记录集的流量策略实例的 ID。</p><重要的><p>若要删除与流量策略实例关联的资源记录集,请使用 <代码>DeleteTrafficPolicyInstance</code>。 路由 53 将自动删除资源记录集。 如果使用 <代码删除资源记录集>ChangeResourceRecordSets</code>,则 Route 53 不会自动删除流量策略实例,即使不再使用,也会继续为其收费。 </p></重要> 字符串
ttl <p>资源记录缓存生存时间(TTL),以秒为单位。 请注意以下事项:</p><ul><li><p>如果要创建或更新别名资源记录集,请省略<TTL>/code<>代码。 Amazon Route 53 使用别名目标的 <代码>TTL</code> 的值。 </p></li><li><p>如果要将此资源记录集与运行状况检查相关联(如果要<HealthCheck 添加 >代码 建议</code> 元素)指定一个 <代码,>TTL</code> 60 秒或更短的时间,以便客户端快速响应运行状况更改。</p></li><li><p>一组加权资源记录集中的所有资源记录集必须具有相同的值,<代码>TTL</code>。</p></li><li><p>如果一组加权资源记录集包含别名目标为 ELB 负载均衡器的一个或多个加权别名资源记录集,建议为所有具有相同名称和类型的非别名加权资源记录集指定 TTL<TTL>/code< 60 秒 >代码。 除 60 秒以外的值(负载均衡器的 TTL)将更改为 <代码指定的值的效果,>Weight</code>。</p></li></ul> 整数 (int)
类型 <p>DNS 记录类型。 有关不同记录类型以及如何对数据进行编码的信息,请参阅 <i Amazon Route 53 开发人员指南https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/ResourceRecordTypes.html/i> 中的 <a href='>'<支持的 DNS 资源记录类型>/a<。></p>p 基本资源记录集的有效值:<代码>A</代码> | <><代码>AAAA</代码> | <代码>CAA</代码> | <代码>CNAME/<code> | <代码>DS</code> |<代码>MX</代码> | <代码>NAPTR</code> | <代码>NS/<代码> | <代码>PTR</代码> | <代码>SOA</代码> | <代码>SPF</代码> | <代码>SRV</代码> | <code>TXT</code></p><p>加权、延迟、地理位置和故障转移资源记录集的值:<code>A</code> | <代码>AAAA</代码> | <代码>CAA</代码> | <代码>CNAME/<code> | <代码>MX</代码> | <代码>NAPTR</code> | <代码>PTR</代码> | <代码>SPF</代码> | <代码>SRV</代码> | <代码>TXT</代码>。 在创建一组加权、延迟、地理位置或故障转移资源记录集时,请为组中的所有资源记录集指定相同的值。</p>p 多值答案资源记录集的有效值:<代码>A</code> | <><代码>AAAA</代码> | <代码>MX</代码> | <代码>NAPTR</code> | <代码>PTR</代码> | <代码>SPF</代码> | <代码>SRV</代码> | <code>TXT</code></p><note><p>SPF 记录以前用于验证电子邮件发件人的身份。 但是,我们不再建议创建 <代码的值>类型</code><代码>SPF</code>的资源记录集。 RFC 7208,<i>发件人策略框架(SPF)在电子邮件中授权使用域,版本 1</i>,已更新为“...[i]ts 存在和 [RFC4408] 中定义的机制导致了一些互操作性问题。 因此,其使用不再适用于 SPF 版本 1;实现不使用它。 在 RFC 7208 中,请参阅第 14.1 节,<href='http://tools.ietf.org/html/rfc7208#section-14.1'>SPF DNS 记录类型</a>。</p></note><p>别名资源记录集的值:</p><ul><li><p><b>Amazon API Gateway 自定义区域 API 和边缘 优化 API:</b><代码>A</code></p></li><li><p><b>CloudFront 分发版:</b><代码>A</code></p><p>如果为分发启用了 IPv6, 创建两个资源记录集以将流量路由到分发,一个资源记录集,其中一个值 <代码>A</code>,一个具有 AAAA</code>的值 <>代码。 </p>/li<>li<>p<>b<具有区域化子域>的 Amazon API Gateway 环境/b<:>代码<A>/code<>/p/li<><> li<>p<>b<ELB 负载均衡器:>/b<>代码<A>/code | <><代码>AAAA</code></p></li><li p><><b>Amazon S3 存储桶:</b><代码>A</code></p></li><li><p><b>Amazon Virtual Private Cloud 接口 VPC 终端节点</b><代码>A</code></p></li><li><p><b>此托管区域中的另一个资源记录集:</b>指定要为其创建别名的资源记录集的类型。 除 <NS>/code<>代码>代码和 >代码<SOA>/code<之外,支持所有值。>/p<>注释<>p<如果要创建与托管区域(称为区域顶点)同名的别名记录(称为区域顶点),则无法将流量路由到>类型</code><代码>CNAME</code>的 代码值。 这是因为别名记录的类型必须与将流量路由到的记录具有相同的类型,并且即使别名记录也不支持为区域顶点创建 CNAME 记录。</p></note></li></ul> RRTypeEnumValue
重量 <p><i>加权资源记录集:</i> 在具有相同 DNS 名称和类型组合的资源记录集中,一个值,用于确定 Amazon Route 53 使用当前资源记录集响应的 DNS 查询的比例。 路由 53 计算具有相同 DNS 名称和类型的资源记录集权重的总和。 然后,路由 53 根据资源的权重与总计的比例响应查询。 请注意以下事项:</p><ul><li><p>必须为每个加权资源记录集指定 <代码>Weight</code> 元素的值。</p></li><li><p>只能为每个加权资源记录集指定一个 <代码>ResourceRecord</code>。</p></li><li><p>无法创建与加权资源记录集相同的 <代码>名称</code> 值以及 <代码>类型</code> 元素作为加权资源记录集的值。</p></li><li><p>最多可以创建 100 个加权资源记录集,这些记录集 <>名称</code> 和 <代码>类型</code> 元素。</p></li><li><p>(但不是加权别名)资源记录集,如果将 <代码>权重</code> 设置为 <代码>0</code> 的资源记录集,则 Route 53 永远不会响应具有该资源记录集适用值的查询。 但是,如果将 <代码>权重</code> 设置为 <代码>0</code>,则具有相同 DNS 名称和类型组合的所有资源记录集的流量将路由到概率相等的所有资源。</p><p>将 <代码>权重</code> 设置为 <代码>0</code> 的效果与加权资源记录集相关联时,将运行状况检查与加权资源记录集相关联。 有关详细信息,请参阅 <ihttps://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.htmlAmazon Route 53 开发人员指南>/i<<Active-Active 和 Active-Passive 故障转移</> a<选项 >href='<'<选项。</p></li>/ul 整数 (int)

CidrRoutingConfig

名字 描述 价值
collectionId <p>CIDR 集合 ID。</p> 字符串
location名称 <p>CIDR 集合位置名称。</p> 字符串

坐标

名字 描述 价值
纬度 <p> 指定地球表面地理点(-90 - 90)的南北位置坐标。 </p> 字符串
经度 <p> 指定地球表面地理点(-180- 180)的东-西位置坐标。 </p> 字符串

地理位置

名字 描述 价值
continentCode <p>非洲大陆的双字母代码。</p><p>Amazon Route 53 支持以下大陆代码:</p><ul><li><p><b>AF</b>: 非洲</p></li><li><p><b>AN</b>: 南极洲</p></li><li><p><b>AS</b>: 亚洲</p></li><li><p><b><>b</b>: 欧洲</p></li><li><p><><b>OC</b>: 大洋洲</p></li><li><p><b>NA</b>: 北美</p></li><li><p><b>sa</b>: 南美洲</p></li></ul><p>约束: 指定 <代码><大洲 >代码<CountryCode>/< code> 或 <代码>SubdivisionCode</code> 返回 <代码>InvalidInput/code 错误。/p 字符串
countryCode (国家代码) <p>对于地理位置资源记录集,一个国家/地区的双字母代码。</p><p>Amazon Route 53 使用在 <href='https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2'>ISO 标准 3166-1 alpha-2</a>中指定的双字母国家/地区代码。</p><p>53 路线还支持乌克兰 <b>UA</b> 的国家代码。</p> 字符串
subdivisionCode <p>对于地理位置资源记录集,为美国州的双字母代码。 Route 53 不支持 <代码>SubdivisionCode</code>的任何其他值。 有关州缩写列表,请参阅美国邮政局网站上的 <href='https://pe.usps.com/text/pub28/28apb.htm'>附录 B: 双字母州和所有权缩写</a>。 </p><p>如果指定 <代码>细分代码</code>,还必须为 <代码>CountryCode</code>指定 <代码>>>/code。 </p> 字符串

GeoProximityLocation

名字 描述 价值
awsRegion <p> 要定向 DNS 流量的资源所在的 Amazon Web Services 区域。 </p> 字符串
偏见 <p> 偏差会增加或减少路由 53 路由到资源的地理区域的大小。 </p><p>若要使用 <代码>偏差</code> 更改地理区域的大小,请指定偏差的适用值:</p><ul><li><p>若要扩展路由 53 路由流量到资源的地理区域的大小, 为偏差指定从 1 到 99 的正整数。 路由 53 会缩小相邻区域的大小。 </p></li><li><p>若要缩小路由 53 路由到资源的地理区域的大小,请指定 -1 到 -99 的负偏差。 路由 53 扩展相邻区域的大小。 </p></li></ul> 整数 (int)
坐标 <p> 包含地理区域的经度和纬度。 </p> 坐标
localZoneGroup <p> 指定 Amazon Web Services 本地区域组。 </p><p>本地区域组通常是本地区域代码,没有结束字符。 例如,如果本地区域 <代码>us-east-1-bue-1a</code> 本地区域组 <代码>us-east-1-bue-1</code>。</p><p>可以使用 href=' <href='https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-availability-zones.html'>describe-availability-zone</a /> CLI 命令:</p><p>此命令返回: <代码>'GroupName' :“us-west-2-den-1”</code>,指定本地区域 <代码>us-west-2-den-1a</code> 属于本地区域组 <代码>us-west-2-den-1</code>。</p> 字符串

资源记录

名字 描述 价值
价值 <p>当前或新的 DNS 记录值,不超过 4,000 个字符。 如果 <代码>DELETE</code> 操作,如果当前值与实际值不匹配,则返回错误。 有关如何为不同记录类型设置 <代码>值</code> 的格式的说明,请参阅 <href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/ResourceRecordTypes.html>'>支持的 DNS 资源记录类型>/<>i<Amazon Route 53 开发人员指南>/i<。>/p<>p<可以为所有记录类型指定多个值,但 CNAME>/code>><代码> 和 <代码>SOA/code。 </p><注释><p>如果要创建别名资源记录集,请省略 <代码>值</code>。</p></note> 字符串

ResourceRecordSetFailoverEnumValue

名字 描述 价值
价值 属性值 “PRIMARY”
“SECONDARY”

ResourceRecordSetRegionEnumValue

名字 描述 价值
价值 属性值 “af-south-1”
“ap-east-1”
“ap-northeast-1”
“ap-northeast-2”
“ap-northeast-3”
“ap-south-1”
“ap-south-2”
“ap-southeast-1”
“ap-southeast-2”
“ap-southeast-3”
“ap-southeast-4”
“ca-central-1”
“ca-west-1”
“cn-north-1”
“cn-northwest-1”
“eu-central-1”
“eu-central-2”
“eu-north-1”
“eu-south-1”
“eu-south-2”
“eu-west-1”
“eu-west-2”
“eu-west-3”
“il-central-1”
“me-central-1”
“me-south-1”
“sa-east-1”
“us-east-1”
“us-east-2”
“us-west-1”
“us-west-2”

Route53ResourceRecordSet属性

名字 描述 价值
阿恩 Amazon 资源名称 (ARN) 字符串
awsAccountId AWS 帐户 ID 字符串
awsProperties AWS 属性 AwsRoute53ResourceRecordSet属性
awsRegion AWS 区域 字符串
awsSourceSchema AWS 源架构 字符串
aws标签 AWS 标记 Route53ResourceRecordSetPropertiesAwsTags
publicCloudConnectorsResourceId 公有云连接器资源 ID 字符串
publicCloudResourceName (公共云资源名称) 公有云资源名称 字符串

Route53ResourceRecordSetPropertiesAwsTags

名字 描述 价值

RRTypeEnumValue

名字 描述 价值
价值 属性值 “A”
“AAAA”
“CAA”
“CNAME”
“DS”
“MX”
“NAPTR”
“NS”
“PTR”
“SOA”
“SPF”
“SRV”
“TXT”

TrackedResourceTags

名字 描述 价值

用法示例

Terraform (AzAPI 提供程序)资源定义

可以使用目标操作部署 route53ResourceRecordSets 资源类型:

  • 资源组

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.AwsConnector/route53ResourceRecordSets 资源,请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.AwsConnector/route53ResourceRecordSets@2024-12-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      arn = "string"
      awsAccountId = "string"
      awsProperties = {
        aliasTarget = {
          dnsName = "string"
          evaluateTargetHealth = bool
          hostedZoneId = "string"
        }
        cidrRoutingConfig = {
          collectionId = "string"
          locationName = "string"
        }
        failover = {
          value = "string"
        }
        geoLocation = {
          continentCode = "string"
          countryCode = "string"
          subdivisionCode = "string"
        }
        geoProximityLocation = {
          awsRegion = "string"
          bias = int
          coordinates = {
            latitude = "string"
            longitude = "string"
          }
          localZoneGroup = "string"
        }
        healthCheckId = "string"
        multiValueAnswer = bool
        name = "string"
        region = {
          value = "string"
        }
        resourceRecords = [
          {
            value = "string"
          }
        ]
        setIdentifier = "string"
        trafficPolicyInstanceId = "string"
        ttl = int
        type = {
          value = "string"
        }
        weight = int
      }
      awsRegion = "string"
      awsSourceSchema = "string"
      awsTags = {
        {customized property} = "string"
      }
      publicCloudConnectorsResourceId = "string"
      publicCloudResourceName = "string"
    }
  }
}

属性值

Microsoft.AwsConnector/route53ResourceRecordSets

名字 描述 价值
位置 资源所在的地理位置 string (必需)
名字 资源名称 字符串

约束:
模式 = ^(?=.{0,259}[^\s.]$)(?!.*[<>%&\?/#]) (必需)
性能 此资源的资源特定属性。 Route53ResourceRecordSet属性
标签 资源标记 标记名称和值的字典。
类型 资源类型 “Microsoft.AwsConnector/route53ResourceRecordSets@2024-12-01”

别名目标

名字 描述 价值
dns名称 <p><i>别名资源记录集:</i> 指定的值取决于要路由查询的位置:</p><dl><dt>Amazon API Gateway 自定义区域 API 和边缘优化 API</dt><dd><p>指定 API 的适用域名。 可以使用 CLI 命令 <href='https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-domain-names.html'>get-domain-names</a /a>获取适用值:</p><ul><li><p>对于区域 API,请指定区域 API<regionalDomainName>/code<>代码的值。</p></li><li><p>对于边缘优化 API,请指定 <代码的值>distributionDomainName</code>。 这是关联的 CloudFront 分发的名称,例如 <代码>da1b2c3d4e5.cloudfront.net</code>。</p></li></ul><注释><p>创建的记录的名称必须与 API 的自定义域名匹配,例如 <代码>api.example.com</code>。</p></note></dd><dt>Amazon Virtual Private Cloud interface</dt><dd><p>输入接口终结点的 API 终结点,例如 <代码>vpce-123456789abcdef01-example-us-east-1a.elasticloadbalancing.us-east-1.vpce.amazonaws.com</code>。 对于边缘优化的 API,这是相应 CloudFront 分发的域名。 可以使用 CLI 命令 <href='>'<describe->'</a /a /https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-vpc-endpoints.html获取 >代码的值<DnsName>/code<。>/p<>/dd<>dt<CloudFront 分发>/dt<>dd<>p<指定创建分发时 CloudFront 分配的域名。>/p<>pCloudFront 分发必须包含与资源记录集名称匹配的备用域名。 例如,如果资源记录集的名称 <i>acme.example.com</i>,则 CloudFront 分发必须包含 <i>acme.example.com</i> 作为备用域名之一。 有关详细信息,请参阅 <ihttps://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/CNAMEs.htmlAmazon CloudFront 开发人员指南>/i<>/i<<使用备用域名</a><href='>。</p><p>无法在专用托管区域中创建资源记录集以将流量路由到 CloudFront 分发。</p><注释>p对于故障转移别名记录,不能同时为主要记录和辅助记录指定 CloudFront 分发。 分发必须包含与记录名称匹配的备用域名。 但是,主记录和辅助记录具有相同的名称,并且不能在多个分发版中包含相同的备用域名。 </p></note></dd><dt>Elastic Beanstalk 环境</dt><dd><p>如果 Elastic Beanstalk 环境的域名包括在其中部署环境的区域,则可以创建将流量路由到环境的别名记录。 例如,域名 <代码>my-environment。<i>us-west-2</i>.elasticbeanstalk.com</code> 是区域化域名。 </p><重要的><p>对于在 2016 年初创建的环境,域名不包括该区域。 若要将流量路由到这些环境,必须创建 CNAME 记录而不是别名记录。 请注意,无法为根域名创建 CNAME 记录。 例如,如果域名 example.com,则可以创建一条记录,用于将 acme.example.com 流量路由到 Elastic Beanstalk 环境,但无法创建将 example.com 流量路由到 Elastic Beanstalk 环境的记录。对于具有区域化子域的弹性 Beanstalk 环境,</p></important></>p,请为环境指定 <代码>CNAME</code> 属性。 可以使用以下方法获取 CNAME 属性的值:</p><ul><li><p><i>Amazon Web Services Management Console</i>:有关如何使用主机获取值的信息, 请参阅 <ihttps://docs.aws.amazon.com/elasticbeanstalk/latest/dg/customdomains.htmlElastic Beanstalk 开发人员指南>/i 中的 <href='>'<将自定义域与弹性 Beanstalk>/a< 配合使用>。</p></li><li><p><i>Elastic Beanstalk API</i>:使用 <代码>DescribeEnvironments</code> 操作获取 <代码>CNAME</code> 属性的值。 有关详细信息,请参阅 <ihttps://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_DescribeEnvironments.htmlElastic Beanstalk API 参考>/i>/i> 中的<describeEnvironments><'>'<href='>。</p></li><li><p><i>CLI</i>:使用 <代码>描述环境</code> 命令获取 <代码>CNAME/code 属性的值。 有关详细信息,请参阅 <https://docs.aws.amazon.com/cli/latest/reference/elasticbeanstalk/describe-environments.htmlCLI 命令参考>/i<中的>描述环境</a><href='>。</p></li></ul></dd><dt>ELB 负载均衡器</dt><dd><p>指定与负载均衡器关联的 DNS 名称。 使用 Amazon Web Services 管理控制台、ELB API 或 CLI 获取 DNS 名称。 </p><ul><li><p><b>Amazon Web Services 管理控制台</b>: 转到 EC2 页, 在导航窗格中选择 <b>负载均衡器</b>,选择负载均衡器,选择 <b>说明</b> 选项卡,并获取 <b>DNS 名称</b> 字段的值。 </p><p>如果要将流量路由到经典负载均衡器,请获取以 <b>dualstack</b>开头的值。 如果要将流量路由到另一种类型的负载均衡器,请获取应用于记录类型 A 或 AAAA 的值。</p></li><li><p><b>弹性负载均衡 API</b>:使用 <代码>DescribeLoadBalancers</code> 获取 <代码>DNSName</code>的值。 有关详细信息, 请参阅适用的指南:</p><ul><li><p>经典负载均衡器:<href='https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_DescribeLoadBalancers.html'>DescribeLoadBalancers</a /></p></li><li><p>应用程序和网络负载均衡器:<href='https://docs.aws.amazon.com/elasticloadbalancing/latest/APIReference/API_DescribeLoadBalancers.html'>DescribeLoadBalancers</a /></p></li></ul></li><li><p><b>CLI</b>:使用 <代码>描述负载均衡器</code> 获取 <代码的值>DNSName</code>。 有关详细信息, 请参阅适用的指南:</p><ul><li><p>经典负载均衡器:<href='http://docs.aws.amazon.com/cli/latest/reference/elb/describe-load-balancers.html'>describe-load-balancers</a></p></li><li><p>应用程序和网络负载均衡器:<href='http://docs.aws.amazon.com/cli/latest/reference/elbv2/describe-load-balancers.html'>describe-load-balancers</a /></p></li></ul></li></ul></dd><dt>Global Accelerator accelerator</dt><dd><p>指定加速器的 DNS 名称:</p><ul><li><p><b>Global Accelerator API:</b> 获取 DNS 名称, 使用 <href='https://docs.aws.amazon.com/global-accelerator/latest/api/API_DescribeAccelerator.html'>DescribeAccelerator</a>.</p></li><li><p><b>CLI:</b> 若要获取 DNS 名称,请使用 <href='https://docs.aws.amazon.com/cli/latest/reference/globalaccelerator/describe-accelerator.html'>describe-accelerator</a />。</p></li></ul></dd><dt>Amazon S3 存储桶,该存储桶配置为静态网站</dt><dd><p>指定在其中创建了存储桶的 Amazon S3 网站终结点的域名,例如,<代码>s3-website.us-east-2.amazonaws.com</code>。 有关有效值的详细信息,请参阅 <ihttps://docs.aws.amazon.com/general/latest/gr/s3.html#s3_website_region_endpointsAmazon Web Services 常规参考>/i<>amazon S3 网站终结点</> a<的表 >href='<。 有关将 S3 存储桶用于网站的详细信息,请参阅 <ihttps://docs.aws.amazon.com/Route53/latest/DeveloperGuide/getting-started.htmlAmazon Route 53 开发人员指南中的 >href='<>“>Amazon Route 53 入门>/a<。>/i<>/p<>/dd<>dt<另一个路由 53 资源记录集>/dt<>dd<>p<指定当前托管区域中资源记录集 >代码<名称>/code< 元素的值。>/p<>注释<>p<如果要创建与托管区域(称为区域顶点)同名的别名记录,则无法为 >代码<类型>/code<>代码<CNAME>/code的记录指定域名。 这是因为别名记录的类型必须与要将流量路由到的记录具有相同的类型,并且即使别名记录也不支持为区域顶点创建 CNAME 记录。</p></note></dd></dl> 字符串
评估目标健康 <p><i>仅适用于别名, 故障转移别名、地理位置别名、延迟别名和加权别名资源记录集:</i> 当 <代码>EvaluateTargetHealth</code><代码>true</code>,别名资源记录集将继承引用的 Amazon Web Services 资源的运行状况, 例如 ELB 负载均衡器或托管区域中的其他资源记录集。</p><p>请注意:</p><dl><dt>cloudFront 分发版</dt><dd><p><当别名目标为 CloudFront 分发时,无法将 evaluateTargetHealth>/code<><true>/code< 的代码设置为 >代码。</p></dd><dt>具有区域化子域的弹性 Beanstalk 环境</dt><dd><p>如果在 dnsName<DNSName>/code< 中指定弹性 Beanstalk >环境,并且环境包含 ELB 负载均衡器, 弹性负载均衡仅将查询路由到向负载均衡器注册的正常运行的 Amazon EC2 实例。 (如果环境包含多个 Amazon EC2 实例,则会自动包含 ELB 负载均衡器。如果将 <代码>EvaluateTargetHealth</code> 设置为 <代码,>true</code> 且没有 Amazon EC2 实例正常,或者负载均衡器本身不正常,则 Route 53 会将查询路由到运行正常的其他可用资源(如果有)。 </p><p>如果环境包含单个 Amazon EC2 实例,则没有特殊要求。</p></dd><dt>ELB 负载均衡器</dt><dd><p>运行状况检查行为取决于负载均衡器的类型:</p><ul><li><p><b>经典负载均衡器</b>:如果在 DNSName</code><>代码中指定 ELB 经典负载均衡器, 弹性负载均衡仅将查询路由到向负载均衡器注册的正常运行的 Amazon EC2 实例。 如果将 <代码>EvaluateTargetHealth</code> 设置为 <代码,>true</code> 且没有 EC2 实例正常或负载均衡器本身不正常,则 Route 53 会将查询路由到其他资源。</p></li><li><p><p>应用程序和网络负载均衡器</b>:如果指定 ELB 应用程序或网络负载均衡器,并且设置了 <代码>< EvaluateTargetHealth>/code<><true>/code<,路由 53 将查询路由到负载均衡器,具体取决于与负载均衡器关联的目标组的运行状况:>/p<>ul<>li<>p要使应用程序或网络负载均衡器被视为正常,包含目标的每个目标组必须至少包含一个正常的目标。 如果任何目标组仅包含不正常的目标,则负载均衡器被视为不正常,路由 53 会将查询路由到其他资源。</p></li><li><p>没有已注册目标的目标组被视为不正常。</p></li></ul></li></ul><注释><p>创建负载均衡器时,请配置弹性负载均衡运行状况检查的设置;它们不是 Route 53 运行状况检查,但它们执行类似的功能。 不要为向 ELB 负载均衡器注册的 EC2 实例创建路由 53 运行状况检查。 </p></note></dd><dt>S3 存储桶</dt><dd><p>没有特殊 将 <代码>EvaluateTargetHealth</code> 设置为在别名目标为 S3 存储桶时,<true>/code<>代码的要求。</p></dd><dt>同一托管区域中的其他记录</dt><dd><p>如果 <代码中指定的 Amazon Web Services 资源>DNSName</code> 是记录或一组记录(例如,一组加权记录),但不是另一个别名记录, 建议将运行状况检查与别名目标中的所有记录相关联。 有关详细信息,请参阅 <href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-complex-configs.html#dns-failover-complex-configs-hc-omitting'>省略运行状况检查时会发生什么情况?<i>Amazon Route 53 开发人员指南</i>中的</a>。</p></dd></dl><p>有关详细信息和示例,请参阅 <https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover.html>Amazon Route 53 运行状况检查和 DNS 故障转移</a><i>Amazon Route 53 开发人员指南</i>。</p> 布尔
托管区域 ID <p><i>别名资源记录仅设置</i>:使用的值取决于要路由流量的位置:</p><dl><dt>Amazon API 网关自定义区域 API 和边缘优化 API</dt><dd><p>指定 API 的托管区域 ID。 可以使用 CLI 命令 <href='https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-domain-names.html'>get-domain-names</a />获取适用值:</p><ul><li><p>对于区域 API,请指定区域 API<区域HostedZoneId>/code<>代码的值。</p></li><li><p>对于边缘优化 API,请指定 <code>distributionHostedZoneId</code>的值。</p></li></ul></dd><dt>Amazon 虚拟私有云接口</dt><dd><p>指定接口终结点的托管区域 ID。 可以使用 CLI 命令 <href='>'<describe->'</a /a /https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-vpc-endpoints.html获取>HostedZoneId</code >< 代码的值。>/p<>/dd<>dt<CloudFront 分发>/dt<>dd<>p<指定 >代码<Z2FDTNDATAQYW2>/code<。>/p<>注释<>p<CloudFront 的别名资源记录集无法在专用区域中创建。>/p<>/note<>/dd<>dt<Elastic Beanstalk 环境>/dt<>dd<>p指定在其中创建环境的区域的托管区域 ID。 环境必须具有区域化子域。 有关区域列表和相应的托管区域 ID,请参阅 <href='https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html'>Elastic Beanstalk 终结点和配额</a><i>Amazon Web Services 常规参考</i>。</p></dd><dt>ELB 负载均衡器</dt><dd><p>指定负载均衡器的托管区域 ID 的值。 使用以下方法获取托管区域 ID:</p><ul><li><p><href='https://docs.aws.amazon.com/general/latest/gr/elb.html'>弹性负载均衡终结点和 <i>Amazon Web Services 常规参考</i>中的配额</a /a> 主题:使用与在其中创建负载均衡器的区域对应的值。 请注意,应用程序和经典负载均衡器以及网络负载均衡器有单独的列。</p></li><li><p><b>Amazon Web Services Management Console</b>: 转到 Amazon EC2 页面, 在导航窗格中选择 <b>负载均衡器</b>,选择负载均衡器,然后在 <b>说明</b> 选项卡上获取 <b>托管区域</b> 字段的值。</p></li><li><p><b>弹性负载均衡 API</b>:使用 <代码>DescribeLoadBalancers</code> 获取适用值。 有关详细信息,请参阅适用的指南:</p><ul><li><p>经典负载均衡器:使用 <href='https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_DescribeLoadBalancers.html'>DescribeLoadBalancers</a /> 获取 <代码的值>CanonicalHostedZoneNameId</code>。</p></li><li><p>应用程序和网络负载均衡器:使用 <href='https://docs.aws.amazon.com/elasticloadbalancing/latest/APIReference/API_DescribeLoadBalancers.html'>DescribeLoadBalancers</a /> 获取 <代码的值>CanonicalHostedZoneId</code>。</p></li></ul></li><><li><p><b>CLI</b>:使用 <代码>describe-load-balancers/code 获取适用值。 有关详细信息,请参阅适用的指南:</p><ul><li><p>经典负载均衡器:使用 <href='http://docs.aws.amazon.com/cli/latest/reference/elb/describe-load-balancers.html'>describe-load-balancers</a> 获取 <代码的值,>CanonicalHostedZoneNameId</code>。</p></li><li><p>应用程序和网络负载均衡器:使用 <href='http://docs.aws.amazon.com/cli/latest/reference/elbv2/describe-load-balancers.html'>描述负载均衡器</a> 获取 <代码的值>CanonicalHostedZoneId</code>。</p></li></ul></li></ul></dd><dt>global Accelerator accelerator</dt><dd><p>指定 <代码>Z2BJ6XQ5FK7U4H</code>。</p></dd><dt>配置为静态网站</dt><dd><p>指定在其中创建存储桶的区域的托管区域 ID。 有关有效值的详细信息,请参阅 <ihttps://docs.aws.amazon.com/general/latest/gr/s3.html#s3_website_region_endpointsAmazon Web Services 常规参考>/i<>amazon S3 网站终结点</> a<的表 >href='<。>/p<>/dd<>dt<托管区域中的另一个路由 53 资源记录集>/dt<>dd<>p指定托管区域的托管区域 ID。 (别名资源记录集不能引用其他托管区域中的资源记录集。</p></dd></dl> 字符串

AwsRoute53ResourceRecordSet属性

名字 描述 价值
aliasTarget <p><i>别名资源记录集:</i> 有关 Amazon Web Services 资源的信息,例如 CloudFront 分发或要向其路由流量的 Amazon S3 存储桶。 </p><p>如果要为专用托管区域创建资源记录集,请注意以下事项:</p><ul><li><p>无法在专用托管区域中创建别名资源记录集以将流量路由到 CloudFront 分发。</p></li><li><p>有关在专用托管区域中创建故障转移资源记录集的信息,请参阅 <href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-private-hosted-zones.html'>在专用托管区域</a><i>Amazon Route 53 开发人员指南</i>。</p></li></ul> 别名目标
cidrRoutingConfig 属性 cidrRoutingConfig CidrRoutingConfig
故障转移 <p><i>故障转移资源记录集:</i> 若要配置故障转移,请将 <代码>故障转移</code> 元素添加到两个资源记录集。 对于一个资源记录集,请将 PRIMARY<PRIMARY>/code< 指定为 ><代码>故障转移</code>的值;对于其他资源记录集,指定 <代码>SECONDARY</code>。 此外,还包括 healthCheckId<healthCheckId>/code< 元素 >代码,并指定希望 Amazon Route 53 针对每个资源记录集执行的运行状况检查。</p><p>,除非另有指出, 以下故障转移行为假定你已将 <代码>HealthCheckId</code> 元素包含在这两个资源记录集中:</p><ul><li><p>当主资源记录集正常运行时,Route 53 会响应具有主要资源记录集中适用值的 DNS 查询,而不考虑辅助资源记录集的运行状况资源记录集。</p></li><li><p>当主资源记录集运行不正常且辅助资源记录集正常时,Route 53 将响应具有辅助资源记录集中适用值的 DNS 查询。</p></li><li><p>当辅助资源记录集运行不正常时,Route 53 将响应具有主要资源记录集中适用值的 DNS 查询,而不管主要资源记录集的运行状况如何。</p></li><li><p>如果省略辅助资源记录集的 <代码>HealthCheckId</code> 元素,如果主要资源记录集运行不正常,则 Route 53 始终响应具有辅助资源记录集中适用值的 DNS 查询。 无论关联的终结点的运行状况如何,这都是真实的。</p></li></ul><p>无法创建与故障转移资源记录集相同的 <代码>名称</code> 和 <代码>类型</code> 元素作为故障转移资源记录集的值。</p><p>对于故障转移别名资源记录集,还必须包括 evaluateTargetHealth</code> 元素<>代码,并将值设置为 true。</p><p>有关为路由 53 配置故障转移的详细信息, 请参阅 <i>Amazon Route 53 开发人员指南</i>中的以下主题:</p><ul><li><p><a href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover.html'>Route 53 运行状况检查和 DNS 故障转移</a></p></li><li><p><href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-private-hosted-zones.html'>在专用托管区域配置故障转移</a></p></li></ul> ResourceRecordSetFailoverEnumValue
地理位置 <p><i>地理位置资源记录集:</i> 一种复杂类型,用于控制 Amazon Route 53 如何根据查询的地理来源响应 DNS 查询。 例如, 如果要将所有来自非洲的查询路由到 IP 地址为 <代码>192.0.2.111</code>的 Web 服务器,请创建具有 <代码>类型>的资源记录集><代码>A</code><>/code<>/code<>/code<>code<AF>/code<。>/pp如果为重叠地理区域创建单独的资源记录集(例如,一个针对一大洲的资源记录集和一个针对同一大洲的国家/地区),优先级将转到最小的地理区域。 这样,就可以将大陆的大多数查询路由到一个资源,并将该大洲国家/地区的查询路由到其他资源。</p><p>无法创建两个指定相同地理位置的地理位置资源记录集。</p><p><>代码<>/code< 的值>CountryCode</code> 元素匹配所有地理位置 在其他地理位置资源记录集中未指定,<代码>名称</code> 和 <代码>类型</code> 元素的值相同。</p><重要的><p>地理位置的工作原理是将 IP 地址映射到位置。但是,某些 IP 地址不会映射到地理位置,因此,即使你创建涵盖所有七大洲的地理位置资源记录集,Route 53 也会从无法识别的位置接收一些 DNS 查询。建议创建一个资源记录集,<代码>CountryCode</code> 的值 <代码></code>。 两组查询将路由到在此记录中指定的资源:查询来自尚未为其创建地理位置资源记录集的位置的查询,以及来自未映射到位置的 IP 地址的查询。 如果未创建 <代码>*</code> 资源记录集,则 Route 53 将返回来自这些位置的查询的“无答案”响应。</p></important><p>无法创建 <代码>名称</code> 值的非地理位置资源记录集,<代码>Type</code> 元素作为地理位置资源记录集。</p> 地理位置
geoProximityLocation <p><i> GeoproximityLocation 资源记录集:</i> 复杂类型,用于控制 Route 53 如何根据查询和资源地理来源响应 DNS 查询。 </p> GeoProximityLocation
healthCheckId <p>如果希望 Amazon Route 53 仅当运行状况检查状态正常时返回此资源记录集,请包含运行状况检查状态<healthCheckId>/code< 元素的 >代码,并指定适用的运行状况检查的 ID。</p><p>Route 53 确定资源记录集是否正常,具体取决于以下项之一:</p><ul><li><p>By 定期将请求发送到在运行状况检查中指定的终结点</p></li><li><p>通过聚合指定运行状况检查组的状态(计算的运行状况检查)</p></li><li><p>通过确定 CloudWatch 警报(CloudWatch 指标运行状况检查)的当前状态</p></li></ul><重要><p>Route 53 不会检查资源记录集中指定的终结点的运行状况, 例如,<代码中 IP 地址指定的终结点>Value</code> 元素。 将 <代码>HealthCheckId</code> 元素添加到资源记录集时,Route 53 会检查在运行状况检查中指定的终结点的运行状况。 </p></important><p>有关详细信息, 请参阅 <i>Amazon Route 53 开发人员指南</i>中的以下主题:</p><ul><li><p><href=“https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-determining-health-of-endpoints.html'>Amazon Route 53 如何确定终结点是否正常</a /></p></li><li><p><href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover.html'>路由 53 运行状况检查和 DNS 故障转移</a></p></li><li><p><href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-private-hosted-zones.html'>配置专用托管区域中的故障转移</a /a></p></li></ul><p><b>何时指定 HealthCheckId</b></p><p><指定 healthCheckId>code>HealthCheckId>/仅当 Route 53 在两个或多个资源记录集之间进行选择以响应 DNS 查询时,代码 才有用,并且希望 Route 53 根据运行状况检查的状态设置选择。 配置运行状况检查仅在以下配置中才有意义:</p><ul><li><p><b>非别名资源记录集</b>:您正在检查一组具有相同路由策略、名称和类型的非别名资源记录集的运行状况(例如,以 A 类型命名www.example.com的多个加权记录),并且您为所有资源记录集指定运行状况检查 ID。 </p><p>如果资源记录集的运行状况检查状态正常,则 Route 53 包含响应 DNS 查询的记录中的记录。</p><p>如果资源记录集的运行状况检查状态不正常,则 Route 53 停止使用该资源记录集的值响应 DNS 查询。</p><p>如果组中所有资源记录集的运行状况检查状态不正常,则 Route 53 会考虑组中的所有资源记录集正常,并相应地响应 DNS 查询。 </p></li><li><p><b>别名资源记录集</b>:您指定以下设置:</p><ul><li><p>您将一组具有相同路由策略、名称和类型的资源记录集中的别名资源记录集的 code<EvaluateTargetHealth>/code< 设置为 >true(例如,以 A 类型命名www.example.com的多个加权记录)。 </p></li><li><p>配置别名资源记录集,以将流量路由到同一托管区域中的非别名资源记录集。</p></li><li><p>为非别名资源记录集指定运行状况检查 ID。 </p></li></ul><p>如果运行状况检查状态正常,则 Route 53 会将别名资源记录设置为正常,并在响应 DNS 查询的记录中包含别名记录。</p><p>如果运行状况检查状态不正常,则 Route 53 会停止使用别名资源记录集响应 DNS 查询。</p><注释><p>别名资源记录集还可以将流量路由到 <i>组</i> 具有相同路由策略、名称和类型的非别名资源记录集。 在该配置中,将运行状况检查与非别名资源记录集中的所有资源记录集相关联。</p></note></li></ul><p><b>地理位置路由</b></p><>对于地理位置资源记录集,如果终结点运行不正常,则 Route 53 会查找更大的关联地理区域的资源记录集。 例如,假设你有一个状态的资源记录集、整个美国、北美的资源记录集,以及一个 <代码></code> 的资源记录集,<代码>CountryCode</code><代码></code>,适用于所有位置。 如果状态资源记录集的终结点不正常, 路由 53 按以下顺序检查正常的资源记录集,直到找到终结点正常运行的资源记录集:</p><ul><li><p>美国</p></li><li><p>p</p></li><li><p>默认资源记录集</p></li></ul><p><b>指定运行状况检查终结点(按域名</b></p><p>如果运行状况检查仅按域名指定终结点,建议为每个终结点创建单独的运行状况检查。 例如,为每个 <代码>HTTP</code> 服务器创建运行状况检查,该服务器为 <代码>www.example.com</code>提供内容。 对于 <代码的值>FullyQualifiedDomainName</code>,请指定服务器的域名(如 <代码>us-east-2-www.example.com</code>),而不是资源记录集的名称(<代码>www.example.com</code>)。如果执行以下操作,</p><><p>运行状况检查结果将不可预知:</p><ul><li><p>创建与资源记录集名称相同的 <代码>FullQualifiedDomainName</code> 的值的运行状况检查。</p></li><li><p>将运行状况检查与资源记录集相关联。</p></li></ul></important> 字符串
multiValueAnswer 多值答案 <p><i>Multivalue 应答资源记录集仅</i>:若要将流量随机路由到多个资源(例如 Web 服务器),请为每个资源创建一个多值应答记录,并为 <代码>MultiValueAnswer</code>指定 <代码>true</code>。 请注意以下事项:</p><ul><li><p>如果将运行状况检查与多值应答资源记录集相关联,则 Amazon Route 53 仅当运行状况检查正常时才响应具有相应 IP 地址的 DNS 查询。</p></li><li><p>如果不将运行状况检查与多值应答记录相关联,则 Route 53 始终将记录视为正常。</p></li><li><p>Route 53 响应最多八条正常记录的 DNS 查询;如果有 8 条或更少条正常记录,则 Route 53 会使用所有正常记录响应所有 DNS 查询。</p></li><li><p>如果你有 8 个以上的正常记录,Route 53 将响应具有不同组合正常记录的不同 DNS 解析程序。</p></li><li><p>当所有记录都运行不正常时,Route 53 将响应最多包含 8 条不正常记录的 DNS 查询。</p></li><li><p>如果解析程序缓存响应后资源不可用,客户端软件通常会尝试响应中的另一个 IP 地址。</p></li></ul><p>无法创建多值应答别名记录。</p> 布尔
名字 <p>对于 <代码>ChangeResourceRecordSets</code> 请求、要创建、更新或删除的记录的名称。 对于 <代码>ListResourceRecordSets</code> 响应,指定托管区域中记录的名称。</p><p><b>ChangeResourceRecordSets only</b></p><>输入完全限定的域名,例如,<代码>www.example.com</code>。 可以选择包含尾随点。 如果省略尾随点,Amazon Route 53 假定指定的域名是完全限定的。 这意味着 Route 53 处理 <代码>www.example.com</code>(无尾随点)和 <代码>www.example.com。</code>(尾随点)相同。</p><p>有关如何 <代码>a-z</code>指定字符的信息,<代码>0-9</code>,以及 <代码>-</code> (连字符)以及如何指定国际化域名, 请参阅 <ihttps://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DomainNameFormat.htmlAmazon Route 53 开发人员指南>/i /i<中的>DNS 域名格式</a >href='<'>。</p><p>可以使用星号()通配符替换域名中最左侧的标签,例如,<代码>.example.com</code>。 请注意以下事项:</p><ul><li><p>* 必须替换整个标签。 例如,不能指定 <代码>prod.example.com</code> 或 <代码>prod.example.com</code>。</p></li><li><p>* 无法替换任何中间标签,例如 marketing.*.example.com。</p></li><li><p>如果在域名中除最左边的标签之外的任何位置包含 * ,DNS 将其视为 * 字符(ASCII 42),而不是通配符。</p><重要的><p>不能对具有 NS 类型的资源记录集使用 * 通配符。</p></important></li></ul> 字符串
地区 <p><i>基于延迟的资源记录集:</i> 在其中创建了此资源记录集引用的资源的 Amazon EC2 区域。 资源通常是 Amazon Web Services 资源,例如 EC2 实例或 ELB 负载均衡器,并根据记录类型由 IP 地址或 DNS 域名引用。</p><p>Amazon Route 53 收到域名和类型 DNS 查询时,已为其创建延迟资源记录集的域名和类型,Route 53 将选择在最终用户与关联的 Amazon EC2 区域之间具有最低延迟的延迟资源记录集。 然后,Route 53 返回与所选资源记录集关联的值。</p><p>请注意:</p><ul><li><p>只能为每个延迟资源记录集指定一个 <代码>ResourceRecord</code>。</p></li><li><p>只能为每个 Amazon EC2 区域创建一个延迟资源记录集。</p></li><li><p>无需为所有 Amazon EC2 区域创建延迟资源记录集。 路由 53 将从创建延迟资源记录集的区域中选择具有最佳延迟的区域。</p></li><li><p>无法创建 <代码>名称</code><代码>类型</code> 元素作为延迟资源记录集的值的非延迟资源记录集。</p></li></ul> ResourceRecordSetRegionEnumValue
resourceRecords <p>要处理的资源记录的信息。</p><注释><p>如果要创建别名资源记录集,请省略 resourceRecords</code><代码 >代码。</p></note> ResourceRecord[]
setIdentifier 的 <p><i>具有非简单路由策略的资源记录集:</i> 区分名称与类型相同的多个资源记录集,例如 acme.example.com 具有 A 类型的多个加权资源记录集。在具有相同名称和类型的一组资源记录集中,<代码的值>SetIdentifier</code> 对于每个资源记录集必须是唯一的。 </p><p>有关路由策略的信息,请参阅 <href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html'>在 <i>Amazon Route 53 开发人员指南</i>中选择路由策略</a>。</p> 字符串
trafficPolicyInstanceId 流量策略实例 ID <p>创建流量策略实例时,Amazon Route 53 会自动创建资源记录集。 <代码>TrafficPolicyInstanceId</code> 是路由 53 创建此资源记录集的流量策略实例的 ID。</p><重要的><p>若要删除与流量策略实例关联的资源记录集,请使用 <代码>DeleteTrafficPolicyInstance</code>。 路由 53 将自动删除资源记录集。 如果使用 <代码删除资源记录集>ChangeResourceRecordSets</code>,则 Route 53 不会自动删除流量策略实例,即使不再使用,也会继续为其收费。 </p></重要> 字符串
ttl <p>资源记录缓存生存时间(TTL),以秒为单位。 请注意以下事项:</p><ul><li><p>如果要创建或更新别名资源记录集,请省略<TTL>/code<>代码。 Amazon Route 53 使用别名目标的 <代码>TTL</code> 的值。 </p></li><li><p>如果要将此资源记录集与运行状况检查相关联(如果要<HealthCheck 添加 >代码 建议</code> 元素)指定一个 <代码,>TTL</code> 60 秒或更短的时间,以便客户端快速响应运行状况更改。</p></li><li><p>一组加权资源记录集中的所有资源记录集必须具有相同的值,<代码>TTL</code>。</p></li><li><p>如果一组加权资源记录集包含别名目标为 ELB 负载均衡器的一个或多个加权别名资源记录集,建议为所有具有相同名称和类型的非别名加权资源记录集指定 TTL<TTL>/code< 60 秒 >代码。 除 60 秒以外的值(负载均衡器的 TTL)将更改为 <代码指定的值的效果,>Weight</code>。</p></li></ul> 整数 (int)
类型 <p>DNS 记录类型。 有关不同记录类型以及如何对数据进行编码的信息,请参阅 <i Amazon Route 53 开发人员指南https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/ResourceRecordTypes.html/i> 中的 <a href='>'<支持的 DNS 资源记录类型>/a<。></p>p 基本资源记录集的有效值:<代码>A</代码> | <><代码>AAAA</代码> | <代码>CAA</代码> | <代码>CNAME/<code> | <代码>DS</code> |<代码>MX</代码> | <代码>NAPTR</code> | <代码>NS/<代码> | <代码>PTR</代码> | <代码>SOA</代码> | <代码>SPF</代码> | <代码>SRV</代码> | <code>TXT</code></p><p>加权、延迟、地理位置和故障转移资源记录集的值:<code>A</code> | <代码>AAAA</代码> | <代码>CAA</代码> | <代码>CNAME/<code> | <代码>MX</代码> | <代码>NAPTR</code> | <代码>PTR</代码> | <代码>SPF</代码> | <代码>SRV</代码> | <代码>TXT</代码>。 在创建一组加权、延迟、地理位置或故障转移资源记录集时,请为组中的所有资源记录集指定相同的值。</p>p 多值答案资源记录集的有效值:<代码>A</code> | <><代码>AAAA</代码> | <代码>MX</代码> | <代码>NAPTR</code> | <代码>PTR</代码> | <代码>SPF</代码> | <代码>SRV</代码> | <code>TXT</code></p><note><p>SPF 记录以前用于验证电子邮件发件人的身份。 但是,我们不再建议创建 <代码的值>类型</code><代码>SPF</code>的资源记录集。 RFC 7208,<i>发件人策略框架(SPF)在电子邮件中授权使用域,版本 1</i>,已更新为“...[i]ts 存在和 [RFC4408] 中定义的机制导致了一些互操作性问题。 因此,其使用不再适用于 SPF 版本 1;实现不使用它。 在 RFC 7208 中,请参阅第 14.1 节,<href='http://tools.ietf.org/html/rfc7208#section-14.1'>SPF DNS 记录类型</a>。</p></note><p>别名资源记录集的值:</p><ul><li><p><b>Amazon API Gateway 自定义区域 API 和边缘 优化 API:</b><代码>A</code></p></li><li><p><b>CloudFront 分发版:</b><代码>A</code></p><p>如果为分发启用了 IPv6, 创建两个资源记录集以将流量路由到分发,一个资源记录集,其中一个值 <代码>A</code>,一个具有 AAAA</code>的值 <>代码。 </p>/li<>li<>p<>b<具有区域化子域>的 Amazon API Gateway 环境/b<:>代码<A>/code<>/p/li<><> li<>p<>b<ELB 负载均衡器:>/b<>代码<A>/code | <><代码>AAAA</code></p></li><li p><><b>Amazon S3 存储桶:</b><代码>A</code></p></li><li><p><b>Amazon Virtual Private Cloud 接口 VPC 终端节点</b><代码>A</code></p></li><li><p><b>此托管区域中的另一个资源记录集:</b>指定要为其创建别名的资源记录集的类型。 除 <NS>/code<>代码>代码和 >代码<SOA>/code<之外,支持所有值。>/p<>注释<>p<如果要创建与托管区域(称为区域顶点)同名的别名记录(称为区域顶点),则无法将流量路由到>类型</code><代码>CNAME</code>的 代码值。 这是因为别名记录的类型必须与将流量路由到的记录具有相同的类型,并且即使别名记录也不支持为区域顶点创建 CNAME 记录。</p></note></li></ul> RRTypeEnumValue
重量 <p><i>加权资源记录集:</i> 在具有相同 DNS 名称和类型组合的资源记录集中,一个值,用于确定 Amazon Route 53 使用当前资源记录集响应的 DNS 查询的比例。 路由 53 计算具有相同 DNS 名称和类型的资源记录集权重的总和。 然后,路由 53 根据资源的权重与总计的比例响应查询。 请注意以下事项:</p><ul><li><p>必须为每个加权资源记录集指定 <代码>Weight</code> 元素的值。</p></li><li><p>只能为每个加权资源记录集指定一个 <代码>ResourceRecord</code>。</p></li><li><p>无法创建与加权资源记录集相同的 <代码>名称</code> 值以及 <代码>类型</code> 元素作为加权资源记录集的值。</p></li><li><p>最多可以创建 100 个加权资源记录集,这些记录集 <>名称</code> 和 <代码>类型</code> 元素。</p></li><li><p>(但不是加权别名)资源记录集,如果将 <代码>权重</code> 设置为 <代码>0</code> 的资源记录集,则 Route 53 永远不会响应具有该资源记录集适用值的查询。 但是,如果将 <代码>权重</code> 设置为 <代码>0</code>,则具有相同 DNS 名称和类型组合的所有资源记录集的流量将路由到概率相等的所有资源。</p><p>将 <代码>权重</code> 设置为 <代码>0</code> 的效果与加权资源记录集相关联时,将运行状况检查与加权资源记录集相关联。 有关详细信息,请参阅 <ihttps://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.htmlAmazon Route 53 开发人员指南>/i<<Active-Active 和 Active-Passive 故障转移</> a<选项 >href='<'<选项。</p></li>/ul 整数 (int)

CidrRoutingConfig

名字 描述 价值
collectionId <p>CIDR 集合 ID。</p> 字符串
location名称 <p>CIDR 集合位置名称。</p> 字符串

坐标

名字 描述 价值
纬度 <p> 指定地球表面地理点(-90 - 90)的南北位置坐标。 </p> 字符串
经度 <p> 指定地球表面地理点(-180- 180)的东-西位置坐标。 </p> 字符串

地理位置

名字 描述 价值
continentCode <p>非洲大陆的双字母代码。</p><p>Amazon Route 53 支持以下大陆代码:</p><ul><li><p><b>AF</b>: 非洲</p></li><li><p><b>AN</b>: 南极洲</p></li><li><p><b>AS</b>: 亚洲</p></li><li><p><b><>b</b>: 欧洲</p></li><li><p><><b>OC</b>: 大洋洲</p></li><li><p><b>NA</b>: 北美</p></li><li><p><b>sa</b>: 南美洲</p></li></ul><p>约束: 指定 <代码><大洲 >代码<CountryCode>/< code> 或 <代码>SubdivisionCode</code> 返回 <代码>InvalidInput/code 错误。/p 字符串
countryCode (国家代码) <p>对于地理位置资源记录集,一个国家/地区的双字母代码。</p><p>Amazon Route 53 使用在 <href='https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2'>ISO 标准 3166-1 alpha-2</a>中指定的双字母国家/地区代码。</p><p>53 路线还支持乌克兰 <b>UA</b> 的国家代码。</p> 字符串
subdivisionCode <p>对于地理位置资源记录集,为美国州的双字母代码。 Route 53 不支持 <代码>SubdivisionCode</code>的任何其他值。 有关州缩写列表,请参阅美国邮政局网站上的 <href='https://pe.usps.com/text/pub28/28apb.htm'>附录 B: 双字母州和所有权缩写</a>。 </p><p>如果指定 <代码>细分代码</code>,还必须为 <代码>CountryCode</code>指定 <代码>>>/code。 </p> 字符串

GeoProximityLocation

名字 描述 价值
awsRegion <p> 要定向 DNS 流量的资源所在的 Amazon Web Services 区域。 </p> 字符串
偏见 <p> 偏差会增加或减少路由 53 路由到资源的地理区域的大小。 </p><p>若要使用 <代码>偏差</code> 更改地理区域的大小,请指定偏差的适用值:</p><ul><li><p>若要扩展路由 53 路由流量到资源的地理区域的大小, 为偏差指定从 1 到 99 的正整数。 路由 53 会缩小相邻区域的大小。 </p></li><li><p>若要缩小路由 53 路由到资源的地理区域的大小,请指定 -1 到 -99 的负偏差。 路由 53 扩展相邻区域的大小。 </p></li></ul> 整数 (int)
坐标 <p> 包含地理区域的经度和纬度。 </p> 坐标
localZoneGroup <p> 指定 Amazon Web Services 本地区域组。 </p><p>本地区域组通常是本地区域代码,没有结束字符。 例如,如果本地区域 <代码>us-east-1-bue-1a</code> 本地区域组 <代码>us-east-1-bue-1</code>。</p><p>可以使用 href=' <href='https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-availability-zones.html'>describe-availability-zone</a /> CLI 命令:</p><p>此命令返回: <代码>'GroupName' :“us-west-2-den-1”</code>,指定本地区域 <代码>us-west-2-den-1a</code> 属于本地区域组 <代码>us-west-2-den-1</code>。</p> 字符串

资源记录

名字 描述 价值
价值 <p>当前或新的 DNS 记录值,不超过 4,000 个字符。 如果 <代码>DELETE</code> 操作,如果当前值与实际值不匹配,则返回错误。 有关如何为不同记录类型设置 <代码>值</code> 的格式的说明,请参阅 <href='https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/ResourceRecordTypes.html>'>支持的 DNS 资源记录类型>/<>i<Amazon Route 53 开发人员指南>/i<。>/p<>p<可以为所有记录类型指定多个值,但 CNAME>/code>><代码> 和 <代码>SOA/code。 </p><注释><p>如果要创建别名资源记录集,请省略 <代码>值</code>。</p></note> 字符串

ResourceRecordSetFailoverEnumValue

名字 描述 价值
价值 属性值 “PRIMARY”
“SECONDARY”

ResourceRecordSetRegionEnumValue

名字 描述 价值
价值 属性值 “af-south-1”
“ap-east-1”
“ap-northeast-1”
“ap-northeast-2”
“ap-northeast-3”
“ap-south-1”
“ap-south-2”
“ap-southeast-1”
“ap-southeast-2”
“ap-southeast-3”
“ap-southeast-4”
“ca-central-1”
“ca-west-1”
“cn-north-1”
“cn-northwest-1”
“eu-central-1”
“eu-central-2”
“eu-north-1”
“eu-south-1”
“eu-south-2”
“eu-west-1”
“eu-west-2”
“eu-west-3”
“il-central-1”
“me-central-1”
“me-south-1”
“sa-east-1”
“us-east-1”
“us-east-2”
“us-west-1”
“us-west-2”

Route53ResourceRecordSet属性

名字 描述 价值
阿恩 Amazon 资源名称 (ARN) 字符串
awsAccountId AWS 帐户 ID 字符串
awsProperties AWS 属性 AwsRoute53ResourceRecordSet属性
awsRegion AWS 区域 字符串
awsSourceSchema AWS 源架构 字符串
aws标签 AWS 标记 Route53ResourceRecordSetPropertiesAwsTags
publicCloudConnectorsResourceId 公有云连接器资源 ID 字符串
publicCloudResourceName (公共云资源名称) 公有云资源名称 字符串

Route53ResourceRecordSetPropertiesAwsTags

名字 描述 价值

RRTypeEnumValue

名字 描述 价值
价值 属性值 “A”
“AAAA”
“CAA”
“CNAME”
“DS”
“MX”
“NAPTR”
“NS”
“PTR”
“SOA”
“SPF”
“SRV”
“TXT”

TrackedResourceTags

名字 描述 价值