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

AWS::Config::DeliveryChannel

AWS::Config::DeliveryChannel リソースは、通知および更新された AWS リソースの設定状態を AWS Config がどこに送信するかを示します。

配信チャネルを作成する場合は、以下を指定できます。

  • AWS Config が設定スナップショットを Amazon S3 バケットに配信する頻度 (たとえば、24 時間)

  • AWS Config から設定スナップショットおよび設定履歴ファイルを送信する先の S3 バケット

  • 更新されたリソース、AWS Config ルールの評価、および AWS Config が設定スナップショットを S3 バケットに送信するタイミングなど、AWS Config が設定変更についての通知を送信する先の Amazon SNS トピック。

詳細については、AWS Config Developer Guide設定項目の配信を参照してください。

注記

AWS Config を有効にするには、設定レコーダーと配信チャネルを作成する必要があります。個別にリソースを作成する場合は、配信チャネルを作成する前に設定レコーダーを作成する必要があります。AWS Config は設定レコーダーを使用してリソースへの設定の変更をキャプチャします。詳細については、「AWS::Config::ConfigurationRecorder」を参照してください。

詳細については、AWS Config Developer Guide配信チャネルの管理を参照してください。

構文

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

JSON

Copy
{ "Type" : "AWS::Config::DeliveryChannel", "Properties" : { "ConfigSnapshotDeliveryProperties" : Config snapshot delivery properties, "Name" : String, "S3BucketName" : String, "S3KeyPrefix" : String, "SnsTopicARN" : String } }

YAML

Copy
Type: "AWS::Config::DeliveryChannel" Properties: ConfigSnapshotDeliveryProperties: Config snapshot delivery properties Name: String S3BucketName: String S3KeyPrefix: String SnsTopicARN: String

プロパティ

ConfigSnapshotDeliveryProperties

AWS Config が配信チャネルで S3 バケットに設定スナップショットを配信する方法のオプションを提供します。

Required: No

Type: AWS Config DeliveryChannel ConfigSnapshotDeliveryProperties

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

Name

配信チャネルの名前。名前を指定しない場合、AWS CloudFormation は一意の物理 ID を生成し、その ID を配信チャネル名として使用します。詳細については、「Name タイプ」を参照してください。

Required: No

Type: String

[Update requires]: アップデートはサポートされていません。 名前を変更するには、2 つの別個の更新を実行する必要があります。1 回目の更新でこのリソースを削除し、2 回目の更新で新しい名前を使用して再作成します。

S3BucketName

配信チャネルの設定履歴を保存する S3 バケットの名前。

Required: Yes

Type: String

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

S3KeyPrefix

指定された S3 バケットのキープレフィックス (フォルダ)。

Required: No

Type: String

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

SnsTopicARN

AWS Config が通知を送信する Amazon Simple Notification Service (Amazon SNS) トピックの Amazon リソースネーム (ARN)。

Required: No

Type: String

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

戻り値

参照番号

AWS::Config::DeliveryChannel リソースの論理 ID を組み込み Ref 関数に渡すと、関数は配信チャネル名 (default など) を返します。

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

以下の例では、指定された Amazon SNS トピックに通知を送信する配信チャネルを作成します。配信チャネルは、指定された S3 バケットに設定変更とスナップショットも送信します。

JSON

Copy
"DeliveryChannel": { "Type": "AWS::Config::DeliveryChannel", "Properties": { "ConfigSnapshotDeliveryProperties": { "DeliveryFrequency": "Six_Hours" }, "S3BucketName": {"Ref": "ConfigBucket"}, "SnsTopicARN": {"Ref": "ConfigTopic"} } }

YAML

Copy
DeliveryChannel: Type: "AWS::Config::DeliveryChannel" Properties: ConfigSnapshotDeliveryProperties: DeliveryFrequency: "Six_Hours" S3BucketName: Ref: ConfigBucket SnsTopicARN: Ref: ConfigTopic

このページの内容: