本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

该`StartJob`操作启动了新的 Amazon Location 数据处理任务。您可以指定操作类型、输入和输出 Amazon S3 位置，以及授予服务访问您的存储桶权限的 IAM 执行角色。该操作会返回任务标识符、Amazon 资源名称 (ARN) 和初始状态，您可以用它们来监控任务进度。

您可以使用请求中的`ActionOptions``StartJob`参数请求其他功能。这些功能为数据处理和结果提供了增强的选项。

对于`ValidateAddress`作业，**定位**功能包括[世界大地测量系统 (WGS](https://earth-info.nga.mil/index.php?dir=wgs84&action=wgs84) 84) 格式的纬度和经度坐标。 **CountrySpecificAttributes**包括每个国家/地区特定的其他数据，例如承运人路线信息、人口普查数据和邮政标识符。

有关更多信息，请参阅[StartJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_StartJob.html)《*亚马逊定位服务 API 参考*》。

有关此 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`请求需要用于指定任务操作、数据位置和权限的配置详细信息。此配置决定了如何处理您的数据以及结果的存储位置。

该请求包含以下参数：

**Job 操作和权限**  
定义操作类型和访问权限的必需参数。  
+ `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`响应为监控和管理新创建的工作提供了基本信息。使用这些值来跟踪任务进度，并在处理完成时检索结果。

响应包括以下字段：

**Job 识别**  
已创建任务的唯一标识符。  
+ `JobId`：用于监控和管理操作的唯一作业标识符。
+ `JobArn`: ARN，用于唯一标识其中的作业。 AWS

**Job 状态和时间**  
初始状态和创建时间戳。  
+ `Status`: 初始任务状态。始终`Pending`适用于新创造的工作。
+ `CreatedAt`: ISO 8601 格式的 Job 创建时间戳。