翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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
-
レコードを作成するホストゾーンの名前です。
HostedZoneName
またはHostedZoneId
を指定します。両方を指定することはできません。同じドメイン名のホストゾーンが複数ある場合は、HostedZoneId
を使用してホストゾーンを指定する必要があります。型: 文字列
必須: いいえ
AWS CloudFormation との互換性: このプロパティは、
AWS::Route53::RecordSetGroup RecordSet
リソースのHostedZoneName
プロパティに直接渡されます。 -
IpV6
-
このプロパティを設定すると、AWS SAM が
AWS::Route53::RecordSet
リソースを作成し、提供された HostedZone のタイプをAAAA
に設定します。タイプ: ブール
必須: いいえ
AWS CloudFormation との互換性: このプロパティは AWS SAM に固有であり、AWS CloudFormation に同等のものはありません。
Region
-
レイテンシーベースのリソースレコードセットのみ: このリソースレコードセットが参照するリソースを作成した Amazon EC2 リージョン。リソースは通常、AWS リソース (EC2 インスタンスや ELB ロードバランサーなど) であり、レコードタイプに応じて IP アドレスまたは DNS ドメイン名で参照されます。
レイテンシーリソースレコードセットが作成されているドメインの名前や種類を要求する DNS クエリを受け取ると、Amazon Route 53 は、エンドユーザーとそのユーザーに関連付けられている Amazon EC2 リージョンとの間でレイテンシーが最も小さいレイテンシーリソースレコードセットを選択します。その後、Route 53 は、選択したリソースレコードセットに関連付けられている値を返します。
次の点に注意してください。
-
レイテンシーリソースレコードセットごとに 1 つの
ResourceRecord
のみ指定できます。 -
作成できるレイテンシーリソースレコードセットは、各 Amazon EC2 リージョンにつき 1 つだけです。
-
すべての Amazon EC2 リージョンに対してレイテンシーリソースレコードセットを作成する必要はありません。レイテンシーリソースレコードセットを作成したリージョンの中から、レイテンシーの最も小さいリージョンが Route 53 によって選択されます。
-
レイテンシーリソースレコードセットリソースと
Name
およびType
要素の値が同じである非レイテンシーリソースレコードセットを作成することはできません。
型: 文字列
必須: いいえ
AWS CloudFormation との互換性: このプロパティは、
AWS::Route53::RecordSetGroup
RecordSet
データ型のRegion
プロパティに直接渡されます。 -
SetIdentifier
-
シンプル以外のルーティングポリシーを持つリソースレコードセット: タイプが A である acme.example.com という名前の複数の加重リソースレコードセットなど、名前とタイプの組み合わせが同じである複数のリソースレコードセットを区別する識別子。名前とタイプが同じであるリソースレコードセットのグループでは、リソースレコードセットごとに
SetIdentifier
の値が一意である必要があります。ルーティングポリシーの詳細については、「Amazon Route 53 デベロッパーガイド」の「ルーティングポリシーの選択」を参照してください。
型: 文字列
必須: いいえ
AWS CloudFormation との互換性: このプロパティは、
AWS::Route53::RecordSetGroup
RecordSet
データ型のSetIdentifier
プロパティに直接渡されます。
例
基本的な の例
この例では、API 用にカスタムドメインと Route 53 のレコードセットを設定します。
YAML
Resources:
MyApi:
Type: AWS::Serverless::Api
Properties:
StageName: Prod
Domain:
DomainName: www.example.com
CertificateArn: arn:aws:acm:us-east-1:123456789012:certificate/abcdef12-3456-7890-abcd-ef1234567890
EndpointConfiguration: REGIONAL
Route53:
HostedZoneId: ABCDEFGHIJKLMNOP