Route53Configuration - AWS Serverless Application Model
구문속성예시

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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호환성: 이 속성은 DNSName 리소스의 AWS::Route53::RecordSetGroup AliasTarget 속성으로 직접 전달됩니다.

추가 참고 사항: CloudFront 배포의 도메인 이름입니다.

EvaluateTargetHealth

EvaluateTargetHealth가 true인 경우 별칭 레코드는 Elastic Load Balancing 로드 밸런서 또는 호스팅 영역의 또 다른 레코드와 같은 참조된 AWS 리소스의 상태를 상속합니다.

유형: 부울

필수 항목 여부: 아니요

AWS CloudFormation호환성: 이 속성은 EvaluateTargetHealth 리소스의 AWS::Route53::RecordSetGroup AliasTarget 속성으로 직접 전달됩니다.

추가 참고 사항: 별칭 대상이 CloudFront 배포인 경우, EvaluateTargetHealth를 true로 설정할 수 없습니다.

HostedZoneId

기록을 생성하려는 호스팅 영역의 ID입니다.

HostedZoneName 또는 HostedZoneId 중 하나를 지정하며 둘 다 지정하지 않습니다. 동일한 도메인 이름을 가진 호스팅 영역이 여러 개 있는 경우 HostedZoneId를 사용하여 호스팅 영역을 지정해야 합니다.

유형: 문자열

필수 항목 여부: 아니요

AWS CloudFormation호환성: 이 속성은 HostedZoneId 리소스의 AWS::Route53::RecordSetGroup RecordSet 속성으로 직접 전달됩니다.

HostedZoneName

기록을 생성하려는 호스팅 영역의 이름입니다.

HostedZoneName 또는 HostedZoneId 중 하나를 지정하며 둘 다 지정하지 않습니다. 동일한 도메인 이름을 가진 호스팅 영역이 여러 개 있는 경우 HostedZoneId를 사용하여 호스팅 영역을 지정해야 합니다.

유형: 문자열

필수 항목 여부: 아니요

AWS CloudFormation호환성: 이 속성은 HostedZoneName 리소스의 AWS::Route53::RecordSetGroup RecordSet 속성으로 직접 전달됩니다.

IpV6

이 속성을 설정하면 AWS SAM은 제공된 HostedZone에 대해 AWS::Route53::RecordSet 리소스를 만들고 유형을 AAAA로 설정합니다.

유형: 부울

필수 항목 여부: 아니요

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를 1개씩만 지정할 수 있습니다.

  • 각 Amazon EC2 리전에 지연 시간 리소스 기록 세트를 1개씩만 생성할 수 있습니다.

  • 모든 Amazon EC2 리전에 지연 시간 리소스 기록 세트를 생성할 필요는 없습니다. Route 53은 지연 시간 리소스 기록 세트를 생성할 리전 중에서 지연 시간이 가장 좋은 리전을 선택합니다.

  • Name 및 Type 요소 값이 지연 시간 리소스 기록 세트와 같은 비-지연 시간 리소스 기록 세트를 생성할 수 없습니다.

유형: 문자열

필수 항목 여부: 아니요

AWS CloudFormation호환성: 이 속성은 Region AWS::Route53::RecordSetGroup 데이터 유형의 RecordSet 속성에 직접 전달됩니다.

SetIdentifier

단순하지 않은 라우팅 정책이 있는 리소스 기록 세트: 이름과 유형의 조합이 동일한 여러 리소스 기록 세트(이름이 acme.example.com이고 유형이 A인 여러 가중치 기반 리소스 기록 세트) 사이에서 차별화되는 식별자입니다. 이름과 유형이 동일한 리소스 기록 세트 그룹에서 각 리소스 기록 세트의 SetIdentifier 값은 고유해야 합니다.

라우팅 정책에 대한 자세한 내용을 알아보려면 Amazon Route 53 개발자 안내서의 라우팅 정책 선택을 참조하세요.

유형: 문자열

필수 항목 여부: 아니요

AWS CloudFormation호환성: 이 속성은 SetIdentifier AWS::Route53::RecordSetGroup 데이터 유형의 RecordSet 속성에 직접 전달됩니다.

예시

기본 예제

이 예시에서는 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