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

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

Schedule

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

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

構文

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

YAML

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

プロパティ

DeadLetterConfig

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

タイプ: 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プロパティに直接渡されます。

RoleArn

スケジュールが呼び出されたときに EventBridge スケジューラがターゲットとして使用する IAM ロールの ARN。

タイプ: RoleArn

必須:いいえ。指定しない場合、新しいロールが作成されて適用されます。

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

Schedule

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

型: 文字列

必須: はい

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

State

ルールの状態。

使用できる値: DISABLED | ENABLED

注記

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

型: 文字列

必須: いいえ

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

Target

ルールがトリガーされたときに EventBridge が呼び出す AWS リソース。このプロパティを使用して、ターゲットの論理 ID を指定できます。このプロパティが指定されていない場合、 はターゲットの論理 ID AWS SAM を生成します。

タイプ: Target

必須: いいえ

AWS CloudFormation 互換性: このプロパティは、 AWS::Events::Ruleリソースの Targetsプロパティに似ています。このプロパティ AWS SAM のバージョンでは、単一のターゲットの論理 ID のみを指定できます。

例

CloudWatch スケジュールイベント

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

YAML

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