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

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

Schedule

Schedule イベントソースタイプを説明するオブジェクトです。これは、サーバーレス関数をスケジュールに従ってトリガーする Amazon EventBridge ルールのターゲットとして設定します。詳細については、「Amazon EventBridge ユーザーガイド」の「Amazon EventBridge とは」を参照してください。

AWS Serverless Application Model （AWS SAM) は、このイベントタイプが設定されると AWS::Events::Ruleリソースを生成します。

注記

EventBridge では、Amazon EventBridge Scheduler という新しいスケジューリング機能が提供されるようになりました。Amazon EventBridge Scheduler はサーバーレススケジューラで、一元化されたマネージドサービスからタスクを作成、実行、管理できます。EventBridge Scheduler は高度にカスタマイズ可能で、EventBridge のスケジュールルールよりもスケーラビリティが高く、ターゲット API オペレーションと AWS のサービスの範囲が広がります。

スケジュールに従ってターゲットを呼び出すには、EventBridge Scheduler を使用することをお勧めします。 AWS SAM テンプレートでこのイベントソースタイプを定義するには、「」を参照してくださいScheduleV2。

構文

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

YAML

  DeadLetterConfig: DeadLetterConfig
  Description: String
  Enabled: Boolean
  Input: String
  Name: String
  RetryPolicy: RetryPolicy
  Schedule: String
  State: String

プロパティ

DeadLetterConfig

ターゲットの呼び出しに失敗した後で EventBridge がイベントを送信する Amazon Simple Queue Service (Amazon SQS) キューを設定します。呼び出しは、存在しない Lambda 関数にイベントを送信した場合、または Lambda 関数を呼び出すために十分な許可が EventBridge にない場合などに失敗します。詳細については、Amazon EventBridge ユーザーガイドの「Event retry policy and using dead-letter queues」を参照してください。

注記

AWS::Serverless::Function リソースタイプには DeadLetterQueue という同じようなデータ型があります。これは、ターゲット Lambda 関数の呼び出しが成功した後で発生する失敗を処理します。これらのタイプの失敗の例には、Lambda のスロットリングや、Lambda ターゲット関数によって返されるエラーなどがあります。関数の DeadLetterQueue プロパティの詳細については、「AWS Lambda デベロッパーガイド」の「デッドレターキュー」を参照してください。

タイプ: DeadLetterConfig

必須: いいえ

AWS CloudFormation 互換性: このプロパティは、 AWS::Events::Rule Target データ型の DeadLetterConfigプロパティに似ています。このプロパティ AWS SAM のバージョンには、デッドレターキューを作成する場合に備えて AWS SAM 、追加のサブプロパティが含まれています。

Description

ルールの説明です。

型: 文字列

必須: いいえ

AWS CloudFormation 互換性: このプロパティは、 AWS::Events::Ruleリソースの Descriptionプロパティに直接渡されます。

Enabled

ルールが有効かどうかを示します。

ルールを無効にするには、このプロパティを false に設定します。

注記

Enabled プロパティと State プロパティは、両方ではなく、どちらか一方を指定してください。

タイプ: ブール

必須: いいえ

AWS CloudFormation 互換性: このプロパティは、 AWS::Events::Ruleリソースの Stateプロパティに似ています。このプロパティが に設定されている場合true、 は を AWS SAM 渡しENABLED、それ以外の場合は を渡しますDISABLED。

Input

ターゲットに渡された有効な JSON テキストです。このプロパティを使用する場合、イベントテキスト自体からはターゲットに何も渡されません。

型: 文字列

必須: いいえ

AWS CloudFormation 互換性: このプロパティは、 AWS::Events::Rule Targetリソースの Inputプロパティに直接渡されます。

Name

ルールの名前。名前を指定しない場合、 は一意の物理 ID AWS CloudFormation を生成し、その ID をルール名として使用します。

型: 文字列

必須: いいえ

AWS CloudFormation 互換性: このプロパティは、 AWS::Events::Ruleリソースの Nameプロパティに直接渡されます。

RetryPolicy

再試行ポリシーの設定に関する情報が含まれた RetryPolicy オブジェクトです。詳細については、Amazon EventBridge ユーザーガイドの「Event retry policy and using dead-letter queues」を参照してください。

タイプ: RetryPolicy

必須: いいえ

AWS CloudFormation 互換性: このプロパティは、 AWS::Events::Rule Target データ型の RetryPolicyプロパティに直接渡されます。

Schedule

ルールがいつ、どのくらいの頻度で実行されるかを決定するスケジューリング式です。詳細については、「Schedule Expressions for Rules」を参照してください。

型: 文字列

必須: はい

AWS CloudFormation 互換性: このプロパティは、 AWS::Events::Ruleリソースの ScheduleExpressionプロパティに直接渡されます。

State

ルールの状態。

使用できる値: DISABLED | ENABLED

注記

Enabled プロパティと State プロパティは、両方ではなく、どちらか一方を指定してください。

型: 文字列

必須: いいえ

AWS CloudFormation 互換性: このプロパティは、 AWS::Events::Ruleリソースの Stateプロパティに直接渡されます。

例

CloudWatch スケジュールイベント

CloudWatch スケジュールイベントの例

YAML

CWSchedule:
  Type: Schedule
  Properties:
    Schedule: 'rate(1 minute)'
    Name: TestSchedule
    Description: test schedule
    Enabled: false