Amazon Simple Storage Service
开发人员指南 (API 版本 2006-03-01)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

创建 Amazon S3 批量操作作业

此部分介绍创建 Amazon S3 批处理操作作业所需的信息。它还介绍了 Create Job 请求的结果。

创建作业请求

要创建作业,您必须提供以下信息:

运算

指定希望 Amazon S3 批处理操作对清单中的对象执行的操作。每种操作类型接受特定于该操作的参数,这样您便可以对每个对象执行相同的任务,就像是对这些对象逐个执行了操作。

清单

清单是您希望 Amazon S3 批处理操作对其执行指定操作的所有对象的列表。您可以使用 CSV 格式的 Amazon S3 清单报告作为清单,或使用您自己的自定义 CSV 对象列表。有关清单的更多信息,请参阅指定清单

优先级

使用作业优先级指示此作业相对于在您账户中运行的其他作业的优先级。数字越大,优先级越高。

作业优先级仅相对于为同一账户和区域中的其他作业设置的优先级有意义,因此,您可以选择适合您的编号系统。例如,您可能要为所有 Initiate Restore Object 作业分配优先级 1,为所有 PUT Object Copy 作业分配优先级 2,为所有 Put Object ACL 作业分配优先级 3。批量操作根据优先级编号确定作业的优先级,但不严格保证顺序。因此,您不应使用作业优先级来确保任何一个作业会在其他任何作业之前开始或完成。如果您需要确保严格的顺序,请等到一个作业完成后,再开始下一个作业。

RoleArn

您必须指定将运行作业的 IAM 角色。您使用的 IAM 角色必须具有足够的权限来执行作业中指定的操作。例如,要运行 PUT Object Copy 作业,IAM 角色必须具有源存储桶的 s3:GetObject 权限和目标存储桶的 s3:PutObject 权限。该角色还需要读取清单和写入作业完成报告的权限。有关 IAM 角色的更多信息,请参阅 IAM 角色。有关 Amazon S3 权限的更多信息,请参阅在策略中指定权限

报告

指定您是否希望 Amazon S3 批处理操作生成完成报告。如果您请求作业完成报告,那么您还必须在此元素中提供报告参数。所需信息包括要存储报告的存储桶、报告的格式、希望报告包含所有任务的详细信息还是只包含失败任务的详细信息以及可选的前缀字符串。

描述(可选)

您还可以提供最多包含 256 个字符的描述来帮助您跟踪和监控作业。只要返回有关作业的信息或在 Amazon S3 控制台中显示作业详细信息,Amazon S3 便会包含此描述。随后您便可以根据自己分配的描述轻松地对作业进行排序和筛选。描述不一定是唯一的,因此您可以使用描述作为类别(例如“每周日志复制作业”)来帮助您跟踪多组相似的作业。

创建作业响应

如果 Create Job 请求成功,Amazon S3 返回一个作业 ID。作业 ID 是 Amazon S3 自动生成的唯一标识符,以便于您标识批量操作作业并监控其状态。

通过 AWS CLI、AWS 开发工具包或 REST API 创建作业时,您可以设置 Amazon S3 批量操作以开始自动处理作业。作业在准备就绪后立即开始运行,不会等待后面较高优先级的作业。当您通过 AWS 管理控制台创建作业时,在批处理操作开始处理该作业之前,您必须查看作业详细信息并确认希望运行它。在您确认要运行作业后,作业的进度情况与您通过其他方法之一创建的作业一样。如果作业保持暂停状态超过 30 天,则它将失败。