任務執行 - AWS Glue

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

任務執行

「工作執行」API 描述資料類型,以及API與啟動、停止或檢視工作執行以及重設工作書籤相關的資料類型, AWS Glue。 Job 流程和作業執行可存取 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 工作室腳本編輯器。

    • VISUAL-工作是使用 AWS Glue 工作室視覺編輯器。

    • NOTEBOOK-工作是使用互動式工作階段筆記本建立的。

    JobMode欄位遺失或為 null 時,SCRIPT會指派為預設值。

  • JobRunQueuingEnabled – 布林值。

    指定是否為工作執行啟用工作執行佇列。

    true 值表示已為工作執行啟用工作執行佇列。如果為 false 或未填入,則不會將工作執行視為佇列。

  • StartedOn – 時間戳記。

    此次任務執行開始的日期和時間。

  • LastModifiedOn – 時間戳記。

    此次任務執行上次修改的時間。

  • CompletedOn – 時間戳記。

    此次任務執行完成的日期和時間。

  • JobRunState-UTF -8 字符串(有效值:STARTINGRUNNINGSTOPPING| STOPPED | SUCCEEDED | FAILED | TIMEOUT | ERROR | WAITING |EXPIRED)。

    任務執行目前的狀態。如需有關異常終止之工作狀態的詳細資訊,請參閱 AWS Glue Job 執行狀態

  • Arguments – 金鑰值對的映射陣列。

    每個鍵是 UTF -8 個字符串。

    每個值都是 UTF -8 個字串。

    與此次執行相關的任務引數。處理此任務執行時,這些引數會取代任務定義本身已設定的預設引數。

    您可以在這裡指定自己的工作執行腳本消耗的參數,以及參數 AWS Glue 本身消耗。

    可以記錄任務引數。不要將純文字袐密當做引數傳遞。從一個檢索密碼 AWS Glue 連接, AWS Secrets Manager 或其他秘密管理機制(如果您打算將其保留在 Job 中)。

    如需如何指定和使用自己的 Job 引數的詳細資訊,請參閱呼叫 AWS Glue APIs在開發人員指南中的 Python 主題中。

    如需設定 Spark 工作時可提供給此欄位之引數的相關資訊,請參閱使用的特殊參數 AWS Glue開發人員指南中的主題。

    如需有關設定 Ray 任務時可提供給此欄位之引數的資訊,請參閱開發人員指南中的 Using job parameters in Ray jobs

  • ErrorMessage— UTF -8 個字符串。

    與此次任務執行相關的錯誤訊息。

  • PredecessorRuns – 一個 前置任務 物件陣列。

    此次任務執行的前置任務的清單。

  • AllocatedCapacity – 數字 (整數)。

    此欄位已作廢。請改用 MaxCapacity

    的數量 AWS Glue 配置給此的資料處理單元 (DPUs) JobRun。DPUs可以分配從 2 到 100;默認值為 10。A DPU 是處理能力的相對度量,由 4 vCPUs 個運算容量和 16 GB 的記憶體組成。如需詳細資訊,請參閱 AWS Glue 定價頁面

  • ExecutionTime – 數字 (整數)。

    任務執行消耗資源所需的時間 (以秒為單位)。

  • Timeout – 數字 (整數),至少為 1。

    JobRun 逾時 (以分鐘為單位)。此為任務執行在停止並進入 TIMEOUT 狀態前可以消耗資源的最大時間。此值會覆寫父任務所設的逾時值。

    串流工作的逾時值必須小於 7 天或 10080 分鐘。當值保留空白時,如果您尚未設定維護時段,工作將在 7 天後重新啟動。如果您已設定維護時段,則維護時段將在 7 天後重新啟動。

  • MaxCapacity – 數字 (雙位數)。

    對於 Glue 1.0 版或更早版本的工作,使用標準工作者類型的數目 AWS Glue 執行此工作時可配置的資料處理單元 (DPUs)。A DPU 是處理能力的相對度量,由 4 vCPUs 個運算容量和 16 GB 的記憶體組成。如需詳細資訊,請參閱 AWS Glue 定價頁面

    對於 Glue 2.0+ 版任務,您不能指定 Maximum capacity。反之,您必須指定 Worker typeNumber of workers

    如果使用 WorkerTypeNumberOfWorkers,請勿設定 MaxCapacity

    可以分配的值MaxCapacity取決於您是否正在執行 Python 命令介面工作、Apache 星火ETL工作或 Apache 星火串流ETL工作:

    • 當你指定一個 Python 外殼作業(JobCommand.Name=「蟒蛇殼」),你可以分配 0.0625 或 1。DPU預設值為 0.0625 DPU。

    • 當您指定一個阿帕奇星火ETL作業(JobCommand.Name=「膠水」)或 Apache 星火流ETL作業(JobCommand.Name=「膠流」),您可以從 2 分配到 100。DPUs預設值為 10 DPUs。此工作類型不能有分數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背景工作類型,每個 Worker 會對應至具有 84GB 磁碟 DPU (約 34GB 可用空間) 的 1 (4 vCPUs ,116 GB 記憶體),並為每個背景工作者提供 1 個執行程式。我們建議將此工作者類型用於資料轉換、聯結和查詢等工作負載,以提供可擴展且符合成本效益的方式來執行大部分任務。

    • 對於G.2X背景工作類型,每個背景工作會對應至具有 128GB 磁碟 DPU (大約可用 77GB) 的 2 個 (8 vCPUs、32 GB 記憶體),並提供每個背景工作者 1 個執行程式。我們建議將此工作者類型用於資料轉換、聯結和查詢等工作負載,以提供可擴展且符合成本效益的方式來執行大部分任務。

    • 對於G.4X背景工作類型,每個工作站都會對應至 4 個 DPU (16 vCPUs、64 GB 記憶體),其中包含 256GB 磁碟 (約 235GB 可用空間),並為每位工作者提供 1 個執行程式。我們建議工作負載包含最嚴苛轉換、彙總、聯結和查詢的任務採用這種工作者類型。此 Worker 類型僅適用於 AWS Glue 3.0 版或更高版本的星火ETL工作在以下 AWS 區域:美國東部 (俄亥俄)、美國東部 (維吉尼亞北部)、美國西部 (奧勒岡)、亞太區域 (新加坡)、亞太區域 (雪梨)、亞太區域 (東京)、加拿大 (中部)、歐洲 (法蘭克福)、歐洲 (愛爾蘭) 及歐洲 (斯德哥爾摩)。

    • 對於G.8X背景工作類型,每個工作站都會對應至 8 個 DPU (32 vCPUs、128 GB 記憶體) 與 512GB 磁碟 (大約可用 487GB),並為每個背景工作者提供 1 個執行程式。我們建議工作負載包含最嚴苛轉換、彙總、聯結和查詢的任務採用這種工作者類型。此 Worker 類型僅適用於 AWS Glue 3.0 版或更高版本的星火ETL作業,在相同 AWS G.4XWorker 類型支援的區域。

    • 對於G.025X背景工作類型,每個 Worker 會對應至具有 84GB 磁碟 DPU (約 34GB 可用空間) 的 0.25 (2 vCPUs、4 GB 記憶體),並為每個背景工作者提供 1 個執行程式。我們建議低容量串流任務採用這種工作者類型。此 Worker 類型僅適用於 AWS Glue 版本 3.0 流式作業。

    • 對於Z.2X工作者類型,每個 Worker 都會對應至具有 128 GB 磁碟 DPU (約 120GB 可用) 的 2 M-(8 vCPUs、64 GB 記憶體),並根據自動配置器提供最多 8 個射線工作者。

  • NumberOfWorkers – 數字 (整數)。

    當任務執行時所配置的已定義 workerType 的工作者數目。

  • SecurityConfiguration— UTF -8 個字串,長度不小於 1 或超過 255 個位元組,符合Single-line string pattern.

    可與此任務執行搭配使用的 SecurityConfiguration 結構名稱。

  • LogGroupName— UTF -8 個字符串。

    安全日誌記錄的日誌群組名稱,可在 Amazon 中 CloudWatch 使用以下方式進行伺服器端加密 AWS KMS。 此名稱可以是/aws-glue/jobs/,在此情況下,預設加密為NONE。若您新增角色名稱及 SecurityConfiguration 名稱 (即 /aws-glue/jobs-yourRoleName-yourSecurityConfigurationName/),則該安全組態將用於加密此日誌群組。

  • NotificationPropertyNotificationProperty 物件。

    指定任務執行通知的組態屬性。

  • GlueVersion— UTF -8 個字串,長度不小於 1 或超過 255 個位元組,符合Custom string pattern #20.

    在星火作業,GlueVersion確定阿帕奇星火和 Python 的版本, AWS Glue 可在工作中使用。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.2XG.025XWorker 為 0.25)。此值可能不同於 Auto Scaling 任務案例中的 executionEngineRuntime * MaxCapacity,因為在給定時間執行的執行程序數量可能少於 MaxCapacity。因此,DPUSeconds 的值有可能小於 executionEngineRuntime * MaxCapacity

  • ExecutionClass— UTF -8 個字串,長度不超過 16 個位元組 (有效值:FLEX=""|STANDARD="")。

    表示任務執行使用的是標準執行類別還是彈性執行類別。標準執行類別非常適合需要快速的任務啟動和專用資源的時間敏感型工作負載。

    彈性執行類別適用於開始和完成時間可能會有所變化的時間敏感型任務。

    只有工作 AWS Glue 3.0 及更高版本和命令類型glueetl將被允許設置ExecutionClassFLEX。彈性執行類別可用於 Spark 任務。

  • MaintenanceWindow-UTF -8 字符串,匹配Custom string pattern #30.

    此欄位指定串流工作的維護時段的星期幾和小時。 AWS Glue 定期執行維護活動。在這些維護期間, AWS Glue 將需要重新啟動您的串流作業。

    AWS Glue 將在指定維護時間的 3 小時內重新啟動工作。例如,如果您在星期一上午 10:00 設定維護時段GMT,您的作業將在上午 10:00 GMT 到下午 1:00 之間重新啟動GMT。

  • ProfileName— UTF -8 個字串,長度不小於 1 或超過 255 個位元組,符合Single-line string pattern.

    一個名字 AWS Glue 與工作執行相關聯的使用情況設定檔。

  • StateDetail-UTF -8 個字符串,長度不超過 40 萬字節。

    此欄位包含與工作執行狀態有關的詳細資訊。此欄位可為空。

    例如,當工作執行因工作執行佇列而處於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

  • ErrorDetailErrorDetail 物件。

    指定關於所發生錯誤的詳細資訊。

NotificationProperty 結構

指定通知的組態屬性。

欄位
  • NotifyDelayAfter – 數字 (整數),至少為 1。

    任務執行開始後,在傳送任務執行延遲通知之前所要等待的分鐘數。

作業

StartJobRun 行動(Python:開始工作運行)

使用任務定義開始任務執行。

請求
  • 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 或其他秘密管理機制(如果您打算將其保留在 Job 中)。

    如需如何指定和使用自己的 Job 引數的詳細資訊,請參閱呼叫 AWS Glue APIs在開發人員指南中的 Python 主題中。

    如需設定 Spark 工作時可提供給此欄位之引數的相關資訊,請參閱使用的特殊參數 AWS Glue開發人員指南中的主題。

    如需有關設定 Ray 任務時可提供給此欄位之引數的資訊,請參閱開發人員指南中的 Using job parameters in Ray jobs

  • AllocatedCapacity – 數字 (整數)。

    此欄位已作廢。請改用 MaxCapacity

    的數量 AWS Glue 數據處理單元(DPUs)分配給此 JobRun。您最少可以配置 2DPUs;預設值為 10。A DPU 是處理能力的相對度量,由 4 vCPUs 個運算容量和 16 GB 的記憶體組成。如需詳細資訊,請參閱 AWS Glue 定價頁面

  • Timeout – 數字 (整數),至少為 1。

    JobRun 逾時 (以分鐘為單位)。此為任務執行在停止並進入 TIMEOUT 狀態前可以消耗資源的最大時間。此值會覆寫父任務所設的逾時值。

    串流工作的逾時值必須小於 7 天或 10080 分鐘。當值保留空白時,如果您尚未設定維護時段,工作將在 7 天後重新啟動。如果您已設定維護時段,則維護時段將在 7 天後重新啟動。

  • MaxCapacity – 數字 (雙位數)。

    對於 Glue 1.0 版或更早版本的工作,使用標準工作者類型的數目 AWS Glue 執行此工作時可配置的資料處理單元 (DPUs)。A DPU 是處理能力的相對度量,由 4 vCPUs 個運算容量和 16 GB 的記憶體組成。如需詳細資訊,請參閱 AWS Glue 定價頁面

    對於 Glue 2.0+ 版任務,您不能指定 Maximum capacity。反之,您必須指定 Worker typeNumber of workers

    如果使用 WorkerTypeNumberOfWorkers,請勿設定 MaxCapacity

    可以分配的值MaxCapacity取決於您是否正在執行 Python 命令介面工作、Apache 星火ETL工作或 Apache 星火串流ETL工作:

    • 當你指定一個 Python 外殼作業(JobCommand.Name=「蟒蛇殼」),你可以分配 0.0625 或 1。DPU預設值為 0.0625 DPU。

    • 當您指定一個阿帕奇星火ETL作業(JobCommand.Name=「膠水」)或 Apache 星火流ETL作業(JobCommand.Name=「膠流」),您可以從 2 分配到 100。DPUs預設值為 10 DPUs。此工作類型不能有分數DPU配置。

  • SecurityConfiguration— UTF -8 個字串,長度不小於 1 或超過 255 個位元組,符合Single-line string pattern.

    可與此任務執行搭配使用的 SecurityConfiguration 結構名稱。

  • NotificationPropertyNotificationProperty 物件。

    指定任務執行通知的組態屬性。

  • 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背景工作類型,每個 Worker 會對應至具有 84GB 磁碟 DPU (約 34GB 可用空間) 的 1 (4 vCPUs ,116 GB 記憶體),並為每個背景工作者提供 1 個執行程式。我們建議將此工作者類型用於資料轉換、聯結和查詢等工作負載,以提供可擴展且符合成本效益的方式來執行大部分任務。

    • 對於G.2X背景工作類型,每個背景工作會對應至具有 128GB 磁碟 DPU (大約可用 77GB) 的 2 個 (8 vCPUs、32 GB 記憶體),並提供每個背景工作者 1 個執行程式。我們建議將此工作者類型用於資料轉換、聯結和查詢等工作負載,以提供可擴展且符合成本效益的方式來執行大部分任務。

    • 對於G.4X背景工作類型,每個工作站都會對應至 4 個 DPU (16 vCPUs、64 GB 記憶體),其中包含 256GB 磁碟 (約 235GB 可用空間),並為每位工作者提供 1 個執行程式。我們建議工作負載包含最嚴苛轉換、彙總、聯結和查詢的任務採用這種工作者類型。此 Worker 類型僅適用於 AWS Glue 3.0 版或更高版本的星火ETL工作在以下 AWS 區域:美國東部 (俄亥俄)、美國東部 (維吉尼亞北部)、美國西部 (奧勒岡)、亞太區域 (新加坡)、亞太區域 (雪梨)、亞太區域 (東京)、加拿大 (中部)、歐洲 (法蘭克福)、歐洲 (愛爾蘭) 及歐洲 (斯德哥爾摩)。

    • 對於G.8X背景工作類型,每個工作站都會對應至 8 個 DPU (32 vCPUs、128 GB 記憶體) 與 512GB 磁碟 (大約可用 487GB),並為每個背景工作者提供 1 個執行程式。我們建議工作負載包含最嚴苛轉換、彙總、聯結和查詢的任務採用這種工作者類型。此 Worker 類型僅適用於 AWS Glue 3.0 版或更高版本的星火ETL作業,在相同 AWS G.4XWorker 類型支援的區域。

    • 對於G.025X背景工作類型,每個 Worker 會對應至具有 84GB 磁碟 DPU (約 34GB 可用空間) 的 0.25 (2 vCPUs、4 GB 記憶體),並為每個背景工作者提供 1 個執行程式。我們建議低容量串流任務採用這種工作者類型。此 Worker 類型僅適用於 AWS Glue 版本 3.0 流式作業。

    • 對於Z.2X工作者類型,每個 Worker 都會對應至具有 128 GB 磁碟 DPU (約 120GB 可用) 的 2 M-(8 vCPUs、64 GB 記憶體),並根據自動配置器提供最多 8 個射線工作者。

  • NumberOfWorkers – 數字 (整數)。

    當任務執行時所配置的已定義 workerType 的工作者數目。

  • ExecutionClass— UTF -8 個字串,長度不超過 16 個位元組 (有效值:FLEX=""|STANDARD="")。

    表示任務執行使用的是標準執行類別還是彈性執行類別。標準執行類別非常適合需要快速的任務啟動和專用資源的時間敏感型工作負載。

    彈性執行類別適用於開始和完成時間可能會有所變化的時間敏感型任務。

    只有工作 AWS Glue 3.0 及更高版本和命令類型glueetl將被允許設置ExecutionClassFLEX。彈性執行類別可用於 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:批處理停工運行)

針對指定的任務定義停止一個或多個任務執行作業。

請求
  • JobName必要:UTF-8 個字串,長度不小於 1 或超過 255 個位元組,符合Single-line string pattern.

    用於停止任務執行的任務定義的名稱。

  • JobRunIds必要:UTF-8 個字串的陣列,不小於 1 或多於 25 個字串。

    因該項任務定義而應停止的 JobRunIds 清單。

回應
  • SuccessfulSubmissions – 一個 BatchStopJobRunSuccessfulSubmission 物件陣列。

    已成功提交以 JobRuns 供停止的清單。

  • Errors – 一個 BatchStopJobRunError 物件陣列。

    在嘗試停止 JobRuns 時所發生錯誤的清單,包括針對每項錯誤列出的 JobRunId,以及關於錯誤的詳細資訊。

錯誤
  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

GetJobRun 行動(Python:獲取工作運行)

擷取特定任務執行作業的中繼資料。Job 流程和作業執行可存取 90 天的工作執行歷程記錄。

請求
  • JobName必要:UTF-8 個字串,長度不小於 1 或超過 255 個位元組,符合Single-line string pattern.

    正在執行的任務定義的名稱。

  • RunId必要:UTF-8 個字串,長度不小於 1 或超過 255 個位元組,符合Single-line string pattern.

    此次任務執行的 ID。

  • PredecessorsIncluded – 布林值。

    如果應傳回前置任務執行作業的清單,則此值為 true。

回應
  • JobRunJobRun 物件。

    所要求任務執行作業的中繼資料。

錯誤
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

GetJobRuns 行動(Python:獲取工作運行)

擷取特定任務定義所有執行作業的中繼資料。

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:獲取工作書籤)

傳回任務書籤項目的資訊。

如需有關啟用和使用任務書籤的詳細資訊,請參閱:

請求
  • JobName必要:UTF-8 個字串。

    正在討論的任務的名稱。

  • Version – 數字 (整數)。

    任務的版本。

  • RunId— UTF -8 個字符串。

    與此任務執行相關聯的唯一執行識別符。

回應
  • JobBookmarkEntryJobBookmarkEntry 物件。

    一種結構,定義任務可繼續處理的點。

錯誤
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • ValidationException

GetJobBookmarks 行動(Python:獲取工作書籤)

傳回任務書籤項目的資訊。此清單是按照遞減的版本號碼排序的。

如需有關啟用和使用任務書籤的詳細資訊,請參閱:

請求
  • JobName必要:UTF-8 個字串。

    正在討論的任務的名稱。

  • MaxResults – 數字 (整數)。

    回應的大小上限。

  • NextToken – 數字 (整數)。

    接續符記,如果這是接續呼叫。

回應
  • JobBookmarkEntries – 一個 JobBookmarkEntry 物件陣列。

    任務書籤項目的清單,定義工作可以繼續處理的點。

  • NextToken – 數字 (整數)。

    接續符記,如果傳回所有項目,其值為 1;如果沒有傳回所有請求的任務執行,則傳回 > 1 的值。

錯誤
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

ResetJobBookmark 行動(Python:重置工作書籤)

重設書籤項目。

如需有關啟用和使用任務書籤的詳細資訊,請參閱:

請求
  • JobName必要:UTF-8 個字串。

    正在討論的任務的名稱。

  • RunId— UTF -8 個字符串。

    與此任務執行相關聯的唯一執行識別符。

回應
錯誤
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException