本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
觸發
觸發器 API 描述了與中建立、更新或刪除以及啟動和停止工作觸發器相關的資料類型和 API AWS Glue。
資料類型
Trigger 結構
關於特定觸發條件的資訊。
欄位
-
Name– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。觸發條件的名稱。
-
WorkflowName– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。與觸發條件相關聯的工作流程名稱。
-
Id– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。保留以供日後使用。
-
Type– UTF-8 字串 (有效值：SCHEDULED|CONDITIONAL|ON_DEMAND|EVENT)。此處觸發條件的類型。
-
State– UTF-8 字串 (有效值：CREATING|CREATED|ACTIVATING|ACTIVATED|DEACTIVATING|DEACTIVATED|DELETING|UPDATING)。觸發條件目前的狀態。
-
Description– 描述字串，長度不可超過 2048 個位元組，需符合URI address multi-line string pattern。此觸發條件的說明。
-
Schedule– UTF-8 字串。用來指定排程的
cron表達式 (請參閱適用於任務與爬蟲程式的依時排程。例如，如果要每天在 12:15 UTC 執行某項動作，您可以指定：cron(15 12 * * ? *)。 -
Actions– 一個 動作 物件陣列。此觸發條件起始的動作。
-
Predicate– 述詞 物件。此觸發條件的述詞，定義了觸發的時間點。
-
EventBatchingCondition– EventBatching條件 物件。觸發事件觸發之前必須滿足的 Batch 條件 (接收到的指定 EventBridge 事件數或批次時間範圍到期)。
TriggerUpdate 結構
一種結構，用來提供更新觸發條件時所使用的資訊。此物件在更新先前的觸發條件定義時，會完全覆寫掉之前的內容。
欄位
-
Name– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。保留以供日後使用。
-
Description– 描述字串，長度不可超過 2048 個位元組，需符合URI address multi-line string pattern。此觸發條件的說明。
-
Schedule– UTF-8 字串。用來指定排程的
cron表達式 (請參閱適用於任務與爬蟲程式的依時排程。例如，如果要每天在 12:15 UTC 執行某項動作，您可以指定：cron(15 12 * * ? *)。 -
Actions– 一個 動作 物件陣列。此觸發條件起始的動作。
-
Predicate– 述詞 物件。此觸發條件的述詞，定義了觸發的時間點。
-
EventBatchingCondition– EventBatching條件 物件。觸發事件觸發之前必須滿足的 Batch 條件 (接收到的指定 EventBridge 事件數或批次時間範圍到期)。
Predicate 結構
定義觸發條件的述詞，此述詞會決定觸發的時間點。
欄位
-
Logical– UTF-8 字串 (有效值：AND|ANY)。如果只列出一個條件，則為選用欄位。如果列出了多個條件，則此為必要欄位。
-
Conditions– 一個 條件 物件陣列。觸發條件的清單，這些條件決定了觸發的時間點。
Condition 結構
定義觸發的條件。
欄位
-
LogicalOperator– UTF-8 字串 (有效值：EQUALS)。邏輯運算子。
-
JobName– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。任務的名稱，此條件會套用至該任務的
JobRuns，此觸發條件也會等待起始該任務。 -
State— UTF-8 字串 (有效值：STARTINGRUNNING|STOPPING|STOPPED|SUCCEEDED|FAILED|TIMEOUT|ERROR|WAITING|EXPIRED)。條件的狀態。目前，觸發條件可聆聽的任務狀態只有
SUCCEEDED、STOPPED、FAILED和TIMEOUT。觸發條件可聆聽的爬蟲程式狀態只有SUCCEEDED、FAILED和CANCELLED。 -
CrawlerName– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。要套用此條件的爬取程式名稱。
-
CrawlState– UTF-8 字串 (有效值：RUNNING|CANCELLING|CANCELLED|SUCCEEDED|FAILED|ERROR)。要套用此條件的爬取程式狀態。
Action 結構
定義觸發條件要起始的動作。
欄位
-
JobName– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。要執行的任務的名稱。
-
Arguments– 金鑰值對的映射陣列。每個金鑰都是 UTF-8 字串。
每個值都是 UTF-8 字串。
此觸發條件觸發時所使用的任務引數。處理此任務執行時，這些引數會取代任務定義本身已設定的預設引數。
您可以在這裡指定自己的工作執行腳本消耗的參數，以及 AWS Glue 本身消耗的參數。
如需如何指定和取用自有任務引數的資訊，請參閱本開發人員指南中的使用 Python 呼叫 AWS Glue API 主題。
如需設定工作所 AWS Glue 耗用之索引鍵值配對的詳細資訊，請參閱開發人員指南中的「使用的特殊參數」 AWS Glue主題。
-
Timeout– 數字 (整數)，至少為 1。JobRun逾時 (以分鐘為單位)。此為任務執行在停止並進入TIMEOUT狀態前可以消耗資源的最大時間。預設值為 2,880 分鐘 (48 小時)。此會覆寫父任務所設的逾時值。 -
SecurityConfiguration– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。可與此動作搭配使用的
SecurityConfiguration結構名稱。 -
NotificationProperty– NotificationProperty 物件。指定任務執行通知的組態屬性。
-
CrawlerName– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。要搭配此動作使用的爬取程式名稱。
EventBatchingCondition 結構
觸發事件觸發之前必須滿足的 Batch 條件 (接收到的指定 EventBridge 事件數或批次時間範圍到期)。
欄位
-
BatchSize– 必要：數字 (整數)，不可小於 1，也不可以大於 100。EventBridge 事件觸發 EventBridge 前必須從 Amazon 接收的事件數目。
-
BatchWindow– 數字 (整數)，不可小於 1，也不可以大於 900。EventBridge 事件觸發器觸發後的時間範圍 (以秒為單位)。時段在接收到第一個事件時啟動。
作業
CreateTrigger 動作（Python：創建觸發器）
建立新的觸發條件。
請求
-
Name– 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。觸發條件的名稱。
-
WorkflowName– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。與觸發條件相關聯的工作流程名稱。
-
Type– 必要：UTF-8 字串 (有效值：SCHEDULED|CONDITIONAL|ON_DEMAND|EVENT)。新觸發條件的類型。
-
Schedule– UTF-8 字串。用來指定排程的
cron表達式 (請參閱適用於任務與爬蟲程式的依時排程。例如，如果要每天在 12:15 UTC 執行某項動作，您可以指定：cron(15 12 * * ? *)。當觸發類型為 SCHEDULED 時，此欄位為必要。
-
Predicate– 述詞 物件。用來指定新觸發條件觸發時間點的述詞。
當觸發類型為
CONDITIONAL時，此欄位為必要。 -
Actions– 必要：一個 動作 物件。此觸發條件觸發時所起始的動作。
-
Description– 描述字串，長度不可超過 2048 個位元組，需符合URI address multi-line string pattern。新觸發條件的說明。
-
StartOnCreation– 布林值。設定
true，即可在建立時啟動SCHEDULED和CONDITIONAL觸發。True 不支援ON_DEMAND觸發。 -
Tags– 金鑰值對的對應陣列，不超過 50 對。每個金鑰均為 UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。
每個值都是 UTF-8 字串，長度不可超過 256 個位元組。
要搭配此觸發條件使用的標籤。您可以使用標籤來限制對於觸發條件的存取情況。如需中標籤的詳細資訊 AWS Glue，請參閱開發人員指南AWS Glue中的「AWS 標籤」。
-
EventBatchingCondition– EventBatching條件 物件。觸發事件觸發之前必須滿足的 Batch 條件 (接收到的指定 EventBridge 事件數或批次時間範圍到期)。
回應
-
Name– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。觸發條件的名稱。
錯誤
AlreadyExistsExceptionEntityNotFoundExceptionInvalidInputExceptionIdempotentParameterMismatchExceptionInternalServiceExceptionOperationTimeoutExceptionResourceNumberLimitExceededExceptionConcurrentModificationException
StartTrigger 行動（Python：啟動觸發器）
啟動現有的觸發條件。請參閱觸發任務，以了解如何啟動不同類型觸發條件的資訊。
請求
-
Name– 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。所要啟動觸發條件的名稱。
回應
-
Name– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。已啟動的觸發條件的名稱。
錯誤
InvalidInputExceptionInternalServiceExceptionEntityNotFoundExceptionOperationTimeoutExceptionResourceNumberLimitExceededExceptionConcurrentRunsExceededException
GetTrigger 行動（Python：獲取觸發器）
擷取觸發條件的定義。
請求
-
Name– 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。要擷取的觸發條件的名稱。
回應
-
Trigger– 觸發條件 物件。要求的觸發條件定義。
錯誤
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutException
GetTriggers 行動（Python：獲取觸發器）
取得與任務相關的所有觸發條件。
請求
-
NextToken– UTF-8 字串。接續符記，如果這是接續呼叫。
-
DependentJobName– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。擷取觸發之任務的名稱。將會傳回可起始此項任務的觸發條件，如果沒有此等觸發條件，將傳回所有的觸發條件。
-
MaxResults— 數字 (整數)，不小於 1 或大於 200。回應的大小上限。
回應
-
Triggers– 一個 觸發條件 物件陣列。指定任務適用的觸發條件的清單。
-
NextToken– UTF-8 字串。持續符記 (如果尚未傳回所有要求的觸發條件)。
錯誤
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutException
UpdateTrigger 行動（Python：更新觸發器）
更新觸發定義。
請求
-
Name– 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。所要更新觸發條件的名稱。
-
TriggerUpdate– 必要：TriggerUpdate 物件。新的值，用來更新觸發條件。
回應
-
Trigger– 觸發條件 物件。產生的觸發條件定義。
錯誤
InvalidInputExceptionInternalServiceExceptionEntityNotFoundExceptionOperationTimeoutExceptionConcurrentModificationException
StopTrigger 行動（Python：停止觸發器）
停止指定的觸發條件。
請求
-
Name– 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。所要停止的觸發條件的名稱。
回應
-
Name– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。已停止的觸發條件的名稱。
錯誤
InvalidInputExceptionInternalServiceExceptionEntityNotFoundExceptionOperationTimeoutExceptionConcurrentModificationException
DeleteTrigger 動作（Python：刪除觸發器）
刪除指定的觸發條件。如果找不到此觸發條件，就不會拋出例外狀況。
請求
-
Name– 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。所要刪除的觸發條件的名稱。
回應
-
Name– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。已刪除的觸發條件的名稱。
錯誤
InvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionConcurrentModificationException
ListTriggers 行動（Python：列表觸發器）
檢索此 AWS 帳戶中所有觸發器資源的名稱，或具有指定標籤的資源。您可運用此操作，查看帳戶下有哪些可用資源及其名稱。
此操作會接收您可在回應時做為篩選條件的選用 Tags 欄位，因此已標記的資源可分組進行擷取。如果您選擇使用標籤進行篩選，則此時只會擷取包含該標籤的資源。
請求
-
NextToken– UTF-8 字串。接續符記，如果這是接續要求。
-
DependentJobName– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。要擷取其觸發條件的工作的名稱。這時會傳回可起始此任務的觸發條件。如果這時沒有這種觸發條件，則會傳回所有的觸發條件。
-
MaxResults— 數字 (整數)，不小於 1 或大於 200。所要回傳清單的大小上限。
-
Tags– 金鑰值對的對應陣列，不超過 50 對。每個金鑰均為 UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。
每個值都是 UTF-8 字串，長度不可超過 256 個位元組。
指定只傳回包含這些標籤的資源。
回應
-
TriggerNames– UTF-8 字串陣列。這個帳戶下所有觸發條件的名稱，或是使用指定標籤的觸發條件。
-
NextToken– UTF-8 字串。接續字元，如果傳回的清單未包含最後一個可用指標。
錯誤
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutException
BatchGetTriggers 行動（Python：批處理觸發器）
為指定的觸發條件名稱清單，傳回資源中繼資料的清單。呼叫 ListTriggers 操作之後，您便可以呼叫此操作來存取您已授與許可的資料。此操作支援所有 IAM 許可，包括使用標籤的許可條件。
請求
-
TriggerNames– 必要：UTF-8 字串陣列。觸發條件名稱清單，可能是從
ListTriggers操作傳回的名稱。
回應
-
Triggers– 一個 觸發條件 物件陣列。觸發條件定義的清單。
-
TriggersNotFound– UTF-8 字串陣列。找不到觸發條件名稱清單。
錯誤
InternalServiceExceptionOperationTimeoutExceptionInvalidInputException
