本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
StartJob
该StartJob操作启动了新的 Amazon Location 数据处理任务。您可以指定操作类型、输入和输出 Amazon S3 位置,以及授予服务访问您的存储桶权限的 IAM 执行角色。该操作会返回任务标识符、Amazon 资源名称 (ARN) 和初始状态,您可以用它们来监控任务进度。
您可以使用请求中的ActionOptionsStartJob参数请求其他功能。这些功能为数据处理和结果提供了增强的选项。
对于ValidateAddress作业,定位功能包括世界大地测量系统 (WGS
有关更多信息,请参阅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 创建时间戳。
-