翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# SNS
<a name="sam-property-function-sns"></a>

`SNS` イベントソースタイプを説明するオブジェクトです。

このイベントタイプが設定されていると、SAM は [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html) リソースを生成します。

## 構文
<a name="sam-property-function-sns-syntax"></a>

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

### YAML
<a name="sam-property-function-sns-syntax.yaml"></a>

```
  [FilterPolicy](#sam-function-sns-filterpolicy): {{[SnsFilterPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-filterpolicy)}}
  FilterPolicyScope: {{String}}
  RedrivePolicy: {{Json}}
  [Region](#sam-function-sns-region): {{String}}
  [SqsSubscription](#sam-function-sns-sqssubscription): {{Boolean | SqsSubscriptionObject}}
  [Topic](#sam-function-sns-topic): {{String}}
```

## プロパティ
<a name="sam-property-function-sns-properties"></a>

 `FilterPolicy`   <a name="sam-function-sns-filterpolicy"></a>
サブスクリプションに割り当てられているフィルターポリシー JSON です。詳細については、Amazon Simple Notification Service API リファレンスの「[GetSubscriptionAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html)」を参照してください。  
*タイプ*: [SNSFilterPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-filterpolicy)  
*必須:* いいえ  
*CloudFormation 互換性*: このプロパティは、 `AWS::SNS::Subscription`リソースの `[FilterPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-filterpolicy)`プロパティに直接渡されます。

 `FilterPolicyScope`   <a name="sam-function-sns-filterpolicyscope"></a>
この属性では、次の文字列値のタイプのいずれかを使用してフィルタリング範囲を選択できます。  
+ `MessageAttributes` – フィルターはメッセージ属性に適用されます。
+ `MessageBody` - フィルターはメッセージ本文に適用されます。
*タイプ*: 文字列  
*必須:* いいえ  
*デフォルト*: `MessageAttributes`  
*CloudFormation 互換性*: このプロパティは、 `AWS::SNS::Subscription`リソースの ` [ FilterPolicyScope](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-filterpolicyscope)`プロパティに直接渡されます。

 `RedrivePolicy`   <a name="sam-function-sns-redrivepolicy"></a>
指定すると、指定された Amazon SQS デッドレターキューに配信不能メッセージを送信します。クライアントエラー（例: サブスクライブされたエンドポイントに到達できない）またはサーバーエラー（例: サブスクライブされたエンドポイントに電力を供給するサービスが使用できなくなる）が原因で配信できないメッセージは、詳細な分析や再処理のためにデッドレターキューに保持されます。  
リドライブポリシーとデッドレターキューの詳細については、「*Amazon Simple Queue Service Developer Guide*」の「[Amazon SQS dead-letter queues](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html)」を参照してください。  
型: Json  
*必須:* いいえ  
*CloudFormation 互換性*: このプロパティは、 `AWS::SNS::Subscription`リソースの `[ RedrivePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-redrivepolicy)`プロパティに直接渡されます。

 `Region`   <a name="sam-function-sns-region"></a>
クロスリージョンサブスクリプションの場合に、トピックが格納されるリージョンです。  
リージョンが指定されていない場合、CloudFormation は発信者のリージョンをデフォルトとして使用します。  
*タイプ*: 文字列  
*必須:* いいえ  
*CloudFormation 互換性*: このプロパティは、 `AWS::SNS::Subscription`リソースの `[Region](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-region)`プロパティに直接渡されます。

 `SqsSubscription`   <a name="sam-function-sns-sqssubscription"></a>
このプロパティを true に設定するか、`SqsSubscriptionObject` を指定して SQS キューで SNS トピック通知のバッチ処理を有効にします。このプロパティを `true` に設定することによって新しい SQS キューが作成されますが、`SqsSubscriptionObject` を指定すると既存の SQS キューが使用されます。  
*タイプ*: ブール \| [SqsSubscriptionObject](sam-property-function-sqssubscriptionobject.md)  
*必須:* いいえ  
*CloudFormation 互換性*: このプロパティは に固有 AWS SAM であり、 CloudFormation 同等のものはありません。

 `Topic`   <a name="sam-function-sns-topic"></a>
サブスクライブ先のトピックの ARN です。  
*タイプ*: 文字列  
*必須*: はい  
*CloudFormation 互換性*: このプロパティは、 `AWS::SNS::Subscription`リソースの `[TopicArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#topicarn)`プロパティに直接渡されます。

## 例
<a name="sam-property-function-sns--examples"></a>

### SNS イベントソースの例
<a name="sam-property-function-sns--examples--sns-event-source-example"></a>

SNS イベントソースの例

#### YAML
<a name="sam-property-function-sns--examples--sns-event-source-example--yaml"></a>

```
Events:
  SNSEvent:
    Type: SNS
    Properties:
      Topic: arn:aws:sns:us-east-1:123456789012:my_topic
      SqsSubscription: true
      FilterPolicy:
        store:
          - example_corp
        price_usd:
          - numeric:
              - ">="
              - 100
```