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

CloudFront DistributionConfig

DistributionConfig は、ウェブサイトまたはアプリケーションを通じてユーザーからファイルがリクエストされたときにどのオリジンサーバーからファイルを取得するかを Amazon CloudFront に指示する AWS::CloudFront::Distribution プロパティのプロパティです。

構文

JSON

Copy
{ "Aliases" : [ String, ... ], "CacheBehaviors" : [ CacheBehavior, ... ], "Comment" : String, "CustomErrorResponses" : [ CustomErrorResponse, ... ], "DefaultCacheBehavior" : DefaultCacheBehavior, "DefaultRootObject" : String, "Enabled" : Boolean, "HttpVersion" : String, "IPV6Enabled" : Boolean, "Logging" : Logging, "Origins" : [ Origin, ... ], "PriceClass" : String, "Restrictions" : Restriction, "ViewerCertificate" : ViewerCertificate, "WebACLId" : String }

YAML

Copy
Aliases: - 文字列 CacheBehaviors: CacheBehavior Comment: String CustomErrorResponses: CustomErrorResponse DefaultCacheBehavior: DefaultCacheBehavior DefaultRootObject: String Enabled: Boolean HttpVersion: String IPV6Enabled: Boolean Logging: Logging Origins: Origin PriceClass: String Restrictions: Restriction ViewerCertificate: ViewerCertificate WebACLId: String

プロパティ

Aliases

ディストリビューションの CNAME (代替ドメイン名) (存在する場合)。

Required: No

Type: List of String values

CacheBehaviors

ディストリビューションの CacheBehavior タイプのリスト。

Required: No

: CacheBehavior のリスト

Comment

ディストリビューションに関して含める任意のコメント。オプション。

ディストリビューションを作成するときに、最大で 128 文字のコメントを含めることができます。コメントの更新はいつでも行うことができます。

Required: No

Type: String

CustomErrorResponses

CloudFront が応答をビューアに返す前に 4xx5xx の範囲の HTTP ステータスコードをカスタムエラーメッセージで置き換えるかどうか。

Required: No

: CloudFront DistributionConfig CustomErrorResponse のリスト

DefaultCacheBehavior

CacheBehavior プロパティを指定しない場合や CacheBehavior プロパティの PathPattern の値のいずれにもファイルが一致しない場合にトリガーされるデフォルトのキャッシュ動作。

Required: Yes

: DefaultCacheBehavior タイプ

DefaultRootObject

ディストリビューションのルート URL (たとえば、http://example.com/) がリクエストされたときに CloudFront がオリジンにリクエストするオブジェクト (たとえば、index.html)。

注記

デフォルトのルートオブジェクトを指定すると、ディストリビューションのコンテンツが公開されなくなります。

Required: No

Type: String

Enabled

ディストリビューションがエンドユーザーからのコンテンツのリクエストを受け付けることができるかどうかを制御します。

Required: Yes

Type: Boolean

HttpVersion

ビューワーが CloudFront との通信に使用できる最新の HTTP バージョン。最新バージョンをサポートしないビューワーは、自動的に以前の HTTP バージョンを使用します。デフォルトでは、AWS CloudFormation は http1.1 を指定します。

有効な値については、Amazon CloudFront API リファレンスDistributionConfig データ型の HttpVersion コンテンツを参照してください。

Required: No

Type: String

IPV6Enabled

CloudFront で、ディストリビューションの IPv6 アドレスによって IPv6 DNS リクエストに応答したい場合は、true を指定します。 false を指定した場合、CloudFront は IP アドレスではなく DNS レスポンスコードの NOERROR で、IPv6 DNS リクエストに応答します。 これにより、閲覧者はディストリビューションの IPv4 アドレスの 2 番目のリクエストを送信できます。 詳細については、Amazon CloudFront API リファレンスCreateDistribution を参照してください。

必須: いいえ

タイプ: ブール値

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

Logging

ディストリビューションに対してアクセスログを記録するかどうかを制御します。アクセスログを有効にするには、このプロパティを指定します。

Required: No

: Logging タイプ

Origins

この CloudFront ディストリビューションのオリジンのリスト。オリジンごとに、Amazon S3 オリジンであるかまたはカスタムオリジンであるかを指定できます。

Required: Yes

: オリジンのリスト。

PriceClass

CloudFront サービスに支払う上限価格に対応する価格クラス。詳細については、Amazon CloudFront 開発者ガイド」の「価格クラスの選択」を参照してください。

有効な値の詳細については、Amazon CloudFront API リファレンスDistributionConfig データ型の PriceClass コンテンツを参照してください。

Required: No

Type: String

Restrictions

コンテンツにアクセスできるユーザーに関する制限またはビューアがコンテンツにアクセスする方法に関する制限を指定します。

Required: No

タイプ: CloudFront DistributionConfiguration の制限

ViewerCertificate

ビューアが HTTPS を使用してオブジェクトをリクエストするときに使用する証明書。

Required: No

タイプ: CloudFront DistributionConfiguration ViewerCertificate

WebACLId

このディストリビューションに関連付ける AWS WAF ウェブ ACL。AWS WAF は、CloudFront に転送される HTTP および HTTPS リクエストをモニタリングし、コンテンツにアクセスできるユーザーを制御できるようにする Web アプリケーションファイアウォールです。CloudFront は、リクエストの生成元 IP アドレスやクエリ文字列の値など、指定した条件に基づいてリクエストを許可または禁止します。

Required: No

Type: String

このページの内容: