

# 使用批量复制以复制现有对象
<a name="s3-batch-replication-batch"></a>

S3 批量复制与实时复制不同，后者连续自动跨 Amazon S3 存储桶复制新对象。相反，S3 批量复制是按需对现有对象进行的。可以使用 S3 批量复制来复制以下类型的对象：
+ 在复制配置设立之前已经存在的对象
+ 以前已复制的对象
+ 复制失败的对象

您可以使用批量操作任务来按需复制这些对象。

要开始使用批量复制，您可以：
+ **为新的复制规则或目标启动批量复制** – 可以在新的复制配置中创建第一条规则时，或通过 Amazon S3 控制台向现有配置添加新的目标存储桶时，创建一次性批量复制任务。
+ **为现有复制配置启动批量复制** – 可以通过 Amazon S3 控制台、AWS Command Line Interface（AWS CLI）、AWS SDK 或 Amazon S3 REST API，使用 S3 批量操作创建新的批量复制任务。

分批复制任务完成后，您将收到完成报告。有关如何使用此报告检查任务的更多信息，请参阅[跟踪任务状态和完成报告](batch-ops-job-status.md)。

## S3 分批复制注意事项
<a name="batch-replication-considerations"></a>

使用 S3 批量复制之前，请查看以下注意事项列表：
+ 您的源存储桶必须具有现有的复制配置。要启用复制，请参阅 [设置实时复制概述](replication-how-setup.md) 和 [配置实时复制的示例](replication-example-walkthroughs.md)。
+ 如果您为存储桶配置了 S3 生命周期，我们建议在批量复制任务处于活动状态时禁用生命周期规则。这样做有助于确保源存储桶和目标存储桶的对等。否则，这些存储桶可能会出现差异，目标存储桶将不会与源存储桶完全一样。例如，考虑以下情形：
  + 您的源存储桶有某个对象的多个版本，并且对于该对象有一个删除标记。
  + 您的源存储桶和目标存储桶具有移除已过期删除标记的生命周期配置。

  在这种情况下，批量复制可能会在复制对象版本之前，将删除标记复制到目标存储桶。这种行为可能导致在复制对象版本之前，生命周期配置将删除标记标为过期，并且从目标存储桶中移除删除标记。
+ 您指定用于运行批量操作任务的 AWS Identity and Access Management（IAM）角色必须具有必要的权限，来执行基础的批量复制操作。有关创建 IAM 角色的更多信息，请参阅 [配置 IAM 角色以进行 S3 批量复制](s3-batch-replication-policies.md)。
+ 批量复制需要可以由 Amazon S3 生成的清单。生成的清单必须存储在与源存储桶相同的 AWS 区域 中。如果您选择不生成清单，则可以提供包含要复制的对象的 Amazon S3 清单报告或 CSV 文件。有关更多信息，请参阅 [为分批复制任务指定清单](#batch-replication-manifest)。
+ 批量复制不支持重新复制已通过从目标存储桶中指定对象的版本 ID 删除的对象。要重新复制这些对象，您可以使用分批复制任务将源对象复制到位。将这些对象复制到位会在源存储桶中创建对象的新版本，并自动启动到目标存储桶的复制。删除和重新创建目标存储桶不会启动复制。

  有关批量复制的更多信息，请参阅[使用分批操作复制对象的示例](batch-ops-examples-copy.md)。
+ 如果您在源存储桶上使用复制规则，请确保通过向附加到复制规则的 IAM 角色授予复制对象的适当权限，来[更新您的复制配置](https://docs.aws.amazon.com/AmazonS3/latest/userguide/replication-walkthrough-2.html)。此 IAM 角色必须具有在源存储桶和目标存储桶上执行复制所需的权限。
+ 如果您在短时间范围内为同一个存储桶提交多个批量复制任务，Amazon S3 会同时运行这些任务。
+ 如果您为两个不同的存储桶提交多个批量复制任务，请注意 Amazon S3 可能无法同时运行所有任务。如果您超过了账户中一次可以运行的批量复制任务的数量，Amazon S3 会暂停优先级较低的任务，来处理优先级较高的任务。优先级较高的任务完成后，任何暂停的任务都会再次变为活动状态。
+ 存储在 S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 存储类中的对象不支持批量复制。
+ 要批量复制存储在归档访问存储层或深度归档访问存储层中的 S3 Intelligent-Tiering 对象，必须首先启动[还原](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intelligent-tiering-managing.html#restore-data-from-int-tier-archive)请求，然后等待对象移动到频繁访问层。
+ 单个批量复制作业可以支持包含多达 200 亿个对象的清单。
+ 如果您使用 S3 批量复制来跨区域复制数据集，并且您的对象之前已将其服务器端加密类型从 SSE-S3 更新为 SSE-KMS，则您可能需要额外的权限。在源区域存储桶上，您必须拥有 `kms:decrypt` 权限。然后，您将需要针对目标区域中存储桶的 `kms:decrypt` 和 `kms:encrypt` 权限。有关更多信息，请参阅 [复制加密对象](replication-config-for-kms-objects.md)。

## 为分批复制任务指定清单
<a name="batch-replication-manifest"></a>

清单是一种 Amazon S3 对象，其中包含您希望 Amazon S3 采取操作的对象键。如果您希望创建批量复制任务，则必须提供用户生成的清单，或者让 Amazon S3 根据复制配置生成清单。

如果您提供用户生成的清单，清单必须采用 Amazon S3 清单报告或 CSV 文件的形式。如果清单中的对象位于受版本控制的存储桶中，则必须指定对象的版本 ID。只会复制在清单中指定了版本 ID 的对象。要了解有关指定清单的更多信息，请参阅 [指定清单](batch-ops-create-job.md#specify-batchjob-manifest)。

如果您选择让 Amazon S3 代表您生成清单文件，那么列出的对象会使用与源存储桶上的复制配置相同的源存储桶、前缀和标签。使用生成的清单，Amazon S3 复制所有符合条件的对象版本。

**注意**  
如果您选择让 Amazon S3 生成清单，则清单必须存储在与源存储桶相同的 AWS 区域中。

## 分批复制任务的筛选条件
<a name="batch-replication-filters"></a>

在创建批量复制任务时，您可以选择指定其它筛选条件，例如对象创建日期和复制状态，来缩小任务的范围。

您可以通过提供以下一个或多个值基于 `ObjectReplicationStatuses` 值筛选要复制的对象：
+ `"NONE"` – 表示 Amazon S3 之前从未尝试过复制对象。
+ `"FAILED"` – 表示 Amazon S3 之前尝试过，但未成功复制对象。
+ `"COMPLETED"` – 表示 Amazon S3 之前已成功复制对象。
+ `"REPLICA"` – 表示此对象是 Amazon S3 已从另一个源存储桶复制的副本。

有关复制状态的更多信息，请参阅 [获取复制状态信息](replication-status.md)。

如果您不筛选批量复制任务，批量操作会尝试复制清单中与复制配置中的规则匹配的所有对象（无论其 `ObjectReplicationStatus` 如何），但默认情况下未复制的某些对象除外。有关更多信息，请参阅 [使用复制配置不会复制什么？](replication-what-is-isnot-replicated.md#replication-what-is-not-replicated)。

根据您的目标，您可以将 `ObjectReplicationStatuses` 设置为以下一个或多个值：
+ 要复制从未复制过的现有对象，请仅包括 `"NONE"`。
+ 要重试复制之前未能复制的对象，请仅包括 `"FAILED"`。
+ 要同时复制现有对象和重试复制之前未能复制的对象，请同时包括 `"NONE"` 和 `"FAILED"`。
+ 要使用已复制到另一个目标的对象回填目标存储桶，请包括 `"COMPLETED"`。
+ 要复制之前已复制的对象，请包括 `"REPLICA"`。

## 分批复制完成报告
<a name="batch-replication-completion-report"></a>

在创建批量复制任务时，您可以请求 CSV 完成报告。此报告显示对象、复制成功或失败代码、输出和描述。有关任务跟踪和完成报告的更多信息，请参阅[完成报告](batch-ops-job-status.md#batch-ops-completion-report)。

有关复制故障代码和描述的列表，请参阅 [Amazon S3 复制失败原因](replication-metrics-events.md#replication-failure-codes)。

有关排查批量复制故障的信息，请参阅[批量复制错误](replication-troubleshoot.md#troubleshoot-batch-replication-errors)。

## 批量复制入门
<a name="batch-replication-tutorial"></a>

要了解有关如何使用批量复制的更多信息，请参阅[教程：使用 S3 批量复制来复制 Amazon S3 存储桶中的现有对象](https://aws.amazon.com/getting-started/hands-on/replicate-existing-objects-with-amazon-s3-batch-replication/)。

# 配置 IAM 角色以进行 S3 批量复制
<a name="s3-batch-replication-policies"></a>

由于 Amazon S3 批量复制是批量操作任务的一种类型，因此您必须创建一个 AWS Identity and Access Management（IAM）角色，用于向批量操作授予代表您执行操作的权限。您还必须将分批复制 IAM 策略附加到批量操作 IAM 角色。

使用以下过程创建策略和 IAM 角色，来向批量操作授予启动批量复制任务的权限。

**创建用于批量复制的策略**

1. 登录 AWS 管理控制台，然后通过以下网址打开 IAM 控制台：[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)。

1. 在**访问管理**下，选择**策略**。

1. 选择 **Create policy (创建策略)**。

1. 在**指定权限**页面上，选择 **JSON**。

1. 根据您的清单是由 Amazon S3 生成还是您自行提供清单，插入以下策略之一。有关清单的更多信息，请参阅[为分批复制任务指定清单](s3-batch-replication-batch.md#batch-replication-manifest)。

   在使用这些策略之前，请将以下策略中的 `user input placeholders` 替换为复制源存储桶、清单存储桶和完成报告存储桶的名称。
**注意**  
批量复制的 IAM 角色需要不同的权限，具体取决于您是生成清单还是提供清单，因此，请务必从以下示例中选择相应的策略。

**使用和存储 Amazon S3 生成的清单时的策略**

------
#### [ JSON ]

****  

   ```
   {
      "Version":"2012-10-17",		 	 	 
      "Statement": [
         {
            "Action": [
               "s3:InitiateReplication"
            ],
            "Effect": "Allow",
            "Resource": [
               "arn:aws:s3:::amzn-s3-demo-source-bucket/*"
            ]
         },
         {
            "Action": [
               "s3:GetReplicationConfiguration",
               "s3:PutInventoryConfiguration"
            ],
            "Effect": "Allow",
            "Resource": [
               "arn:aws:s3:::amzn-s3-demo-source-bucket"
            ]
         },
         {
            "Action": [
               "s3:GetObject",
               "s3:GetObjectVersion"
            ],
            "Effect": "Allow",
            "Resource": [
               "arn:aws:s3:::amzn-s3-demo-manifest-bucket/*"
            ]
         },
         {
            "Effect": "Allow",
            "Action": [
               "s3:PutObject"
            ],
            "Resource": [
               "arn:aws:s3:::amzn-s3-demo-completion-report-bucket/*",
               "arn:aws:s3:::amzn-s3-demo-manifest-bucket/*"    
            ]
         }
      ]
   }
   ```

------

**使用用户提供的清单时的策略**

------
#### [ JSON ]

****  

   ```
   {
      "Version":"2012-10-17",		 	 	 
      "Statement": [
         {
            "Action": [
               "s3:InitiateReplication"
            ],
            "Effect": "Allow",
            "Resource": [
               "arn:aws:s3:::amzn-s3-demo-source-bucket/*"
            ]
         },
         {
            "Action": [
               "s3:GetObject",
               "s3:GetObjectVersion"
            ],
            "Effect": "Allow",
            "Resource": [
               "arn:aws:s3:::amzn-s3-demo-manifest-bucket/*"
            ]
         },
         {
            "Effect": "Allow",
            "Action": [
               "s3:PutObject"
            ],
            "Resource": [
               "arn:aws:s3:::amzn-s3-demo-completion-report-bucket/*"    
            ]
         }
      ]
   }
   ```

------

1. 选择**下一步**。

1. 指定策略名称，然后选择**创建策略**。

**创建用于批量复制的 IAM 角色**

1. 登录 AWS 管理控制台，然后通过以下网址打开 IAM 控制台：[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)。

1. 在 **Access management**（访问管理）下，请选择 **Roles**（角色）。

1. 选择**创建角色**。

1. 选择 **AWS 服务**作为可信实体的类型。在**使用案例**部分中，选择 **S3** 作为服务，并选择 **S3 批量操作**作为使用案例。

1. 选择**下一步**。此时将显示**添加权限**页面。在搜索框中，搜索您在前面的过程中创建的策略。选中策略名称旁的复选框，然后选择**下一步**。

1. 在**命名、查看和创建**页面上，输入 IAM 角色的名称。

1. 在**步骤 1：信任身份**部分中，验证 IAM 角色是否使用以下信任策略：

------
#### [ JSON ]

****  

   ```
   {
      "Version":"2012-10-17",		 	 	 
      "Statement":[
         {
            "Effect":"Allow",
            "Principal":{
               "Service":"batchoperations.s3.amazonaws.com"
            },
            "Action":"sts:AssumeRole"
         }
      ]
   }
   ```

------

1. 在**步骤 2：添加权限**部分中，验证 IAM 角色是否使用您之前创建的策略。

1. 选择**创建角色**。

# 为新的复制规则或目标创建批量复制任务
<a name="s3-batch-replication-new-config"></a>

在 Amazon S3 中，实时复制不会复制在您创建复制配置之前已存在于源存储桶中的任何对象。实时复制仅自动复制在创建复制配置之后写入存储桶中的新对象和更新的对象。要复制已存在的对象，可以使用 S3 批量复制来按需复制这些对象。

在新的实时复制配置中创建第一个规则时，或通过 Amazon S3 控制台将新目标存储桶添加到现有复制配置时，可以选择创建一个批量复制任务。可以使用此批量复制任务来将源存储桶中的现有对象复制到目标存储桶。

要将批量复制用于现有配置而不添加新的目标存储桶，请参阅[为现有复制规则创建分批复制任务](s3-batch-replication-existing-config.md)。

**先决条件**  
在创建批量复制任务之前，必须创建批量操作 AWS Identity and Access Management（IAM）角色，来向 Amazon S3 授予代表您执行操作的权限。有关更多信息，请参阅 [配置 IAM 角色以进行 S3 批量复制](s3-batch-replication-policies.md)。

## 通过 Amazon S3 控制台将批量复制用于新的复制规则或目标
<a name="batch-replication-new-config-console"></a>

在新的复制配置中创建第一个规则时，或通过 Amazon S3 控制台将新的目标存储桶添加到现有配置时，可以选择创建批复制任务来复制源存储桶中的现有对象。

**在创建或更新复制配置时创建批量复制任务**

1. 登录到 AWS 管理控制台，然后通过以下网址打开 Amazon S3 控制台：[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)。

1. 在左侧导航窗格中，选择**存储桶**。

1. 在**通用存储桶**列表中，选择包含您想要复制的对象的存储桶名称。

1. 要创建新的复制规则或编辑现有规则，请选择**管理**选项卡，然后向下滚动到**复制规则**：
   + 要创建新的复制规则，请选择 **Create replication rule**（创建复制规则）。有关如何设置基本复制规则的示例，请参阅[配置实时复制的示例](replication-example-walkthroughs.md)。
   + 要编辑现有复制规则，请选择规则名称旁边的选项按钮，然后选择**编辑规则**。

1. 创建新的复制规则或编辑现有复制规则的目标，然后选择 **Save**（保存）。

   在新的复制配置中创建第一个规则或编辑现有配置以添加新目标后，将显示 **Replicate existing objects?**（是否复制现有对象？）对话框，让您可以选择创建分批复制任务。

1. 如果要立即创建并运行此任务，请选择**是，复制现有对象**。

   如果要以后创建批量复制任务，请选择**否，不复制现有对象**。

1. 如果选择**是，复制现有对象**，则会出现**创建批量操作任务**页面。S3 批量复制任务具有以下设置：  
**任务运行选项**  
如果您想让 S3 批量复制任务立即运行，请选择**任务准备就绪后自动运行**。如果您想在以后运行任务，请选择**等待任务准备就绪后再运行**。  
如果选择**任务准备就绪后自动运行**，您将无法创建和保存批量操作清单。要保存批量操作清单，请选择**等待任务准备就绪后再运行**。  
**批量操作清单**  
如果您选择**等待任务准备就绪后再运行**，则会显示**批量操作清单**部分。清单是您希望对其运行指定操作的所有对象的列表。可以选择保存此清单。与 S3 清单文件类似，清单将另存为 CSV 文件并存储在存储桶中。要了解有关批量操作清单的更多信息，请参阅 [指定清单](batch-ops-create-job.md#specify-batchjob-manifest)。  
**完成报告**  
S3 批量操作将为在清单中指定的每个对象执行一个任务。完成报告提供了以合并格式查看任务结果的简单途径，且无需进行任何附加设置。您可以为全部任务或仅为失败的任务请求完成报告。要了解有关完成报告的更多信息，请参阅 [完成报告](batch-ops-job-status.md#batch-ops-completion-report)。  
**权限**  
复制失败的最常见原因之一是提供的 AWS Identity and Access Management (IAM) 角色的权限不足。有关创建此角色的信息，请参阅 [配置 IAM 角色以进行 S3 批量复制](s3-batch-replication-policies.md)。确保创建或选择拥有批量复制所需权限的 IAM 角色。

1. 选择**保存**。

# 为现有复制规则创建分批复制任务
<a name="s3-batch-replication-existing-config"></a>

在 Amazon S3 中，实时复制不会复制在您创建复制配置之前已存在于源存储桶中的任何对象。实时复制仅自动复制在创建复制配置之后写入存储桶中的新对象和更新的对象。要复制已存在的对象，可以使用 S3 批量复制来按需复制这些对象。

您可以通过使用 AWS SDK、AWS Command Line Interface（AWS CLI）或 Amazon S3 控制台为现有复制配置来配置 S3 分批复制。有关批量复制的概述，请参阅[使用批量复制以复制现有对象](s3-batch-replication-batch.md)。

分批复制任务完成后，您将收到完成报告。有关如何使用报告检查任务的更多信息，请参阅 [跟踪任务状态和完成报告](batch-ops-job-status.md)。

**先决条件**  
在创建批量复制任务之前，必须创建批量操作 AWS Identity and Access Management（IAM）角色，来向 Amazon S3 授予代表您执行操作的权限。有关更多信息，请参阅 [配置 IAM 角色以进行 S3 批量复制](s3-batch-replication-policies.md)。

## 使用 S3 控制台
<a name="batch-replication-existing-config-console"></a>

1. 登录到 AWS 管理控制台，然后通过以下网址打开 Amazon S3 控制台：[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)。

1. 在左侧导航窗格中，选择**批量操作**。

1. 选择**创建任务**。

1. 验证 **AWS 区域**部分显示了要在其中创建任务的区域。

1. 在**清单**部分中，指定要使用的清单格式。清单是您希望对其运行指定操作的所有对象的列表。要了解有关批量操作清单的更多信息，请参阅 [指定清单](batch-ops-create-job.md#specify-batchjob-manifest)。
   + 如果您准备了清单，请选择 **S3 清单报告 (manifest.json)** 或 **CSV**。如果清单位于受版本控制的存储桶中，则可以指定清单的版本 ID。如果未指定版本 ID，批量操作会使用清单的当前版本。有关创建清单的更多信息，请参阅[指定清单](batch-ops-create-job.md#specify-batchjob-manifest)。
**注意**  
如果清单中的对象位于受版本控制的存储桶中，则必须指定对象的版本 ID。有关更多信息，请参阅 [指定清单](batch-ops-create-job.md#specify-batchjob-manifest)。
   + 要根据复制配置创建清单，请选择 **Create manifest using S3 Replication configuration**（使用 S3 复制配置创建清单）。然后，选择复制配置的源存储桶。

1. （可选）如果您选择**使用 S3 复制配置创建清单**，则可以添加其它筛选条件，例如对象创建日期和复制状态。有关如何按复制状态筛选的示例，请参阅[为分批复制任务指定清单](s3-batch-replication-batch.md#batch-replication-manifest)。

1. （可选）如果您选择**使用 S3 复制配置创建清单**，则可以保存生成的清单。要保存清单，请选择**保存批量操作清单**。然后，为清单指定目标存储桶，并选择是否对清单进行加密。
**注意**  
生成的清单必须存储在与源存储桶相同的 AWS 区域 中。

1. 选择**下一步**。

1. 在**操作**页上，选择**复制**，然后选择**下一步**。

1. （可选）提供 **Description**（说明）。

1. 必要时调整任务的 **Priority**（优先级）。数字越大，优先级越高。Amazon S3 尝试在优先级较低的任务之前运行优先级较高的任务。有关任务优先级的更多信息，请参阅 [分配任务优先级](batch-ops-job-priority.md)。

1. （可选）生成完成报告。要生成此报告，请选择**生成完成报告**。

   如果您选择生成完成报告，则必须选择报告**仅失败的任务**或**全部任务**，并为报告提供目标存储桶。

1. 在**权限**部分中，请确保您选择拥有批量复制所需权限的 IAM 角色。复制失败的最常见原因之一是提供的 IAM 角色的权限不足。有关创建此角色的信息，请参阅 [配置 IAM 角色以进行 S3 批量复制](s3-batch-replication-policies.md)。

1. （可选）将任务标签添加到分批复制任务中。

1. 选择**下一步**。

1. 检查任务配置，然后选择**创建任务**。

## 通过 S3 清单使用 AWS CLI
<a name="batch-replication-existing-config-cli"></a>

以下示例 `create-job` 命令通过使用 S3 为 AWS 账户 `111122223333` 生成的清单创建 S3 批量复制任务。此示例将复制现有对象和之前复制失败的对象。有关按复制状态筛选的信息，请参阅[为分批复制任务指定清单](s3-batch-replication-batch.md#batch-replication-manifest)。

要使用此命令，请将 *`user input placeholders`* 替换为您自己的信息。将 IAM 角色 `role/batch-Replication-IAM-policy` 替换为您之前创建的 IAM 角色。有关更多信息，请参阅 [配置 IAM 角色以进行 S3 批量复制](s3-batch-replication-policies.md)。

```
aws s3control create-job --account-id 111122223333 \ 
--operation '{"S3ReplicateObject":{}}' \ 
--report '{"Bucket":"arn:aws:s3:::amzn-s3-demo-completion-report-bucket",\ 
"Prefix":"batch-replication-report", \ 
"Format":"Report_CSV_20180820","Enabled":true,"ReportScope":"AllTasks"}' \ 
--manifest-generator '{"S3JobManifestGenerator": {"ExpectedBucketOwner": "111122223333", \ 
"SourceBucket": "arn:aws:s3:::amzn-s3-demo-source-bucket", \ 
"EnableManifestOutput": false, "Filter": {"EligibleForReplication": true, \ 
"ObjectReplicationStatuses": ["NONE","FAILED"]}}}' \ 
--priority 1 \ 
--role-arn arn:aws:iam::111122223333:role/batch-Replication-IAM-policy \ 
--no-confirmation-required \ 
--region source-bucket-region
```

**注意**  
必须从与复制源存储桶相同的 AWS 区域中启动该任务。

成功启动分批复制任务后，您会收到任务 ID 作为响应。可以使用下面的 `describe-job` 命令来监控此任务。要使用此命令，请将 *`user input placeholders`* 替换为您自己的信息。

```
aws s3control describe-job --account-id 111122223333 --job-id job-id --region source-bucket-region
```

## 通过用户提供的清单使用 AWS CLI
<a name="batch-replication-existing-config-cli-customer-manifest"></a>

以下示例通过使用 AWS 账户 `111122223333` 的用户定义清单创建 S3 批量复制任务。如果清单中的对象位于受版本控制的存储桶中，则必须指定对象的版本 ID。只有在清单中指定了版本 ID 的对象才会复制。有关创建清单的更多信息，请参阅[指定清单](batch-ops-create-job.md#specify-batchjob-manifest)。

要使用此命令，请将 *`user input placeholders`* 替换为您自己的信息。将 IAM 角色 `role/batch-Replication-IAM-policy` 替换为您之前创建的 IAM 角色。有关更多信息，请参阅 [配置 IAM 角色以进行 S3 批量复制](s3-batch-replication-policies.md)。

```
aws s3control create-job --account-id 111122223333 \ 
--operation '{"S3ReplicateObject":{}}' \
--report '{"Bucket":"arn:aws:s3:::amzn-s3-demo-completion-report-bucket",\
"Prefix":"batch-replication-report", \
"Format":"Report_CSV_20180820","Enabled":true,"ReportScope":"AllTasks"}' \
--manifest '{"Spec":{"Format":"S3BatchOperations_CSV_20180820",\
"Fields":["Bucket","Key","VersionId"]},\
"Location":{"ObjectArn":"arn:aws:s3:::amzn-s3-demo-manifest-bucket/manifest.csv",\
"ETag":"Manifest Etag"}}' \
--priority 1 \
--role-arn arn:aws:iam::111122223333:role/batch-Replication-IAM-policy \
--no-confirmation-required \
--region source-bucket-region
```

**注意**  
必须从与复制源存储桶相同的 AWS 区域中启动该任务。

成功启动分批复制任务后，您会收到任务 ID 作为响应。可以使用下面的 `describe-job` 命令来监控此任务。

```
aws s3control describe-job --account-id 111122223333 --job-id job-id --region source-bucket-region
```