メニュー
AWS CloudFormation
ユーザーガイド (API Version 2010-05-15)

AWS::Route53::HostedZone

AWS::Route53::HostedZone リソースは、ドメインのレコードセットのコレクションを含めることのできるホストゾーンを作成します。最上位ドメイン (TLD) のホストゾーンを作成することはできません。詳細については、Amazon Route 53 API Referenceの「POST CreateHostedZone」または「POST CreateHostedZone (プライベート) 」を参照してください。

構文

AWS CloudFormation テンプレートでこのエンティティを宣言するには、次の構文を使用します。

JSON

Copy
{ "Type" : "AWS::Route53::HostedZone", "Properties" : { "HostedZoneConfig" : HostedZoneConfig, "HostedZoneTags" : [ HostedZoneTags, ... ], "Name" : String, "VPCs" : [ HostedZoneVPCs, ... ] } }

YAML

Copy
Type: "AWS::Route53::HostedZone" Properties: HostedZoneConfig: HostedZoneConfig HostedZoneTags: - HostedZoneTags Name: String VPCs: - HostedZoneVPCs

プロパティ

HostedZoneConfig

ホストゾーンに関するコメント (省略可能) を含む複合型。

Required: No

タイプ: Amazon Route 53 HostedZoneConfig プロパティ

更新に伴う要件: 中断はありません。

HostedZoneTags

このホストゾーンに対するタグ (キーと値のペア) の任意のセット。

Required: No

: Amazon Route 53 HostedZoneTags のリスト

更新に伴う要件: 中断はありません。

Name

ドメインの名前。ドメイン名を含むリソースレコードタイプの場合は、完全修飾ドメイン名を指定します。

Required: Yes

Type: String

更新に伴う要件: 置換

VPCs

このホストゾーンに関連付ける 1 つ以上の VPC。このプロパティを指定すると、AWS CloudFormation でプライベートホストゾーンが作成されます。

Required: No

: Amazon Route 53 HostedZoneVPCs のリスト

以前にこのプロパティが指定されており、その値を変更する場合、その更新は中断なしに発生します。このプロパティを指定したことがなく、値を追加する場合、更新で置換が必要です。また、このプロパティが指定されており、すべての値を削除する場合も、更新で置換が必要です。

戻り値

参照番号

このリソースの論理 ID が Ref 組み込み関数に提供されると、Ref によりリソース名が返されます。 例:

Copy
{ "Ref": "myHostedZone" }

RefZ23ABC4XYZL05B などのホストゾーン ID を返します。

Ref 関数の使用方法の詳細については、「Ref」を参照してください。

Fn::GetAtt

Fn::GetAtt は、このタイプの指定された属性の値を返します。以下には、利用可能な属性とサンプル戻り値のリストが示されます。

NameServers

特定のホストゾーンのネームサーバーのセットを返します。例: ns1.example.com

この属性は、プライベートホストゾーンではサポートされていません。

Fn::GetAtt の使用の詳細については、「Fn::GetAtt」を参照してください。

次のテンプレートスニペットでは、example.com ドメインのプライベートホストゾーンを作成します。

JSON

Copy
"DNS": { "Type": "AWS::Route53::HostedZone", "Properties": { "HostedZoneConfig": { "Comment": "My hosted zone for example.com" }, "Name": "example.com", "VPCs": [{ "VPCId": "vpc-abcd1234", "VPCRegion": "ap-northeast-1" }, { "VPCId": "vpc-efgh5678", "VPCRegion": "us-west-2" }], "HostedZoneTags" : [{ "Key": "SampleKey1", "Value": "SampleValue1" }, { "Key": "SampleKey2", "Value": "SampleValue2" }] } }

YAML

Copy
DNS: Type: "AWS::Route53::HostedZone" Properties: HostedZoneConfig: Comment: "My hosted zone for example.com" Name: "example.com" VPCs: - VPCId: "vpc-abcd1234" VPCRegion: "ap-northeast-1" - VPCId: "vpc-efgh5678" VPCRegion: "us-west-2" HostedZoneTags: - Key: "SampleKey1" Value: "SampleValue1" - Key: "SampleKey2" Value: "SampleValue2"

このページの内容: