ScheduleV2 - AWS Serverless Application Model
語法屬性範例

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

ScheduleV2

描述ScheduleV2事件來源類型的物件，會將無伺服器函數設定為排程觸發的 Amazon EventBridge 排程器事件的目標。如需詳細資訊，請參閱 EventBridge 排程器使用者指南中的什麼是 Amazon EventBridge 排程器？。 EventBridge

AWS Serverless Application Model (AWS SAM) 會在設定此事件類型時產生AWS::Scheduler::Schedule資源。

語法

若要在 AWS Serverless Application Model (AWS SAM) 範本中宣告此實體，請使用下列語法。

屬性

DeadLetterConfig

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

注意

AWS::Serverless::Function 資源類型具有類似的資料類型 DeadLetterQueue，可處理成功調用目標 Lambda 函數後發生的失敗。這些失敗類型的範例包括 Lambda 調節，或 Lambda 目標函數傳回的錯誤。如需函數DeadLetterQueue屬性的詳細資訊，請參閱《 AWS Lambda 開發人員指南》中的無效字母佇列。

類型：DeadLetterConfig

必要：否

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

Description

排程的描述。

類型：字串

必要：否

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

EndDate

UTC 日期，排程可在此日期之前叫用其目標。視排程的週期運算式而定，叫用可能會在您指定的 EndDate 當天或之前停止。

類型：字串

必要：否

AWS CloudFormation 相容性：此屬性會直接傳遞至 AWS::Scheduler::Schedule 資源的 EndDate 屬性。

FlexibleTimeWindow

允許在其中叫用排程的時段組態。

類型：FlexibleTimeWindow

必要：否

AWS CloudFormation 相容性：此屬性會直接傳遞至 AWS::Scheduler::Schedule 資源的 FlexibleTimeWindow 屬性。

GroupName

要與此排程建立關聯的排程群組名稱。如果未定義，則會使用預設群組。

類型：字串

必要：否

AWS CloudFormation 相容性：此屬性會直接傳遞至 AWS::Scheduler::Schedule 資源的 GroupName 屬性。

Input

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

類型：字串

必要：否

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

KmsKeyArn

KMS 金鑰的 ARN，用於加密客戶資料。

類型：字串

必要：否

AWS CloudFormation 相容性：此屬性會直接傳遞至 AWS::Scheduler::Schedule 資源的 KmsKeyArn 屬性。

Name

排程的名稱。如果您未指定名稱， 會以 格式 AWS SAM 產生名稱Function-Logical-IDEvent-Source-Name，並使用該 ID 做為排程名稱。

類型：字串

必要：否

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

OmitName

根據預設， AWS SAM 會產生並使用 <Function-logical-ID><event-source-name> 格式的排程名稱。將此屬性設定為 true，讓 AWS CloudFormation 產生唯一的實體 ID，並改為將 ID 用於排程名稱。

類型：布林值

必要：否

預設：false

AWS CloudFormation 相容性：此屬性對 是唯一的 AWS SAM ，並且沒有同等 AWS CloudFormation 的。

PermissionsBoundary

用來設定角色許可邊界的政策 ARN。

注意

如果PermissionsBoundary已定義 ， AWS SAM 會將相同的界限套用至排程器排程的目標 IAM 角色。

類型：字串

必要：否

AWS CloudFormation 相容性：此屬性會直接傳遞至 AWS::IAM::Role 資源的 PermissionsBoundary 屬性。

RetryPolicy

包含重試政策設定相關資訊的 RetryPolicy 物件。

類型：RetryPolicy

必要：否

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

RoleArn

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

類型：RoleArn

必要：否

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

ScheduleExpression

排程表達式，可決定排程器排程事件執行的時間和頻率。

類型：字串

必要：是

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

ScheduleExpressionTimezone

計算排程運算式所使用的時區。

類型：字串

必要：否

AWS CloudFormation 相容性：此屬性會直接傳遞至 AWS::Scheduler::Schedule 資源的 ScheduleExpressionTimezone 屬性。

StartDate

排程之後可以開始叫用目標的日期，以 UTC 為單位。視排程的週期運算式而定，叫用可能會在您指定的 StartDate 當天或之後發生。

類型：字串

必要：否

AWS CloudFormation 相容性：此屬性會直接傳遞至 AWS::Scheduler::Schedule 資源的 StartDate 屬性。

State

排程器排程的狀態。

接受的值： DISABLED | ENABLED

類型：字串

必要：否

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

範例

定義 ScheduleV2 資源的基本範例

Resources:
  Function:
    Properties:
      ...
      Events:
        ScheduleEvent:
          Type: ScheduleV2
          Properties:
            ScheduleExpression: "rate(1 minute)"
        ComplexScheduleEvent:
          Type: ScheduleV2
          Properties:
            ScheduleExpression: rate(1 minute)
            FlexibleTimeWindow:
              Mode: FLEXIBLE
              MaximumWindowInMinutes: 5
            StartDate: '2022-12-28T12:00:00.000Z'
            EndDate: '2023-01-28T12:00:00.000Z'
            ScheduleExpressionTimezone: UTC
            RetryPolicy:
              MaximumRetryAttempts: 5
              MaximumEventAgeInSeconds: 300
            DeadLetterConfig:
              Type: SQS
注意

ScheduleV2 產生的實體 ID 不包含堆疊名稱。