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

# StartJob
<a name="start-job-api"></a>

`StartJob` 操作會啟動新的 Amazon Location 資料處理任務。您可以指定動作類型、輸入和輸出 Amazon S3 位置，以及授予服務存取儲存貯體的 IAM 執行角色。操作會傳回任務識別符、Amazon Resource Name (ARN) 和初始狀態，您可以用來監控任務進度。

您可以在請求中使用 `ActionOptions` 參數`StartJob`來請求其他功能。這些功能提供資料處理和結果的增強選項。

對於`ValidateAddress`任務，**位置**功能包含[世界幾何系統 (WGS 84)](https://earth-info.nga.mil/index.php?dir=wgs84&action=wgs84) 格式的經緯度座標。**CountrySpecificAttributes** 包含每個國家/地區特有的其他資料，例如電信業者路由資訊、人口普查資料和郵遞區號識別符。

如需詳細資訊，請參閱《*Amazon Location Service API 參考*》中的 [StartJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_StartJob.html)。

如需此 API 的請求、回應和 CLI 命令範例，請參閱[如何啟動任務](https://docs.aws.amazon.com/location/latest/developerguide/starting-a-job.html)。

## 使用案例
<a name="start-job-use-cases"></a>
+ **資料遷移和系統整合：**在系統之間遷移或將多個資料來源合併到統一資料庫中時，清除和標準化大量地址資料。
+ **行銷活動準備：**在啟動直接郵件行銷活動之前驗證客戶地址資料庫，以降低傳回的郵件成本並提高交付成功率。
+ **資料庫維護和合規：**定期驗證現有的客戶地址資料庫，以維護資料品質標準，並符合運送和物流合規要求。

## 了解請求
<a name="start-job-request-parameters"></a>

`StartJob` 請求需要指定任務動作、資料位置和許可的組態詳細資訊。此組態會決定如何處理您的資料，以及結果的存放位置。

請求包含下列參數：

**任務動作和許可**  
定義操作類型和存取許可的必要參數。  
+ `Action`：要執行的操作類型。目前僅支援 `ValidateAddress`。
+ `ExecutionRoleArn`：Amazon Location 在任務執行期間擔任以存取 Amazon S3 儲存貯體的 IAM 角色 ARN。

**輸入組態**  
指定在何處讀取輸入資料及其格式的必要參數。  
+ `InputOptions`：包含輸入資料組態的物件。
  + `Location`：存放輸入檔案的 Amazon S3 ARN 或 URI。
  + `Format`：輸入資料格式。目前僅支援 `Parquet`。

**輸出組態**  
指定寫入結果位置及其格式的必要參數。  
+ `OutputOptions`：包含輸出資料組態的物件。
  + `Location`：寫入輸出檔案的 Amazon S3 ARN 或 URI。
  + `Format`：輸出資料格式。目前僅支援 `Parquet`。

**選用參數**  
提供額外的任務組態和功能的參數。  
+ `Name`：人類可讀取的任務名稱，更容易識別。必須是 1-100 個字元符合模式 `[-._\w]+`。
+ `ClientToken`：等冪性字符，以確保不會多次建立相同的任務。必須是 1-64 個字元符合模式 `^[!-~]+$`。
+ `ActionOptions`：物件包含指定動作的其他功能。
  + `ValidateAddress`：包含地址驗證特定選項的物件。
    + `AdditionalFeatures`：要包含在結果中的特徵名稱陣列。有效值：
      + `Position`：包含每個已驗證地址的 [WGS 84](https://earth-info.nga.mil/index.php?dir=wgs84&action=wgs84) 格式經緯度。
      + `CountrySpecificAttributes`：包括每個國家/地區特有的其他資料，例如電信業者路由資訊、人口普查資料和郵遞區號識別符。

## 了解回應
<a name="start-job-response-details"></a>

`StartJob` 回應提供監控和管理新建立任務的必要資訊。使用這些值來追蹤任務進度，並在處理完成時擷取結果。

回應包含下列欄位：

**任務識別**  
所建立任務的唯一識別符。  
+ `JobId`：用於監控和管理操作的唯一任務識別符。
+ `JobArn`：唯一識別其中任務的 ARN AWS。

**任務狀態和時間**  
初始狀態和建立時間戳記。  
+ `Status`：初始任務狀態。一律`Pending`用於新建立的任務。
+ `CreatedAt`：ISO 8601 格式的任務建立時間戳記。