本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
任務執行
Jobs Runs API 說明啟動、停止或檢視任務執行,以及重設任務書籤的相關資料類型和 API AWS Glue。您的工作流程和任務執行可存取任務執行歷史記錄 90 天。
資料類型
JobRun 結構
包含關於任務執行的資訊。
欄位
-
Id
– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,需符合Single-line string pattern。此次任務執行的 ID。
-
Attempt
– 數字 (整數)。嘗試執行此項任務的次數。
-
PreviousRunId
– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,需符合Single-line string pattern。此任務先前執行作業的 ID。例如,使用
StartJobRun
動作所指定的JobRunId
。 -
TriggerName
– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,需符合Single-line string pattern。起始此次任務執行的觸發條件的名稱。
-
JobName
– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,需符合Single-line string pattern。此次執行所用的任務定義名稱。
-
JobMode
– UTF-8 字串 (有效值:SCRIPT=""
|VISUAL=""
|NOTEBOOK=""
)。描述如何建立任務的模式。有效的 值如下:
-
SCRIPT
- 任務是使用 AWS Glue Studio 指令碼編輯器建立的。 -
VISUAL
- 任務是使用 AWS Glue Studio 視覺化編輯器建立的。 -
NOTEBOOK
- 任務是使用互動式工作階段筆記本建立的。
當
JobMode
欄位遺失或 null 時,SCRIPT
會指派為預設值。 -
-
JobRunQueuingEnabled
– 布林值。指定任務執行是否已啟用任務執行佇列。
true 值表示任務執行已啟用任務執行佇列。如果為 false 或未填入,將不會考慮將任務執行排入佇列。
-
StartedOn
– 時間戳記。此次任務執行開始的日期和時間。
-
LastModifiedOn
– 時間戳記。此次任務執行上次修改的時間。
-
CompletedOn
– 時間戳記。此次任務執行完成的日期和時間。
-
JobRunState
– UTF-8 字串 (有效值:STARTING
|RUNNING
|STOPPING
|STOPPED
|SUCCEEDED
|FAILED
|TIMEOUT
|ERROR
|WAITING
|EXPIRED
)。任務執行目前的狀態。如需異常終止之任務狀態的詳細資訊,請參閱 AWS Glue 任務執行狀態。
-
Arguments
– 金鑰值對的映射陣列。每個金鑰都是 UTF-8 字串。
每個值都是 UTF-8 字串。
與此次執行相關的任務引數。處理此任務執行時,這些引數會取代任務定義本身已設定的預設引數。
您可以在此指定您自己的任務執行指令碼使用的引數,以及 AWS Glue 本身使用的引數。
可以記錄任務引數。不要將純文字袐密當做引數傳遞。如果您想要將秘密保留在任務中,請從 AWS Glue 連線 AWS Secrets Manager 或其他秘密管理機制擷取秘密。
如需如何指定和取用自有任務引數的資訊,請參閱本開發人員指南中的使用 Python 呼叫 AWS Glue API 主題。
如需有關設定 Spark 任務時可提供給此欄位之引數的資訊,請參閱開發人員指南中的 Special Parameters Used by AWS Glue 主題。
如需有關設定 Ray 任務時可提供給此欄位之引數的資訊,請參閱開發人員指南中的 Using job parameters in Ray jobs。
-
ErrorMessage
– UTF-8 字串。與此次任務執行相關的錯誤訊息。
-
PredecessorRuns
– 一個 前置任務 物件陣列。此次任務執行的前置任務的清單。
-
AllocatedCapacity
– 數字 (整數)。此欄位已作廢。請改用
MaxCapacity
。配置到此 JobRun 的 AWS Glue 資料處理單位 (DPU) 數量。 DPUs 可分配 2 到 100 DPU,預設值為 10。DPU 是相對的處理能力,包含 4 個 vCPU 的運算容量和 16 GB 的記憶體。如需詳細資訊,請參閱 AWS Glue 定價頁面
。 -
ExecutionTime
– 數字 (整數)。任務執行消耗資源所需的時間 (以秒為單位)。
-
Timeout
– 數字 (整數),至少為 1。JobRun
逾時 (以分鐘為單位)。此為任務執行在停止並進入TIMEOUT
狀態前可以消耗資源的最大時間。此值會覆寫父任務所設的逾時值。任務的逾時值必須少於 7 天或 10080 分鐘。否則,任務將擲回例外狀況。
當值保留空白時,逾時預設為 2880 分鐘。
逾時值大於 7 天的任何現有 AWS Glue 任務將預設為 7 天。例如,如果您已為批次任務指定 20 天的逾時,則會在第 7 天停止。
對於串流任務,如果您已設定維護時段,則會在維護時段 7 天後重新啟動。
-
MaxCapacity
– 數字 (雙位數)。對於 Glue 1.0 版或更早版本的任務,請使用標準工作者類型,也就是此任務執行時可配置的 AWS Glue 資料處理單位 (DPUs) 數量。DPU 是相對的處理能力,包含 4 個 vCPU 的運算容量和 16 GB 的記憶體。如需詳細資訊,請參閱 AWS Glue 定價頁面
。 對於 Glue 2.0+ 版任務,您不能指定
Maximum capacity
。反之,您必須指定Worker type
與Number of workers
。如果使用
WorkerType
和NumberOfWorkers
,請勿設定MaxCapacity
。可配置給
MaxCapacity
的值取決於您執行的是 Python shell 任務、Apache Spark ETL 任務或 Apache Spark Streaming ETL 任務:-
當您指定 Python shell 任務 (
JobCommand.Name
="pythonshell") 時,您可以擇一分配 0.0625 或 1 個 DPU。預設為 0.0625 個 DPU。 -
指定 Apache Spark ETL 任務 (
JobCommand.Name
="glueetl") 或 Apache Spark Streaming ETL 任務 (JobCommand.Name
="gluestreaming") 時,您可以配置 2 到 100 個 DPU。預設值是 10 個 DPU。此任務類型沒有小數的 DPU 分配。
-
-
WorkerType
– UTF-8 字串 (有效值:Standard=""
|G.1X=""
|G.2X=""
|G.025X=""
|G.4X=""
|G.8X=""
|Z.2X=""
)。將在任務執行時分配的預先定義工作者類型。接受 Spark 任務的 G.1X、G.2X、G.4X、G.8X 或 G.025X 值。接受 Ray 任務的 Z.2X 值。
-
對於
G.1X
工作者類型,每個工作者映射到具有 94GB磁碟的 1 個 DPU (4 個 vCPUs,16 GB 記憶體),並為每個工作者提供 1 個執行器。我們建議將此工作者類型用於資料轉換、聯結和查詢等工作負載,以提供可擴展且符合成本效益的方式來執行大部分任務。 -
對於
G.2X
工作者類型,每個工作者對應到具有 138 GB 磁碟的 2 個 DPU (8 個 vCPUs,32 GB 記憶體),並為每個工作者提供 1 個執行器。 138GB 我們建議將此工作者類型用於資料轉換、聯結和查詢等工作負載,以提供可擴展且符合成本效益的方式來執行大部分任務。 -
對於
G.4X
工作者類型,每個工作者映射到具有 256GB 磁碟的 4 個 DPU (16 個 vCPUs、64 GB 記憶體),並為每個工作者提供 1 個執行器。 256GB 我們建議工作負載包含最嚴苛轉換、彙總、聯結和查詢的任務採用這種工作者類型。此工作者類型僅適用於下列 AWS 區域中的 3.0 AWS Glue 版或更新版本 Spark ETL 任務:美國東部 (俄亥俄)、美國東部 (維吉尼亞北部)、美國西部 (奧勒岡)、亞太區域 (新加坡)、亞太區域 (雪梨)、亞太區域 (東京)、加拿大 (中部)、歐洲 (法蘭克福)、歐洲 (愛爾蘭) 和歐洲 (斯德哥爾摩)。 -
對於
G.8X
工作者類型,每個工作者對應到具有 512 GB 磁碟的 8 個 DPU (32 個 vCPUs,512GB 記憶體),並為每個工作者提供 1 個執行器。我們建議工作負載包含最嚴苛轉換、彙總、聯結和查詢的任務採用這種工作者類型。此工作者類型僅適用於 3.0 AWS Glue 版或更新版本的 Spark ETL 任務,適用於與G.4X
工作者類型支援的相同 AWS 區域。 -
對於
G.025X
工作者類型,每個工作者映射到具有 84 GB 磁碟的 0.25 DPU (2 個 vCPUs,4 GB 記憶體),並為每個工作者提供 1 個執行器。 84GB 我們建議低容量串流任務採用這種工作者類型。此工作者類型僅適用於 3.0 AWS Glue 版或更新版本的串流任務。 -
對於
Z.2X
工作者類型,每個工作者對應到具有 128 GB 磁碟的 2 個 M-DPU (8vCPUs、64 GB 記憶體),並根據自動擴展器提供最多 8 個 Ray 工作者。
-
-
NumberOfWorkers
– 數字 (整數)。當任務執行時所配置的已定義
workerType
的工作者數目。 -
SecurityConfiguration
– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,需符合Single-line string pattern。可與此任務執行搭配使用的
SecurityConfiguration
結構名稱。 -
LogGroupName
– UTF-8 字串。用於確保記錄安全的名稱,可以使用 AWS KMS在 Amazon CloudWatch 中進行伺服器端加密。此名稱可為
/aws-glue/jobs/
,在此情況下預設加密為NONE
。若您新增角色名稱及SecurityConfiguration
名稱 (即/aws-glue/jobs-yourRoleName-yourSecurityConfigurationName/
),則該安全組態將用於加密此日誌群組。 -
NotificationProperty
– NotificationProperty 物件。指定任務執行通知的組態屬性。
-
GlueVersion
– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,需符合Custom string pattern #47。在 Spark 任務中,
GlueVersion
會決定任務中 AWS Glue 可用的 Apache Spark 和 Python 版本。Python 版本指示針對 Spark 類型任務支援的版本。Ray 任務應將
GlueVersion
設定為4.0
或更高版本。不過,Ray 任務中可用的 Ray、Python 和其他程式庫的版本由 Job 命令的Runtime
參數決定。如需可用 AWS Glue 版本和對應 Spark 和 Python 版本的詳細資訊,請參閱 開發人員指南中的 Glue 版本。
建立時未指定 Glue 版本的任務,預設為 Glue 0.9。
-
DPUSeconds
– 數字 (雙位數)。此欄位可以針對使用執行類別執行的任務
FLEX
或啟用 Auto Scaling 時設定,並表示每個執行器在任務執行生命週期期間執行的總時間,以秒為單位乘以 DPU 係數 (1 代表G.1X
,2 代表G.2X
,0.25 代表G.025X
工作者)。此值可能不同於 Auto Scaling 任務案例中的executionEngineRuntime
*MaxCapacity
,因為在給定時間執行的執行程序數量可能少於MaxCapacity
。因此,DPUSeconds
的值有可能小於executionEngineRuntime
*MaxCapacity
。 -
ExecutionClass
– UTF-8 字串,長度不可超過 16 個位元組 (有效值:FLEX=""
|STANDARD=""
)。表示任務執行使用的是標準執行類別還是彈性執行類別。標準執行類別非常適合需要快速的任務啟動和專用資源的時間敏感型工作負載。
彈性執行類別適用於開始和完成時間可能會有所變化的時間敏感型任務。
只有 3.0 版及更高 AWS Glue 版本以及命令類型的任務
glueetl
,才能ExecutionClass
設定為FLEX
。彈性執行類別可用於 Spark 任務。 -
MaintenanceWindow
– UTF-8 字串,需符合Custom string pattern #34。此欄位會指定一週中的一天,以及串流任務維護時段的小時。 會 AWS Glue 定期執行維護活動。在這些維護時段期間, AWS Glue 將需要重新啟動串流任務。
AWS Glue 將在指定的維護時段後 3 小時內重新啟動任務。例如,如果您在 GMT 的星期一上午 10:00 設定維護時段,您的任務將在 GMT 的上午 10:00 到下午 1:00 之間重新啟動。
-
ProfileName
– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,需符合Single-line string pattern。與任務執行相關聯的 AWS Glue 用量描述檔名稱。
-
StateDetail
– UTF-8 字串,長度不可超過 400000 個位元組。此欄位會保留與任務執行狀態有關的詳細資訊。欄位為 null 值。
例如,當任務執行因為任務執行佇列而處於 WAITING 狀態時, 欄位具有任務執行處於該狀態的原因。
Predecessor 結構
任務執行,在用來觸發此任務執行的觸發條件的述詞中使用。
欄位
-
JobName
– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,需符合Single-line string pattern。前置任務執行所用的任務定義名稱。
-
RunId
– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,需符合Single-line string pattern。前置任務執行作業的任務執行 ID。
JobBookmarkEntry 結構
定義可供任務繼續處理的位置點。
欄位
-
JobName
– UTF-8 字串。正在討論的任務的名稱。
-
Version
– 數字 (整數)。任務的版本。
-
Run
– 數字 (整數)。執行 ID 編號。
-
Attempt
– 數字 (整數)。嘗試 ID 編號。
-
PreviousRunId
– UTF-8 字串。與之前任務執行相關聯的唯一執行識別符。
-
RunId
– UTF-8 字串。執行 ID 編號。
-
JobBookmark
– UTF-8 字串。書籤本身。
BatchStopJobRunSuccessfulSubmission 結構
記錄停止了指定 JobRun
的成功要求。
欄位
-
JobName
– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,需符合Single-line string pattern。先前停止的任務執行中所用的任務定義名稱。
-
JobRunId
– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,需符合Single-line string pattern。已停止之任務執行的
JobRunId
。
BatchStopJobRunError 結構
記錄在嘗試停止指定的任務執行時所發生的錯誤。
欄位
-
JobName
– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,需符合Single-line string pattern。正在討論的任務執行中所用的任務定義名稱。
-
JobRunId
– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,需符合Single-line string pattern。任務執行有問題的
JobRunId
。 -
ErrorDetail
– ErrorDetail 物件。指定關於所發生錯誤的詳細資訊。
NotificationProperty 結構
指定通知的組態屬性。
欄位
-
NotifyDelayAfter
– 數字 (整數),至少為 1。任務執行開始後,在傳送任務執行延遲通知之前所要等待的分鐘數。
作業
StartJobRun 動作 (Python: start_job_run)
使用任務定義開始任務執行。
請求
-
JobName
– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,且需符合Single-line string pattern。欲使用的任務定義的名稱。
-
JobRunQueuingEnabled
– 布林值。指定任務執行是否已啟用任務執行佇列。
true 值表示任務執行已啟用任務執行佇列。如果為 false 或未填入,將不會考慮將任務執行排入佇列。
-
JobRunId
– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,需符合Single-line string pattern。要重試之先前
JobRun
的 ID。 -
Arguments
– 金鑰值對的映射陣列。每個金鑰都是 UTF-8 字串。
每個值都是 UTF-8 字串。
與此次執行相關的任務引數。處理此任務執行時,這些引數會取代任務定義本身已設定的預設引數。
您可以在此指定您自己的任務執行指令碼使用的引數,以及 AWS Glue 本身使用的引數。
可以記錄任務引數。不要將純文字袐密當做引數傳遞。如果您想要將秘密保留在任務中,請從 AWS Glue 連線 AWS Secrets Manager 或其他秘密管理機制擷取秘密。
如需如何指定和取用自有任務引數的資訊,請參閱本開發人員指南中的使用 Python 呼叫 AWS Glue API 主題。
如需有關設定 Spark 任務時可提供給此欄位之引數的資訊,請參閱開發人員指南中的 Special Parameters Used by AWS Glue 主題。
如需有關設定 Ray 任務時可提供給此欄位之引數的資訊,請參閱開發人員指南中的 Using job parameters in Ray jobs。
-
AllocatedCapacity
– 數字 (整數)。此欄位已作廢。請改用
MaxCapacity
。要配置到此 JobRun 的 AWS Glue 資料處理單位 (DPU) 數量。 DPUs 您可以分配至少 2 個 DPU,預設值為 10。DPU 是相對的處理能力,包含 4 個 vCPU 的運算容量和 16 GB 的記憶體。如需詳細資訊,請參閱 AWS Glue 定價頁面
。 -
Timeout
– 數字 (整數),至少為 1。JobRun
逾時 (以分鐘為單位)。此為任務執行在停止並進入TIMEOUT
狀態前可以消耗資源的最大時間。此值會覆寫父任務所設的逾時值。任務的逾時值必須少於 7 天或 10080 分鐘。否則,任務將擲回例外狀況。
當值保留空白時,逾時預設為 2880 分鐘。
逾時值大於 7 天的任何現有 AWS Glue 任務將預設為 7 天。例如,如果您已為批次任務指定 20 天的逾時,則會在第 7 天停止。
對於串流任務,如果您已設定維護時段,則會在維護時段 7 天後重新啟動。
-
MaxCapacity
– 數字 (雙位數)。對於 Glue 1.0 版或更早版本的任務,請使用標準工作者類型,也就是此任務執行時可配置的 AWS Glue 資料處理單位 (DPUs) 數量。DPU 是相對的處理能力,包含 4 個 vCPU 的運算容量和 16 GB 的記憶體。如需詳細資訊,請參閱 AWS Glue 定價頁面
。 對於 Glue 2.0+ 版任務,您不能指定
Maximum capacity
。反之,您必須指定Worker type
與Number of workers
。如果使用
WorkerType
和NumberOfWorkers
,請勿設定MaxCapacity
。可配置給
MaxCapacity
的值取決於您執行的是 Python shell 任務、Apache Spark ETL 任務或 Apache Spark Streaming ETL 任務:-
當您指定 Python shell 任務 (
JobCommand.Name
="pythonshell") 時,您可以擇一分配 0.0625 或 1 個 DPU。預設為 0.0625 個 DPU。 -
指定 Apache Spark ETL 任務 (
JobCommand.Name
="glueetl") 或 Apache Spark Streaming ETL 任務 (JobCommand.Name
="gluestreaming") 時,您可以配置 2 到 100 個 DPU。預設值是 10 個 DPU。此任務類型沒有小數的 DPU 分配。
-
-
SecurityConfiguration
– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,需符合Single-line string pattern。可與此任務執行搭配使用的
SecurityConfiguration
結構名稱。 -
NotificationProperty
– NotificationProperty 物件。指定任務執行通知的組態屬性。
-
WorkerType
– UTF-8 字串 (有效值:Standard=""
|G.1X=""
|G.2X=""
|G.025X=""
|G.4X=""
|G.8X=""
|Z.2X=""
)。將在任務執行時分配的預先定義工作者類型。接受 Spark 任務的 G.1X、G.2X、G.4X、G.8X 或 G.025X 值。接受 Ray 任務的 Z.2X 值。
-
對於
G.1X
工作者類型,每個工作者映射到具有 94GB磁碟的 1 個 DPU (4 個 vCPUs,16 GB 記憶體),並為每個工作者提供 1 個執行器。我們建議將此工作者類型用於資料轉換、聯結和查詢等工作負載,以提供可擴展且符合成本效益的方式來執行大部分任務。 -
對於
G.2X
工作者類型,每個工作者對應到具有 138 GB 磁碟的 2 個 DPU (8 個 vCPUs,32 GB 記憶體),並為每個工作者提供 1 個執行器。 138GB 我們建議將此工作者類型用於資料轉換、聯結和查詢等工作負載,以提供可擴展且符合成本效益的方式來執行大部分任務。 -
對於
G.4X
工作者類型,每個工作者映射到具有 256GB 磁碟的 4 個 DPU (16 個 vCPUs、64 GB 記憶體),並為每個工作者提供 1 個執行器。 256GB 我們建議工作負載包含最嚴苛轉換、彙總、聯結和查詢的任務採用這種工作者類型。此工作者類型僅適用於下列 AWS 區域中的 3.0 AWS Glue 版或更新版本 Spark ETL 任務:美國東部 (俄亥俄)、美國東部 (維吉尼亞北部)、美國西部 (奧勒岡)、亞太區域 (新加坡)、亞太區域 (雪梨)、亞太區域 (東京)、加拿大 (中部)、歐洲 (法蘭克福)、歐洲 (愛爾蘭) 和歐洲 (斯德哥爾摩)。 -
對於
G.8X
工作者類型,每個工作者對應到具有 512 GB 磁碟的 8 個 DPU (32 個 vCPUs,512GB 記憶體),並為每個工作者提供 1 個執行器。我們建議工作負載包含最嚴苛轉換、彙總、聯結和查詢的任務採用這種工作者類型。此工作者類型僅適用於 3.0 AWS Glue 版或更新版本的 Spark ETL 任務,適用於與G.4X
工作者類型支援的相同 AWS 區域。 -
對於
G.025X
工作者類型,每個工作者映射到具有 84 GB 磁碟的 0.25 DPU (2 個 vCPUs,4 GB 記憶體),並為每個工作者提供 1 個執行器。 84GB 我們建議低容量串流任務採用這種工作者類型。此工作者類型僅適用於 3.0 AWS Glue 版或更新版本的串流任務。 -
對於
Z.2X
工作者類型,每個工作者對應到具有 128 GB 磁碟的 2 個 M-DPU (8vCPUs、64 GB 記憶體),並根據自動擴展器提供最多 8 個 Ray 工作者。
-
-
NumberOfWorkers
– 數字 (整數)。當任務執行時所配置的已定義
workerType
的工作者數目。 -
ExecutionClass
– UTF-8 字串,長度不可超過 16 個位元組 (有效值:FLEX=""
|STANDARD=""
)。表示任務執行使用的是標準執行類別還是彈性執行類別。標準執行類別非常適合需要快速的任務啟動和專用資源的時間敏感型工作負載。
彈性執行類別適用於開始和完成時間可能會有所變化的時間敏感型任務。
只有 3.0 版及更高 AWS Glue 版本以及命令類型的任務
glueetl
,才能ExecutionClass
設定為FLEX
。彈性執行類別可用於 Spark 任務。 -
ProfileName
– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,需符合Single-line string pattern。與任務執行相關聯的 AWS Glue 用量描述檔名稱。
回應
-
JobRunId
– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,需符合Single-line string pattern。指派給此次任務執行的 ID。
錯誤
InvalidInputException
EntityNotFoundException
InternalServiceException
OperationTimeoutException
ResourceNumberLimitExceededException
ConcurrentRunsExceededException
BatchStopJobRun 動作 (Python: batch_stop_job_run)
針對指定的任務定義停止一個或多個任務執行作業。
請求
-
JobName
– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,且需符合Single-line string pattern。用於停止任務執行的任務定義的名稱。
-
JobRunIds
– 必要:UTF-8 字串的陣列,不可小於 1 或超過 25 個字串。因該項任務定義而應停止的
JobRunIds
清單。
回應
-
SuccessfulSubmissions
– 一個 BatchStopJobRunSuccessfulSubmission 物件陣列。已成功提交停用要求的 JobRun 的清單。
-
Errors
– 一個 BatchStopJobRunError 物件陣列。在嘗試停止
JobRuns
時所發生錯誤的清單,包括針對每項錯誤列出的JobRunId
,以及關於錯誤的詳細資訊。
錯誤
InvalidInputException
InternalServiceException
OperationTimeoutException
GetJobRun 動作 (Python: get_job_run)
擷取特定任務執行作業的中繼資料。您的工作流程和任務執行可存取任務執行歷史記錄 90 天。
請求
-
JobName
– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,且需符合Single-line string pattern。正在執行的任務定義的名稱。
-
RunId
– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,且需符合Single-line string pattern。此次任務執行的 ID。
-
PredecessorsIncluded
– 布林值。如果應傳回前置任務執行作業的清單,則此值為 true。
回應
-
JobRun
– JobRun 物件。所要求任務執行作業的中繼資料。
錯誤
InvalidInputException
EntityNotFoundException
InternalServiceException
OperationTimeoutException
GetJobRuns 動作 (Python: get_job_runs)
擷取特定任務定義所有執行作業的中繼資料。
GetJobRuns
會依時間順序傳回任務執行,而最新任務會先傳回。
請求
-
JobName
– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 255 個位元組,且需符合Single-line string pattern。要擷取其所有任務執行作業資料的任務定義的名稱。
-
NextToken
– UTF-8 字串。接續符記,如果這是接續呼叫。
-
MaxResults
– 數字 (整數),不可小於 1 或大於 200。回應的大小上限。
回應
-
JobRuns
– 一個 JobRun 物件陣列。任務執行中繼資料物件的清單。
-
NextToken
– UTF-8 字串。持續符記 (如果尚未傳回所有重新要求的任務執行作業的結果)。
錯誤
InvalidInputException
EntityNotFoundException
InternalServiceException
OperationTimeoutException
GetJobBookmark 動作 (Python: get_job_bookmark)
傳回任務書籤項目的資訊。
如需有關啟用和使用任務書籤的詳細資訊,請參閱:
請求
-
JobName
– 必要:UTF-8 字串。正在討論的任務的名稱。
-
Version
– 數字 (整數)。任務的版本。
-
RunId
– UTF-8 字串。與此任務執行相關聯的唯一執行識別符。
回應
-
JobBookmarkEntry
– JobBookmarkEntry 物件。一種結構,定義任務可繼續處理的點。
錯誤
EntityNotFoundException
InvalidInputException
InternalServiceException
OperationTimeoutException
ValidationException
GetJobBookmarks 動作 (Python: get_job_bookmarks)
傳回任務書籤項目的資訊。此清單是按照遞減的版本號碼排序的。
如需有關啟用和使用任務書籤的詳細資訊,請參閱:
請求
-
JobName
– 必要:UTF-8 字串。正在討論的任務的名稱。
-
MaxResults
– 數字 (整數)。回應的大小上限。
-
NextToken
– 數字 (整數)。接續符記,如果這是接續呼叫。
回應
-
JobBookmarkEntries
– 一個 JobBookmarkEntry 物件陣列。任務書籤項目的清單,定義工作可以繼續處理的點。
-
NextToken
– 數字 (整數)。接續符記,如果傳回所有項目,其值為 1;如果沒有傳回所有請求的任務執行,則傳回 > 1 的值。
錯誤
InvalidInputException
EntityNotFoundException
InternalServiceException
OperationTimeoutException
ResetJobBookmark 動作 (Python: reset_job_bookmark)
重設書籤項目。
如需有關啟用和使用任務書籤的詳細資訊,請參閱:
請求
-
JobName
– 必要:UTF-8 字串。正在討論的任務的名稱。
-
RunId
– UTF-8 字串。與此任務執行相關聯的唯一執行識別符。
回應
-
JobBookmarkEntry
– JobBookmarkEntry 物件。重設的書籤項目。
錯誤
EntityNotFoundException
InvalidInputException
InternalServiceException
OperationTimeoutException