View a markdown version of this page

StartJob - Amazon Location Service

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

StartJob

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

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

对于ValidateAddress作业,定位功能包括世界大地测量系统 (WGS 84) 格式的纬度和经度坐标。 CountrySpecificAttributes包括每个国家/地区特定的其他数据,例如承运人路线信息、人口普查数据和邮政标识符。

有关更多信息,请参阅StartJob亚马逊定位服务 API 参考》。

有关此 API 的请求、响应和 CLI 命令示例,请参阅如何启动任务

使用案例

  • 数据迁移和系统整合:在系统之间迁移或将多个数据源整合到统一数据库时,清理和标准化大量地址数据。

  • 营销活动准备:在启动直邮活动之前验证客户地址数据库,以降低退回邮件的成本并提高投递成功率。

  • 数据库维护和合规性:定期验证现有的客户地址数据库,以维护数据质量标准并满足运输和物流合规要求。

了解请求

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 格式的纬度和经度。

        • CountrySpecificAttributes:包括特定于每个国家的其他数据,例如承运人路线信息、人口普查数据和邮政标识符。

了解响应

StartJob响应为监控和管理新创建的工作提供了基本信息。使用这些值来跟踪任务进度,并在处理完成时检索结果。

响应包括以下字段:

Job 识别

已创建任务的唯一标识符。

  • JobId:用于监控和管理操作的唯一作业标识符。

  • JobArn: ARN,用于唯一标识其中的作业。 AWS

Job 状态和时间

初始状态和创建时间戳。

  • Status: 初始任务状态。始终Pending适用于新创造的工作。

  • CreatedAt: ISO 8601 格式的 Job 创建时间戳。