AWS::SNS::Topic - AWS CloudFormation

AWS::SNS::Topic

AWS::SNS::Topic リソースは、通知が発行されるトピックを作成します。

注記

1 人のユーザーは最大 100,000 のトピックを作成できます。

構文

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

JSON

{ "Type" : "AWS::SNS::Topic", "Properties" : { "ContentBasedDeduplication" : Boolean, "DisplayName" : String, "KmsMasterKeyId" : String, "Subscription" : [ Subscription, ... ], "Tags" : [ Tag, ... ], "TopicName" : String } }

YAML

Type: AWS::SNS::Topic Properties: ContentBasedDeduplication: Boolean DisplayName: String KmsMasterKeyId: String Subscription: - Subscription Tags: - Tag TopicName: String

プロパティ

ContentBasedDeduplication

現在、AWS CloudFormation ではサポートされていません。

必須: いいえ

タイプ: ブール値

Update requires: No interruption

DisplayName

SMS サブスクリプションで Amazon SNS に使用する表示名。

必須: いいえ

タイプ: 文字列

Update requires: No interruption

KmsMasterKeyId

Amazon SNS 用 AWS マネージドカスタマーマスターキー (CMK) またはカスタム CMK の ID。詳細については、「重要な用語」を参照してください。その他の例については、AWS Key Management Service API リファレンスの「 KeyId 」を参照してください。

このプロパティは server-side-encryption にのみ適用されます。

必須: いいえ

タイプ: 文字列

Update requires: No interruption

Subscription

このトピックの SNS サブスクリプション (エンドポイント)。

必須: いいえ

タイプ: Subscriptionリスト

Update requires: No interruption

Tags

新しいトピックに追加するタグのリスト。

注記

作成時にトピックにタグを付けるには、 sns:CreateTopic および sns:TagResource のアクセス許可が必要です。

必須: いいえ

タイプ: Tag のリスト

Update requires: No interruption

TopicName

作成するトピックの名前。トピック名は大文字および小文字の ASCII 文字、数字、アンダースコア、ハイフン、およびハイフンのみを含み、1~256 文字の長さである必要があります。

名前を指定しない場合、AWS CloudFormation は一意の物理 ID を生成し、その ID をトピック名として使用します。詳細については、Name タイプを参照してください。

重要

名前を指定すると、このリソースの置換が必要な更新はできません。中断が不要であるか、一定の中断が必要な更新であれば、行うことができます。リソースを置き換える必要がある場合は、新しい名前を指定します。

必須: いいえ

タイプ: 文字列

Update requires: Replacement

戻り値

参照番号

このリソースの論理 ID を組み込みの Ref 関数に渡すと、Ref は次を返します: トピック ARN (例: arn:aws:sns:us-east-1:123456789012:mystack-mytopic-NZJ5JSMVGFIE).

For more information about using the Ref function, see Ref.

Fn::GetAtt

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

Fn::GetAtt 組み込み関数の使用方法の詳細については、「Fn::GetAtt」を参照してください。

TopicName

Amazon SNS トピックの名前を返します。

2 つの Amazon SQS キューサブスクリプションを持つ Amazon SNS トピック

JSON

"MySNSTopic" : { "Type" : "AWS::SNS::Topic", "Properties" : { "Subscription" : [{ "Endpoint" : { "Fn::GetAtt" : [ "MyQueue1", "Arn" ] }, "Protocol" : "sqs" }, { "Endpoint" : { "Fn::GetAtt" : [ "MyQueue2", "Arn" ] }, "Protocol" : "sqs" }], "TopicName" : "SampleTopic" } }

YAML

MySNSTopic: Type: AWS::SNS::Topic Properties: Subscription: - Endpoint: Fn::GetAtt: - "MyQueue1" - "Arn" Protocol: "sqs" - Endpoint: Fn::GetAtt: - "MyQueue2" - "Arn" Protocol: "sqs" TopicName: "SampleTopic"

以下の資料も参照してください。