

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用批次複寫來複寫現有物件
<a name="s3-batch-replication-batch"></a>

S3 批次複寫不同於即時複寫，後者會跨 Amazon S3 儲存貯體持續自動複寫新物件。反之，系統會隨現有物件的需求進行 S3 批次複寫。您可以使用 S3 批次複寫來複寫下列類型的物件：
+ 在設定複寫組態之前已存在的物件
+ 先前已複寫的物件
+ 複寫失敗的物件

您可以使用批次操作任務，隨需複寫這些物件。

若要開始使用批次複寫，您可以：
+ **啟動新複寫規則或目的地的批次複寫** – 在新複寫批次組態中建立第一個規則，或透過 Amazon S3 主控台將新目的地儲存貯體新增到現有組態時，您可以建立一次性的批次複寫任務。
+ **啟動現有複寫組態的批次複寫** – 您可以透過 Amazon S3 主控台、 AWS Command Line Interface (AWS CLI) AWS 、 SDKs 或 Amazon S3 REST API 使用 S3 批次操作來建立新的批次複寫任務。 Amazon 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 角色的詳細資訊，請參閱 [設定 S3 批次複寫的 IAM 角色](s3-batch-replication-policies.md)。
+ 批次複寫需要一個可由 Amazon S3 產生的資訊清單。產生的資訊清單必須存放在 AWS 區域 與來源儲存貯體相同的 中。如果您選擇不產生資訊清單，則可以提供包含您希望複寫之物件的 Amazon S3 庫存清單報告或 CSV 檔案。如需詳細資訊，請參閱[指定批次複寫任務的資訊清單](#batch-replication-manifest)。
+ 批次複寫不支援透過指定來自目的地儲存貯體之物件的版本 ID，以重新複寫已刪除的物件。若要重新複寫這些物件，您可以使用批次複製 (Batch Copy) 任務將來源物件複製到位。將這些物件複製到位後，會在來源儲存貯體中建立物件的新版本，並自動啟動複寫到目的地的操作。刪除並重新建立目的地儲存貯體不會啟動複寫。

  如需批次複製的詳細資訊，請參閱[使用批次操作複製物件的範例](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 儲存類別中存放的物件不支援批次複寫。
+ 若要批次複寫儲存在 Archive Access 或 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/)。

# 設定 S3 批次複寫的 IAM 角色
<a name="s3-batch-replication-policies"></a>

因為 Amazon S3 批次複寫是一種批次操作任務，所以您必須建立 AWS Identity and Access Management (IAM) 角色以向批次操作授予代您執行動作的許可。您還必須將批次複寫 IAM 政策連接到批次操作 IAM 角色。

使用下列程序建立一個政策和一個 IAM 角色，該角色授予批次操作啟動批次複寫任務的許可。

**建立批次複寫政策**

1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 的 IAM 主控台。

1. 在 **Access management** (存取管理) 下，請選擇 **Policies** (政策)。

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 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 的 IAM 主控台。

1. 在 **Access management** (存取管理) 下，請選擇 **Roles** (角色)。

1. 選擇建**立角色**。

1. 選擇 **AWS 服務** 作為信任的實體類型。在**使用案例**區段中，選擇 **S3** 作為服務，並選擇 **S3 Batch Operations** 作為使用案例。

1. 選擇**下一步**。**新增許可**頁面隨即出現。在搜尋方塊中，搜尋您在上一個程序中建立的政策。選取政策名稱旁的核取方塊，然後選擇**下一步**。

1. 在**名稱、檢閱和建立**頁面上，為您的 IAM 角色指定名稱。

1. 在**步驟 1：信任身分**區段中，確認您的 IAM 角色正在使用下列信任政策：

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

****  

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

------

1. 在 **Step 2: Add permissions** 區段中，確認您的 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 代您執行動作的許可。如需詳細資訊，請參閱[設定 S3 批次複寫的 IAM 角色](s3-batch-replication-policies.md)。

## 透過 Amazon S3 主控台將批次複寫用於新的複寫規則或目的地
<a name="batch-replication-new-config-console"></a>

當您在新複寫組態中建立第一個規則或透過 Amazon S3 主控台將新目的地儲存貯體新增至現有組態時，您可選擇建立「批次複寫」任務來複寫來源儲存貯體中的現有物件。

**在建立或更新複寫組態時建立批次複寫任務**

1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)：// 開啟 Amazon S3 主控台。

1. 在左側導覽窗格中，選擇 **Buckets** (儲存貯體)。

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) 角色的許可不足。如需建立此角色的詳細資訊，請參閱[設定 S3 批次複寫的 IAM 角色](s3-batch-replication-policies.md)。請確定建立或選擇具有批次複寫所需許可的 IAM 角色。

1. 選擇**儲存**。

# 為現有複寫規則建立批次複寫任務
<a name="s3-batch-replication-existing-config"></a>

在 Amazon S3 中，即時複寫不會複寫在建立複寫組態之前已存在於來源儲存貯體中的任何物件。即時複寫只會在建立複寫組態後，自動複寫寫入儲存貯體的新物件和更新的物件。若要複寫現有的物件，您可以使用 S3 批次複寫來隨需複寫這些物件。

您可以使用 AWS SDKs、 AWS Command Line Interface (AWS CLI) 或 Amazon S3 主控台，為現有的複寫組態設定 S3 批次複寫。 Amazon S3 如需批次複寫的概觀，請參閱[使用批次複寫來複寫現有物件](s3-batch-replication-batch.md)。

當批次複寫任務完成時，您將收到一份完成報告。如需使用報告檢查任務的詳細資訊，請參閱[追蹤任務狀態和完成報告](batch-ops-job-status.md)。

**先決條件**  
在建立批次複寫任務前，您必須建立批次操作 AWS Identity and Access Management (IAM) 角色以授予 Amazon S3 代您執行動作的許可。如需詳細資訊，請參閱[設定 S3 批次複寫的 IAM 角色](s3-batch-replication-policies.md)。

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

1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 的 Amazon S3 主控台。

1. 在左側導覽窗格中，選擇 **Batch Operations** (批次操作)。

1. 選擇**建立任務**。

1. 確認 **AWS 區域** 區段顯示您要建立任務的區域。

1. 在**資訊清單**區段中，指定您要使用的資訊清單格式。資訊清單是您希望對其執行指定動作之所有物件的清單。若要進一步了解批次操作資訊清單，請參閱[指定資訊清單](batch-ops-create-job.md#specify-batchjob-manifest)。
   + 如果您已準備好資訊清單，請選擇 **S3 inventory report (manifest.json)** (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. (選用) 產生完成報告。若要產生此報告，請選取**產生完成報告**。

   如果選擇產生完成報告，則必須選擇報告 **Failed tasks only** (僅限失敗的任務) 或者 **All tasks** (所有任務)，並為報告提供目的地儲存貯體。

1. 在**許可**區段中，請確定您選擇的 IAM 角色具有批次複寫所需的許可。複寫失敗的最常見原因之一，是所提供 IAM 角色中的許可不足。如需建立此角色的詳細資訊，請參閱[設定 S3 批次複寫的 IAM 角色](s3-batch-replication-policies.md)。

1. (選用) 將任務標籤新增到批次複寫任務。

1. 選擇**下一步**。

1. 請檢閱您的任務組態，然後選擇**建立任務**。

## AWS CLI 搭配 S3 資訊清單使用
<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 角色，取代 IAM 角色 `role/batch-Replication-IAM-policy`。如需詳細資訊，請參閱[設定 S3 批次複寫的 IAM 角色](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 角色，取代 IAM 角色 `role/batch-Replication-IAM-policy`。如需詳細資訊，請參閱[設定 S3 批次複寫的 IAM 角色](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
```