OnSuccess - AWS Serverless Application Model
構文プロパティ例

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

OnSuccess

正常に処理されたイベントの送信先です。

構文

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

YAML

  Destination: String
  Type: String

プロパティ

Destination

送信先リソースの Amazon リソースネーム (ARN) です。

タイプ: 文字列

必須: 条件に応じて異なります

AWS CloudFormation 互換性: このプロパティは、 AWS::Lambda::EventInvokeConfigリソースの OnSuccessプロパティに似ています。SAM は、このプロパティで参照されるリソースにアクセスするために、この関数に関連付けられている自動生成された IAM ロールに必要な許可を追加します。

その他の注意事項： タイプが Lambda/ の場合EventBridge、送信先が必要です。

Type

送信先で参照されるリソースのタイプです。サポートされているタイプは、SQS、SNS、Lambda、EventBridge です。

タイプ: 文字列

必須: いいえ

AWS CloudFormation 互換性: このプロパティは に固有 AWS SAM であり、 AWS CloudFormation 同等のプロパティはありません。

その他の注意点: タイプが SQS/SNS で、Destination プロパティが空白のままになっている場合、SQS/SNS リソースは SAM によって自動生成されます。リソースを参照するには、SQS の場合は <function-logical-id>.DestinationQueue、SNS の場合は <function-logical-id>.DestinationTopic を使用します。タイプが Lambda/ の場合EventBridge、 Destination は必須です。

例

EventInvoke SQS と Lambda の送信先を使用した設定例

この例では、SQS OnSuccess 設定に宛先が指定されていないため、SAM は暗黙的に SQS キューを作成し、必要なアクセス許可を追加します。また、この例では、テンプレートファイルで宣言された Lambda リソースの送信先が OnFailure 設定で指定されているため、SAM はこの Lambda 関数に必要なアクセス許可を追加して、送信先の Lambda 関数を呼び出します。

YAML

EventInvokeConfig:
  DestinationConfig:
    OnSuccess:
      Type: SQS
    OnFailure:
      Type: Lambda
      Destination: !GetAtt DestinationLambda.Arn  # Arn of a Lambda function declared in the template file.

EventInvoke SNS 送信先の設定例

この例では、 OnSuccess 設定のテンプレートファイルで宣言された SNS トピックに Destination が指定されています。

YAML

EventInvokeConfig:
  DestinationConfig:
    OnSuccess:
      Type: SNS
      Destination:
        Ref: DestinationSNS       # Arn of an SNS topic declared in the tempate file