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

設定 Amazon Simple Queue Service (Amazon SQS) 佇列，EventBridge 會在目標呼叫失敗後傳送事件。例如，將事件傳送至不存在的 Lambda 函數時，或 EventBridge 沒有足夠的許可來叫用 Lambda 函數時，叫用可能會失敗。如需詳細資訊，請參閱《Amazon EventBridge 使用者指南》中的事件重試政策和使用無效字母佇列。

類型：DeadLetterConfig

必要：否

CloudFormation 相容性：此屬性類似於 AWS::Events::RuleTarget資料類型的 DeadLetterConfig 屬性。此屬性的 AWS SAM 版本包含其他子屬性，以防您想要為您 AWS SAM 建立無效字母佇列。

Description

規則的描述。

類型：字串

必要：否

CloudFormation 相容性：此屬性會直接傳遞至 AWS::Events::Rule 資源的 Description 屬性。

Enabled

指出系統是否已啟用規則。

若要停用規則，請將此屬性設為 false。

注意

指定 Enabled或 State 屬性，但不能同時指定兩者。

類型：布林值

必要：否

CloudFormation 相容性：此屬性類似於 AWS::Events::Rule 資源的 State 屬性。如果此屬性設定為 ，true則 AWS SAM 傳遞 ENABLED，否則傳遞 DISABLED。

Input

傳遞到目標的有效 JSON 文字。如果您使用此屬性，事件文字本身不會有任何內容傳遞到目標。

類型：字串

必要：否

CloudFormation 相容性：此屬性會直接傳遞至 AWS::Events::Rule Target 資源的 Input 屬性。

Name

規則的名稱。如果您未指定名稱， CloudFormation 會產生唯一的實體 ID，並將該 ID 用於規則名稱。

類型：字串

必要：否

CloudFormation 相容性：此屬性會直接傳遞至 AWS::Events::Rule 資源的 Name 屬性。

RetryPolicy

包含重試政策設定相關資訊的 RetryPolicy 物件。如需詳細資訊，請參閱《Amazon EventBridge 使用者指南》中的事件重試政策和使用無效字母佇列。

類型：RetryPolicy

必要：否

CloudFormation 相容性：此屬性會直接傳遞至 AWS::Events::Rule Target 資料類型的 RetryPolicy 屬性。

RoleArn

調用排程時，EventBridge Scheduler 用於目標的 IAM 角色 ARN。

類型：RoleArn

必要：否。如果未提供，則會建立新的角色並使用。

CloudFormation 相容性：此屬性會直接傳遞至 AWS::Scheduler::Schedule Target 資料類型的 RoleArn 屬性。

Schedule

判斷何時及執行規則頻率的排程表達式。如需詳細資訊，請參閱規則的排程運算式。

類型：字串

必要：是

CloudFormation 相容性：此屬性會直接傳遞至 AWS::Events::Rule 資源的 ScheduleExpression 屬性。

State

規則的狀態。

接受的值： DISABLED | ENABLED

注意

指定 Enabled或 State 屬性，但不能同時指定兩者。

類型：字串

必要：否

CloudFormation 相容性：此屬性會直接傳遞至 AWS::Events::Rule 資源的 State 屬性。

Target

EventBridge 在觸發規則時呼叫 AWS 的資源。您可以使用此屬性來指定目標的邏輯 ID。如果未指定此屬性，則 AWS SAM 會產生目標的邏輯 ID。

類型：Target

必要：否

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