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

# 任務執行
<a name="aws-glue-api-jobs-runs"></a>

 Jobs Runs API 說明啟動、停止或檢視任務執行，以及重設任務書籤的相關資料類型和 API AWS Glue。您可以存取工作流程和任務執行的 90 天任務執行歷史記錄。

## 資料類型
<a name="aws-glue-api-jobs-runs-objects"></a>
+ [JobRun 結構](#aws-glue-api-jobs-runs-JobRun)
+ [Predecessor 結構](#aws-glue-api-jobs-runs-Predecessor)
+ [JobBookmarkEntry 結構](#aws-glue-api-jobs-runs-JobBookmarkEntry)
+ [BatchStopJobRunSuccessfulSubmission 結構](#aws-glue-api-jobs-runs-BatchStopJobRunSuccessfulSubmission)
+ [BatchStopJobRunError 結構](#aws-glue-api-jobs-runs-BatchStopJobRunError)
+ [NotificationProperty 結構](#aws-glue-api-jobs-runs-NotificationProperty)

## JobRun 結構
<a name="aws-glue-api-jobs-runs-JobRun"></a>

包含關於任務執行的資訊。

**欄位**
+ `Id` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  此次任務執行的 ID。
+ `Attempt` – 數字 (整數)。

  嘗試執行此項任務的次數。
+ `PreviousRunId` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  此任務先前執行作業的 ID。例如，使用 `StartJobRun` 動作所指定的 `JobRunId`。
+ `TriggerName` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  起始此次任務執行的觸發條件的名稱。
+ `JobName` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  此次執行所用的任務定義名稱。
+ `JobMode` – UTF-8 字串 (有效值：`SCRIPT=""` \$1 `VISUAL=""` \$1 `NOTEBOOK=""`)。

  描述如何建立任務的模式。有效的值如下：
  + `SCRIPT` - 任務是使用 AWS Glue Studio 指令碼編輯器建立的。
  + `VISUAL` - 任務是使用 AWS Glue Studio 視覺化編輯器建立的。
  + `NOTEBOOK` - 任務是使用互動式工作階段筆記本建立的。

  當 `JobMode` 欄位遺失或為 null 時， `SCRIPT` 會指派為預設值。
+ `JobRunQueuingEnabled` – 布林值。

  指定任務執行是否已啟用任務執行佇列。

  值為 true 表示已為任務執行啟用任務執行佇列。如果為 false 或未填入，則不會考慮將任務執行排入佇列。
+ `StartedOn` – 時間戳記。

  此次任務執行開始的日期和時間。
+ `LastModifiedOn` – 時間戳記。

  此次任務執行上次修改的時間。
+ `CompletedOn` – 時間戳記。

  此次任務執行完成的日期和時間。
+ `JobRunState` – UTF-8 字串 (有效值：`STARTING` \$1 `RUNNING` \$1 `STOPPING` \$1 `STOPPED` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `TIMEOUT` \$1 `ERROR` \$1 `WAITING` \$1 `EXPIRED`)。

  任務執行目前的狀態。如需異常終止之任務狀態的詳細資訊，請參閱 [AWS Glue 任務執行狀態](https://docs.aws.amazon.com/glue/latest/dg/job-run-statuses.html)。
+ `Arguments` – 金鑰值對的映射陣列。

  每個金鑰都是 UTF-8 字串。

  每個值都是 UTF-8 字串。

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

  您可以在此指定您自己的任務執行指令碼使用的引數，以及 AWS Glue 本身使用的引數。

  可以記錄任務引數。不要將純文字袐密當做引數傳遞。如果您想要將秘密保留在任務中，請從 AWS Glue 連線 AWS Secrets Manager 或其他秘密管理機制擷取秘密。

  如需如何指定和取用自有任務引數的資訊，請參閱本開發人員指南中的[使用 Python 呼叫 AWS Glue API](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) 主題。

  如需有關設定 Spark 任務時可提供給此欄位之引數的資訊，請參閱開發人員指南中的 [Special Parameters Used by AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) 主題。

  如需有關設定 Ray 任務時可提供給此欄位之引數的資訊，請參閱開發人員指南中的 [Using job parameters in Ray jobs](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html)。
+ `ErrorMessage` – UTF-8 字串。

  與此次任務執行相關的錯誤訊息。
+ `PredecessorRuns` – 一個 [前置任務](#aws-glue-api-jobs-runs-Predecessor) 物件陣列。

  此次任務執行的前置任務的清單。
+ `AllocatedCapacity` – 數字 (整數)。

  此欄位已作廢。請改用 `MaxCapacity`。

  分配給此 JobRun 的 AWS Glue 資料處理單位 (DPU) 數量。 DPUs 可分配 2 到 100 DPU，預設值為 10。DPU 是處理能力的相對測量，包含 4 個 vCPUs的運算容量和 16 GB 的記憶體。如需詳細資訊，請參閱 [AWS Glue 定價頁面](https://aws.amazon.com/glue/pricing/)。
+ `ExecutionTime` – 數字 (整數)。

  任務執行消耗資源所需的時間 (以秒為單位)。
+ `Timeout` – 數字 (整數)，至少為 1。

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

  任務的逾時值必須少於 7 天或 10,080 分鐘。否則，任務會擲回例外狀況。

  在值保留空白時，逾時預設為 2,880 分鐘。

  逾時值大於 7 天的任何現有 AWS Glue 任務將預設為 7 天。例如，如果您為批次任務指定了 20 天的逾時，則會在第 7 天停止。

  對於串流任務，如果您已設定維護時段，則會在 7 天後的維護時段期間重新啟動任務。
+ `MaxCapacity` – 數字 (雙位數)。

  對於 Glue 1.0 版或更早版本任務，使用標準工作者類型，此任務執行時可配置的 AWS Glue 資料處理單位 (DPUs) 數量。DPU 是處理能力的相對測量，包含 4 個 vCPUs的運算容量和 16 GB 的記憶體。如需詳細資訊，請參閱 [AWS Glue 定價頁面](https://aws.amazon.com/glue/pricing/)。

  對於 Glue 2.0\$1 版任務，您不能指定 `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=""` \$1 `G.025X=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.4X=""` `G.8X=""` \$1 `G.12X=""` \$1 \$1 `G.16X=""` \$1 `R.1X=""` `R.2X=""` \$1 `R.4X=""` \$1 `R.8X=""` \$1 \$1 `Z.2X=""`)。

  將在任務執行時分配的預先定義工作者類型。對於 Spark 任務，接受 G.025X、G.1X、G.2X、G.4X、G.8X、G.12X、G.16X、R.1X、R.2X、R.4X 或 R.8X 的值。接受 Ray 任務的 Z.2X 值。
  + 用於 `G.1X` 工作者類型時，每個工作者會映射到 1 個 DPU (4 個 vCPU、16 GB 的記憶體)，外加 94 GB 磁碟，並為每個工作者提供 1 個執行器。我們建議將此工作者類型用於資料轉換、聯結和查詢等工作負載，以提供可擴展且符合成本效益的方式來執行大部分任務。
  + 用於 `G.2X` 工作者類型時，每個工作者會映射到 2 個 DPU (8 個 vCPU、32 GB 的記憶體)，外加 138 GB 磁碟，並為每個工作者提供 1 個執行器。我們建議將此工作者類型用於資料轉換、聯結和查詢等工作負載，以提供可擴展且符合成本效益的方式來執行大部分任務。
  + 用於 `G.4X` 工作者類型時，每個工作者會映射到 4 個 DPU (16 個 vCPU、64 GB 的記憶體)，外加 256 GB 磁碟，並為每個工作者提供 1 個執行器。我們建議工作負載包含最嚴苛轉換、彙總、聯結和查詢的任務採用這種工作者類型。此工作者類型僅適用於下列 AWS 區域中的 3.0 AWS Glue 版或更新版本 Spark ETL 任務：美國東部 （俄亥俄）、美國東部 （維吉尼亞北部）、美國西部 （奧勒岡）、亞太區域 （新加坡）、亞太區域 （雪梨）、亞太區域 （東京）、加拿大 （中部）、歐洲 （法蘭克福）、歐洲 （愛爾蘭） 和歐洲 （斯德哥爾摩）。
  + 用於 `G.8X` 工作者類型時，每個工作者會映射到 8 個 DPU (32 個 vCPU、128 GB 的記憶體)，外加 512 GB 磁碟，並為每個工作者提供 1 個執行器。我們建議工作負載包含最嚴苛轉換、彙總、聯結和查詢的任務採用這種工作者類型。此工作者類型僅適用於 3.0 AWS Glue 版或更新版本的 Spark ETL 任務，其位於與`G.4X`工作者類型支援的相同 AWS 區域中。
  + 對於`G.12X`工作者類型，每個工作者會映射到具有 768GB 個 vCPUs、192 GB 記憶體），並為每個工作者提供 1 個執行器。對於工作負載非常大的任務，我們建議使用此工作者類型。此工作者類型僅適用於 4.0 AWS Glue 版或更新版本的 Spark ETL 任務。
  + 對於`G.16X`工作者類型，每個工作者對應到具有 1024 GB 磁碟的 1024GB6 個 DPU (64 個 vCPUs、256 GB 記憶體），並為每個工作者提供 1 個執行器。對於工作負載非常大的任務，我們建議使用此工作者類型。此工作者類型僅適用於 4.0 AWS Glue 版或更新版本的 Spark ETL 任務。
  + 用於 `G.025X` 工作者類型時，每個工作者會映射到 0.25 個 DPU (2 個 vCPU、4 GB 的記憶體)，外加 84 GB 磁碟，並為每個工作者提供 1 個執行器。我們建議低容量串流任務採用這種工作者類型。此工作者類型僅適用於 3.0 AWS Glue 版或更新版本的串流任務。
  + 對於`R.1X`工作者類型，每個工作者對應到具有 94GB磁碟的 1 個 DPU (4 個 vCPUs，32 GB 記憶體），並為每個工作者提供 1 個執行器。我們建議針對記憶體密集型工作負載使用此工作者類型。此工作者類型僅適用於 4.0 AWS Glue 版或更新版本的 Spark ETL 任務。
  + 對於`R.2X`工作者類型，每個工作者對應到具有 128GB磁碟的 2 個 DPU (8 個 vCPUs、64 GB 記憶體），並為每個工作者提供 1 個執行器。我們建議針對記憶體密集型工作負載使用此工作者類型。此工作者類型僅適用於 4.0 AWS Glue 版或更新版本的 Spark ETL 任務。
  + 對於`R.4X`工作者類型，每個工作者會映射到具有 256GB磁碟的 4 個 DPU (16 個 vCPUs、128 GB 記憶體），並為每個工作者提供 1 個執行器。我們建議針對記憶體密集型工作負載使用此工作者類型。此工作者類型僅適用於 4.0 AWS Glue 版或更新版本的 Spark ETL 任務。
  + 對於`R.8X`工作者類型，每個工作者會映射到具有 512GB 個 vCPUs、256 GB 記憶體），並為每個工作者提供 1 個執行器。我們建議針對記憶體密集型工作負載使用此工作者類型。此工作者類型僅適用於 4.0 AWS Glue 版或更新版本的 Spark ETL 任務。
  + 對於 `Z.2X` 工作者類型，每個工作者都會映射到 2 個 M-DPU (8 個 vCPU、64 GB 記憶體)，外加 128 GB 磁碟，並根據自動縮放器提供最多 8 個 Ray 工作者。
+ `NumberOfWorkers` – 數字 (整數)。

  當任務執行時所配置的已定義 `workerType` 的工作者數目。
+ `SecurityConfiguration` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  可與此任務執行搭配使用的 `SecurityConfiguration` 結構名稱。
+ `LogGroupName` – UTF-8 字串。

  用於確保記錄安全的名稱，可以使用 AWS KMS在 Amazon CloudWatch 中進行伺服器端加密。此名稱可為 `/aws-glue/jobs/`，在此情況下預設加密為 `NONE`。若您新增角色名稱及 `SecurityConfiguration` 名稱 (即 `/aws-glue/jobs-yourRoleName-yourSecurityConfigurationName/`)，則該安全組態將用於加密此日誌群組。
+ `NotificationProperty` – [NotificationProperty](#aws-glue-api-jobs-runs-NotificationProperty) 物件。

  指定任務執行通知的組態屬性。
+ `GlueVersion` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Custom string pattern #48](aws-glue-api-common.md#regex_48)。

  在 Spark 任務中， `GlueVersion`會決定任務中 AWS Glue 可用的 Apache Spark 和 Python 版本。Python 版本指示針對 Spark 類型任務支援的版本。

  Ray 任務應將 `GlueVersion` 設定為 `4.0` 或更高版本。不過，Ray 任務中可用的 Ray、Python 和其他程式庫的版本由 Job 命令的 `Runtime` 參數決定。

  如需可用 AWS Glue 版本和對應 Spark 和 Python 版本的詳細資訊，請參閱 開發人員指南中的 [Glue 版本](https://docs.aws.amazon.com/glue/latest/dg/add-job.html)。

  建立時未指定 Glue 版本的任務，預設為 Glue 0.9。
+ `DPUSeconds` – 數字 (雙位數)。

  此欄位可以針對具有執行類別 `FLEX` 的任務執行設定或在啟用 Auto Scaling 時設定，表示每個執行器在任務執行生命週期內執行的總時間 (以秒為單位) 乘以 DPU 因子 (`G.2X` 為 1、`G.1X` 為 2、`G.025X` 工作者為 0.25)。此值可能不同於 Auto Scaling 任務案例中的 `executionEngineRuntime` \$1 `MaxCapacity`，因為在給定時間執行的執行程序數量可能少於 `MaxCapacity`。因此，`DPUSeconds` 的值有可能小於 `executionEngineRuntime` \$1 `MaxCapacity`。
+ `ExecutionClass` – UTF-8 字串，長度不可超過 16 個位元組 (有效值：`FLEX=""` \$1 `STANDARD=""`)。

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

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

  只有 3.0 版及更高 AWS Glue 版本以及命令類型的任務`glueetl`才能`ExecutionClass`設定為 `FLEX`。彈性執行類別可用於 Spark 任務。
+ `MaintenanceWindow` – UTF-8 字串，需符合[Custom string pattern #34](aws-glue-api-common.md#regex_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-api-common.md#aws-glue-api-regex-oneLine)。

  與任務執行相關聯的 AWS Glue 用量描述檔名稱。
+ `StateDetail` – UTF-8 字串，長度不可超過 400000 個位元組。

  此欄位會保留與任務執行狀態相關的詳細資訊。欄位可以為 null。

  例如，當任務執行因任務執行佇列而處於 WAITING 狀態時， 欄位具有任務執行處於該狀態的原因。
+ `ExecutionRoleSessionPolicy` – UTF-8 字串，長度不可小於 2 個位元組，也不可以超過 2048 個位元組。

  此 StartJobRun API 的內嵌工作階段政策可讓您動態限制任務範圍的所指定執行角色的許可，而無需建立其他 IAM 角色。

## Predecessor 結構
<a name="aws-glue-api-jobs-runs-Predecessor"></a>

任務執行，在用來觸發此任務執行的觸發條件的述詞中使用。

**欄位**
+ `JobName` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  前置任務執行所用的任務定義名稱。
+ `RunId` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  前置任務執行作業的任務執行 ID。

## JobBookmarkEntry 結構
<a name="aws-glue-api-jobs-runs-JobBookmarkEntry"></a>

定義可供任務繼續處理的位置點。

**欄位**
+ `JobName` – UTF-8 字串。

  正在討論的任務的名稱。
+ `Version` – 數字 (整數)。

  任務的版本。
+ `Run` – 數字 (整數)。

  執行 ID 編號。
+ `Attempt` – 數字 (整數)。

  嘗試 ID 編號。
+ `PreviousRunId` – UTF-8 字串。

  與之前任務執行相關聯的唯一執行識別符。
+ `RunId` – UTF-8 字串。

  執行 ID 編號。
+ `JobBookmark` – UTF-8 字串。

  書籤本身。

## BatchStopJobRunSuccessfulSubmission 結構
<a name="aws-glue-api-jobs-runs-BatchStopJobRunSuccessfulSubmission"></a>

記錄停止了指定 `JobRun` 的成功要求。

**欄位**
+ `JobName` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  先前停止的任務執行中所用的任務定義名稱。
+ `JobRunId` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  已停止之任務執行的 `JobRunId`。

## BatchStopJobRunError 結構
<a name="aws-glue-api-jobs-runs-BatchStopJobRunError"></a>

記錄在嘗試停止指定的任務執行時所發生的錯誤。

**欄位**
+ `JobName` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  正在討論的任務執行中所用的任務定義名稱。
+ `JobRunId` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  任務執行有問題的 `JobRunId`。
+ `ErrorDetail` – [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail) 物件。

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

## NotificationProperty 結構
<a name="aws-glue-api-jobs-runs-NotificationProperty"></a>

指定通知的組態屬性。

**欄位**
+ `NotifyDelayAfter` – 數字 (整數)，至少為 1。

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

## 作業
<a name="aws-glue-api-jobs-runs-actions"></a>
+ [StartJobRun 動作 (Python: start\$1job\$1run)](#aws-glue-api-jobs-runs-StartJobRun)
+ [BatchStopJobRun 動作 (Python: batch\$1stop\$1job\$1run)](#aws-glue-api-jobs-runs-BatchStopJobRun)
+ [GetJobRun 動作 (Python: get\$1job\$1run)](#aws-glue-api-jobs-runs-GetJobRun)
+ [GetJobRuns 動作 (Python: get\$1job\$1runs)](#aws-glue-api-jobs-runs-GetJobRuns)
+ [GetJobBookmark 動作 (Python: get\$1job\$1bookmark)](#aws-glue-api-jobs-runs-GetJobBookmark)
+ [GetJobBookmarks 動作 (Python: get\$1job\$1bookmarks)](#aws-glue-api-jobs-runs-GetJobBookmarks)
+ [ResetJobBookmark 動作 (Python: reset\$1job\$1bookmark)](#aws-glue-api-jobs-runs-ResetJobBookmark)

## StartJobRun 動作 (Python: start\$1job\$1run)
<a name="aws-glue-api-jobs-runs-StartJobRun"></a>

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

**請求**
+ `JobName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  欲使用的任務定義的名稱。
+ `JobRunQueuingEnabled` – 布林值。

  指定任務執行是否已啟用任務執行佇列。

  值為 true 表示已為任務執行啟用任務執行佇列。如果為 false 或未填入，則不會考慮將任務執行排入佇列。
+ `JobRunId` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  要重試之先前 `JobRun` 的 ID。
+ `Arguments` – 金鑰值對的映射陣列。

  每個金鑰都是 UTF-8 字串。

  每個值都是 UTF-8 字串。

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

  您可以在此指定您自己的任務執行指令碼使用的引數，以及 AWS Glue 本身使用的引數。

  可以記錄任務引數。不要將純文字袐密當做引數傳遞。如果您想要將秘密保留在任務中，請從 AWS Glue 連線 AWS Secrets Manager 或其他秘密管理機制擷取秘密。

  如需如何指定和取用自有任務引數的資訊，請參閱本開發人員指南中的[使用 Python 呼叫 AWS Glue API](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) 主題。

  如需有關設定 Spark 任務時可提供給此欄位之引數的資訊，請參閱開發人員指南中的 [Special Parameters Used by AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) 主題。

  如需有關設定 Ray 任務時可提供給此欄位之引數的資訊，請參閱開發人員指南中的 [Using job parameters in Ray jobs](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html)。
+ `AllocatedCapacity` – 數字 (整數)。

  此欄位已作廢。請改用 `MaxCapacity`。

  要配置給此 JobRun 的 AWS Glue 資料處理單位 (DPU) 數量。 DPUs 您可以分配至少 2 個 DPU，預設值為 10。DPU 是處理能力的相對測量，包含 4 個 vCPUs的運算容量和 16 GB 的記憶體。如需詳細資訊，請參閱 [AWS Glue 定價頁面](https://aws.amazon.com/glue/pricing/)。
+ `Timeout` – 數字 (整數)，至少為 1。

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

  任務的逾時值必須少於 7 天或 10,080 分鐘。否則，任務會擲回例外狀況。

  在值保留空白時，逾時預設為 2,880 分鐘。

  逾時值大於 7 天的任何現有 AWS Glue 任務將預設為 7 天。例如，如果您為批次任務指定了 20 天的逾時，則會在第 7 天停止。

  對於串流任務，如果您已設定維護時段，則會在 7 天後的維護時段期間重新啟動任務。
+ `MaxCapacity` – 數字 (雙位數)。

  對於 Glue 1.0 版或更早版本任務，使用標準工作者類型，此任務執行時可配置的 AWS Glue 資料處理單位 (DPUs) 數量。DPU 是處理能力的相對測量，包含 4 個 vCPUs的運算容量和 16 GB 的記憶體。如需詳細資訊，請參閱 [AWS Glue 定價頁面](https://aws.amazon.com/glue/pricing/)。

  對於 Glue 2.0\$1 版任務，您不能指定 `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](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  可與此任務執行搭配使用的 `SecurityConfiguration` 結構名稱。
+ `NotificationProperty` – [NotificationProperty](#aws-glue-api-jobs-runs-NotificationProperty) 物件。

  指定任務執行通知的組態屬性。
+ `WorkerType` – UTF-8 字串 (有效值：`Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`)。

  將在任務執行時分配的預先定義工作者類型。接受 Spark 任務的 G.1X、G.2X、G.4X、G.8X 或 G.025X 值。接受 Ray 任務的 Z.2X 值。
  + 用於 `G.1X` 工作者類型時，每個工作者會映射到 1 個 DPU (4 個 vCPU、16 GB 的記憶體)，外加 94 GB 磁碟，並為每個工作者提供 1 個執行器。我們建議將此工作者類型用於資料轉換、聯結和查詢等工作負載，以提供可擴展且符合成本效益的方式來執行大部分任務。
  + 用於 `G.2X` 工作者類型時，每個工作者會映射到 2 個 DPU (8 個 vCPU、32 GB 的記憶體)，外加 138 GB 磁碟，並為每個工作者提供 1 個執行器。我們建議將此工作者類型用於資料轉換、聯結和查詢等工作負載，以提供可擴展且符合成本效益的方式來執行大部分任務。
  + 用於 `G.4X` 工作者類型時，每個工作者會映射到 4 個 DPU (16 個 vCPU、64 GB 的記憶體)，外加 256 GB 磁碟，並為每個工作者提供 1 個執行器。我們建議工作負載包含最嚴苛轉換、彙總、聯結和查詢的任務採用這種工作者類型。此工作者類型僅適用於下列 AWS 區域中的 3.0 AWS Glue 版或更新版本 Spark ETL 任務：美國東部 （俄亥俄）、美國東部 （維吉尼亞北部）、美國西部 （奧勒岡）、亞太區域 （新加坡）、亞太區域 （雪梨）、亞太區域 （東京）、加拿大 （中部）、歐洲 （法蘭克福）、歐洲 （愛爾蘭） 和歐洲 （斯德哥爾摩）。
  + 用於 `G.8X` 工作者類型時，每個工作者會映射到 8 個 DPU (32 個 vCPU、128 GB 的記憶體)，外加 512 GB 磁碟，並為每個工作者提供 1 個執行器。我們建議工作負載包含最嚴苛轉換、彙總、聯結和查詢的任務採用這種工作者類型。此工作者類型僅適用於 3.0 AWS Glue 版或更新版本的 Spark ETL 任務，其位於與`G.4X`工作者類型支援的相同 AWS 區域中。
  + 對於`G.12X`工作者類型，每個工作者會映射到具有 768GB 個 vCPUs、192 GB 記憶體），並為每個工作者提供 1 個執行器。對於工作負載非常大的任務，我們建議使用此工作者類型。此工作者類型僅適用於 4.0 AWS Glue 版或更新版本的 Spark ETL 任務。
  + 對於`G.16X`工作者類型，每個工作者對應到具有 1024 GB 磁碟的 1024GB6 個 DPU (64 個 vCPUs、256 GB 記憶體），並為每個工作者提供 1 個執行器。對於工作負載非常大的任務，我們建議使用此工作者類型。此工作者類型僅適用於 4.0 AWS Glue 版或更新版本的 Spark ETL 任務。
  + 用於 `G.025X` 工作者類型時，每個工作者會映射到 0.25 個 DPU (2 個 vCPU、4 GB 的記憶體)，外加 84 GB 磁碟，並為每個工作者提供 1 個執行器。我們建議低容量串流任務採用這種工作者類型。此工作者類型僅適用於 3.0 AWS Glue 版或更新版本的串流任務。
  + 對於`R.1X`工作者類型，每個工作者對應到具有 94GB磁碟的 1 個 DPU (4 個 vCPUs，32 GB 記憶體），並為每個工作者提供 1 個執行器。我們建議針對記憶體密集型工作負載使用此工作者類型。此工作者類型僅適用於 4.0 AWS Glue 版或更新版本的 Spark ETL 任務。
  + 對於`R.2X`工作者類型，每個工作者對應到具有 128GB磁碟的 2 個 DPU (8 個 vCPUs、64 GB 記憶體），並為每個工作者提供 1 個執行器。我們建議針對記憶體密集型工作負載使用此工作者類型。此工作者類型僅適用於 4.0 AWS Glue 版或更新版本的 Spark ETL 任務。
  + 對於`R.4X`工作者類型，每個工作者會映射到具有 256GB磁碟的 4 個 DPU (16 個 vCPUs、128 GB 記憶體），並為每個工作者提供 1 個執行器。我們建議針對記憶體密集型工作負載使用此工作者類型。此工作者類型僅適用於 4.0 AWS Glue 版或更新版本的 Spark ETL 任務。
  + 對於`R.8X`工作者類型，每個工作者會映射到具有 512GB 個 vCPUs、256 GB 記憶體），並為每個工作者提供 1 個執行器。我們建議針對記憶體密集型工作負載使用此工作者類型。此工作者類型僅適用於 4.0 AWS Glue 版或更新版本的 Spark ETL 任務。
  + 對於 `Z.2X` 工作者類型，每個工作者都會映射到 2 個 M-DPU (8 個 vCPU、64 GB 記憶體)，外加 128 GB 磁碟，並根據自動縮放器提供最多 8 個 Ray 工作者。
+ `NumberOfWorkers` – 數字 (整數)。

  當任務執行時所配置的已定義 `workerType` 的工作者數目。
+ `ExecutionClass` – UTF-8 字串，長度不可超過 16 個位元組 (有效值：`FLEX=""` \$1 `STANDARD=""`)。

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

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

  只有 3.0 版及更高 AWS Glue 版本以及命令類型的任務`glueetl`才能`ExecutionClass`設定為 `FLEX`。彈性執行類別可用於 Spark 任務。
+ `ProfileName` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  與任務執行相關聯的 AWS Glue 用量描述檔名稱。
+ `ExecutionRoleSessionPolicy` – UTF-8 字串，長度不可小於 2 個位元組，也不可以超過 2048 個位元組。

  此 StartJobRun API 的內嵌工作階段政策可讓您動態限制任務範圍的所指定執行角色的許可，而無需建立其他 IAM 角色。

**回應**
+ `JobRunId` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  指派給此次任務執行的 ID。

**錯誤**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentRunsExceededException`

## BatchStopJobRun 動作 (Python: batch\$1stop\$1job\$1run)
<a name="aws-glue-api-jobs-runs-BatchStopJobRun"></a>

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

**請求**
+ `JobName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  用於停止任務執行的任務定義的名稱。
+ `JobRunIds` – *必要：*UTF-8 字串的陣列，不可小於 1 或超過 25 個字串。

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

**回應**
+ `SuccessfulSubmissions` – 一個 [BatchStopJobRunSuccessfulSubmission](#aws-glue-api-jobs-runs-BatchStopJobRunSuccessfulSubmission) 物件陣列。

  已成功提交停用要求的 JobRun 的清單。
+ `Errors` – 一個 [BatchStopJobRunError](#aws-glue-api-jobs-runs-BatchStopJobRunError) 物件陣列。

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

**錯誤**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetJobRun 動作 (Python: get\$1job\$1run)
<a name="aws-glue-api-jobs-runs-GetJobRun"></a>

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

**請求**
+ `JobName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  正在執行的任務定義的名稱。
+ `RunId` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  此次任務執行的 ID。
+ `PredecessorsIncluded` – 布林值。

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

**回應**
+ `JobRun` – [JobRun](#aws-glue-api-jobs-runs-JobRun) 物件。

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

**錯誤**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetJobRuns 動作 (Python: get\$1job\$1runs)
<a name="aws-glue-api-jobs-runs-GetJobRuns"></a>

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

`GetJobRuns` 會依時間順序傳回任務執行，並先傳回最新的任務。

**請求**
+ `JobName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  要擷取其所有任務執行作業資料的任務定義的名稱。
+ `NextToken` – UTF-8 字串。

  接續符記，如果這是接續呼叫。
+ `MaxResults` – 數字 （整數），不可小於 1 或大於 200。

  回應的大小上限。

**回應**
+ `JobRuns` – 一個 [JobRun](#aws-glue-api-jobs-runs-JobRun) 物件陣列。

  任務執行中繼資料物件的清單。
+ `NextToken` – UTF-8 字串。

  持續符記 (如果尚未傳回所有重新要求的任務執行作業的結果)。

**錯誤**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetJobBookmark 動作 (Python: get\$1job\$1bookmark)
<a name="aws-glue-api-jobs-runs-GetJobBookmark"></a>

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

如需有關啟用和使用任務書籤的詳細資訊，請參閱：
+ [使用任務書籤追蹤處理的資料](https://docs.aws.amazon.com/glue/latest/dg/monitor-continuations.html)
+ [使用的任務參數 AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html)
+ [任務結構](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html#aws-glue-api-jobs-job-Job)

**請求**
+ `JobName` – *必要：*UTF-8 字串。

  正在討論的任務的名稱。
+ `Version` – 數字 (整數)。

  任務的版本。
+ `RunId` – UTF-8 字串。

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

**回應**
+ `JobBookmarkEntry` – [JobBookmarkEntry](#aws-glue-api-jobs-runs-JobBookmarkEntry) 物件。

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

**錯誤**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ValidationException`

## GetJobBookmarks 動作 (Python: get\$1job\$1bookmarks)
<a name="aws-glue-api-jobs-runs-GetJobBookmarks"></a>

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

如需有關啟用和使用任務書籤的詳細資訊，請參閱：
+ [使用任務書籤追蹤處理的資料](https://docs.aws.amazon.com/glue/latest/dg/monitor-continuations.html)
+ [使用的任務參數 AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html)
+ [任務結構](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html#aws-glue-api-jobs-job-Job)

**請求**
+ `JobName` – *必要：*UTF-8 字串。

  正在討論的任務的名稱。
+ `MaxResults` – 數字 (整數)。

  回應的大小上限。
+ `NextToken` – 數字 (整數)。

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

**回應**
+ `JobBookmarkEntries` – 一個 [JobBookmarkEntry](#aws-glue-api-jobs-runs-JobBookmarkEntry) 物件陣列。

  任務書籤項目的清單，定義工作可以繼續處理的點。
+ `NextToken` – 數字 (整數)。

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

**錯誤**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## ResetJobBookmark 動作 (Python: reset\$1job\$1bookmark)
<a name="aws-glue-api-jobs-runs-ResetJobBookmark"></a>

重設書籤項目。

如需有關啟用和使用任務書籤的詳細資訊，請參閱：
+ [使用任務書籤追蹤處理的資料](https://docs.aws.amazon.com/glue/latest/dg/monitor-continuations.html)
+ [使用的任務參數 AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html)
+ [任務結構](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html#aws-glue-api-jobs-job-Job)

**請求**
+ `JobName` – *必要：*UTF-8 字串。

  正在討論的任務的名稱。
+ `RunId` – UTF-8 字串。

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

**回應**
+ `JobBookmarkEntry` – [JobBookmarkEntry](#aws-glue-api-jobs-runs-JobBookmarkEntry) 物件。

  重設的書籤項目。

**錯誤**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`