本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
StartJob
StartJob 操作會啟動新的 Amazon Location 資料處理任務。您可以指定動作類型、輸入和輸出 Amazon S3 位置，以及授予服務存取儲存貯體的 IAM 執行角色。操作會傳回任務識別符、Amazon Resource Name (ARN) 和初始狀態，您可以用來監控任務進度。
您可以在請求中使用 ActionOptions 參數StartJob來請求其他功能。這些功能提供資料處理和結果的增強選項。
對於ValidateAddress任務，位置功能包含世界幾何系統 (WGS 84)
如需詳細資訊，請參閱《Amazon Location Service API 參考》中的 StartJob。
如需此 API 的請求、回應和 CLI 命令範例，請參閱如何啟動任務。
使用案例
-
資料遷移和系統整合：在系統之間遷移或將多個資料來源合併到統一資料庫中時，清除和標準化大量地址資料。
-
行銷活動準備：在啟動直接郵件行銷活動之前驗證客戶地址資料庫，以降低傳回的郵件成本並提高交付成功率。
-
資料庫維護和合規：定期驗證現有的客戶地址資料庫，以維護資料品質標準，並符合運送和物流合規要求。
了解請求
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格式經緯度。 -
CountrySpecificAttributes：包括每個國家/地區特有的其他資料，例如電信業者路由資訊、人口普查資料和郵遞區號識別符。
-
-
-
-
了解回應
StartJob 回應提供監控和管理新建立任務的必要資訊。使用這些值來追蹤任務進度，並在處理完成時擷取結果。
回應包含下列欄位：
- 任務識別
-
所建立任務的唯一識別符。
-
JobId：用於監控和管理操作的唯一任務識別符。 -
JobArn：唯一識別其中任務的 ARN AWS。
-
- 任務狀態和時間
-
初始狀態和建立時間戳記。
-
Status：初始任務狀態。一律Pending用於新建立的任務。 -
CreatedAt：ISO 8601 格式的任務建立時間戳記。
-
