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

AWS::DMS::EventSubscription

AWS::DMS::EventSubscription リソースを使用して、Amazon Simple Notification Service から AWS Database Migration Service イベントの通知を取得します。詳細については、『AWS Database Migration Service ユーザーガイド』の「AWS DMS イベント通知の使用」を参照してください。

構文

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

JSON

Copy
{ "Type" : "AWS::DMS::EventSubscription", "Properties" : { "Enabled" : Boolean, "EventCategories" : [ String, ... ], "SnsTopicArn" : String, "SourceIds" : [ String, ... ], "SourceType" : String, "SubscriptionName" : [ String, ... ], "Tags" : [ Resource Tag, ... ] } }

YAML

Copy
Type: "AWS::DMS::EventSubscription" Properties: Enabled: Boolean EventCategories: - 文字列 SnsTopicArn: String SourceIds: - 文字列 SourceType: String SubscriptionName: - 文字列 Tags: - Resource Tag

プロパティ

Enabled

サブスクリプションをアクティブ化するかどうかを示します。このプロパティを指定しないと、AWS CloudFormation はサブスクリプションをアクティブ化します。

Required: No

Type: Boolean

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

EventCategories

特定のソースタイプについてサブスクライブするイベントカテゴリのリスト。このプロパティを指定しなかった場合、すべてのイベントカテゴリについて通知されます。詳細については、『AWS Database Migration Service ユーザーガイド』の「 AWS DMS イベント通知の使用」を参照してください。

Required: No

Type: List of String values

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

SnsTopicArn

イベント通知の送信先の Amazon SNS トピックの Amazon リソースネーム (ARN)。

Required: Yes

Type: String

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

SourceIds

AWS DMS が通知イベントを提供する ID のリスト。

値を指定しないと、すべてのソースについて通知が提供されます。複数の値を指定した場合、タイプが同じである必要があります。たとえば、データベースインスタンス ID を指定した場合は、他のすべての値もデータベースインスタンス ID である必要があります。

Required: No

Type: List of String values

更新に伴う要件: 置換

SourceType

AWS DMS で通知イベントを提供するソースのタイプ。たとえば、データベースインスタンスが生成したイベントの通知を受ける必要がある場合は、このパラメーターを replication-instance に設定します。値を指定しないと、すべてのソースタイプの通知が提供されます。有効な値については、「CreateEventSubscription」アクションの SourceType パラメータ (AWS Database Migration Service API Reference) を参照してください。

Required: Conditional。SourceIds または EventCategories プロパティを指定する場合は、このプロパティを指定する必要があります。

Type: String

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

SubscriptionName

サブスクリプションの名前。

値を指定しない場合は、ランダムな値が作成されます。

Required: No

Type: List of String values

更新に伴う要件: 置換

Tags

ユーザーが DMS イベントサブスクリプションにアタッチするタグ。

Required: No

タイプ: キーと値の形式の「リソースタグ」のリスト。

更新に伴う要件: 置換

戻り値

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

Copy
{ "Ref": "myEventSubscription" }

論理 ID (myEventSubscription) を持つリソースの場合は、Ref より AWS DMS イベントサブスクリプションの名前 (例: mystack-myEventSubscription-1DDYF1E3B3I) が返ります。

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

次のスニペットは、既存のレプリケーションインスタンス (rep-instance-1) のイベントサブスクリプションを作成します。これは、同じテンプレートの他の箇所で宣言されています。

JSON

Copy
{ "AWSTemplateFormatVersion": "2010-09-09", "Resources": { "myEventSubscription": { "Type": "AWS::DMS::EventSubscription", "Properties": { "EventCategories": [ "configuration change", "failure", "deletion" ], "SnsTopicArn": "arn:aws:sns:us-west-2:123456789012:example-topic", "SourceIds": [ "rep-instance-1" ], "SourceType": "replication-instance", "Enabled": false } } } }

YAML

Copy
AWSTemplateFormatVersion: 2010-09-09 Resources: myEventSubscription: Type: 'AWS::DMS::EventSubscription' Properties: EventCategories: - configuration change - failure - deletion SnsTopicArn: 'arn:aws:sns:us-west-2:123456789012:example-topic' SourceIds: - rep-instance-1 SourceType: replication-instance Enabled: false

このページの内容: