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

# 還原 DocumentDB 叢集
<a name="restoring-docdb"></a>

## 使用 AWS Backup 主控台還原 Amazon DocumentDB 復原點
<a name="docdb-restore-console"></a>

還原 Amazon DocumentDB 叢集需要您指定多個還原選項。如需這些選項的資訊，請參閱《Amazon DocumentDB 開發人員指南》**中的《[從叢集快照還原](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup_restore-restore_from_snapshot.html)》。

**還原 Amazon DocumentDB 叢集**

1. 在 https：//[https://console.aws.amazon.com/backup](https://console.aws.amazon.com/backup) 開啟 AWS Backup 主控台。

1. 在導覽窗格中，選擇 **受保護的資源** 和您要還原的 Amazon DocumentDB 資源 ID。

1. **Resource details (資源詳細資訊)** 頁面上會顯示所選資源 ID 的復原點清單。若要還原資源，請在 **Backups (備份)** 窗格中，選擇資源復原點 ID 旁邊的選項按鈕。在窗格右上角，選擇 **Restore (還原)**。

1. 確保您位於主控台頁面 **還原 Amazon DocumentDB 叢集快照**。

1. 對於**還原選項**，您可以設定下列項目：
   + **引擎版本** - 選取還原叢集的 DocumentDB 引擎版本。
**注意**  
執行個體類別和執行個體數量無法在還原程序期間設定。還原的 DocumentDB 叢集將使用預設執行個體組態。您可以使用 Amazon DocumentDB 主控台或 API 修改執行個體類別，並在還原完成後新增或移除執行個體。

1. 在**設定**窗格中，輸入資料庫叢集識別符的唯一名稱。

   您可以使用字母、數字和連字號，但不能有兩個連續連字號或以連字號結尾名稱。最終名稱將全小寫。

1. 在**資料庫選項**窗格中，選取資料庫連接埠。

   這是資料庫執行個體或叢集將用於應用程式連線的 TCP/IP 連接埠。連接到資料庫執行個體或叢集的任何應用程式的連線字串必須指定連接埠號碼。套用至資料庫執行個體或叢集的安全群組和您的組織防火牆都必須允許連線至連接埠。資料庫叢集中的所有資料庫執行個體都使用相同的連接埠。

1. 此外，在**資料庫選項**窗格中，選取資料庫叢集參數群組。

   這是與此執行個體資料庫叢集相關聯的參數群組。資料庫叢集參數群組作為引擎組態值的容器，而這些值套用到叢集的每個資料庫執行個體。

1. 在**加密**窗格中，選取將用於加密此資料庫磁碟區的金鑰。預設值為 `aws/rds`。或者，您也可以使用客戶受管金鑰 (CMK)。

1. 在 **Log exports (日誌匯出)** 窗格中，選擇要發佈到 Amazon CloudWatch Logs 的日誌類型。**IAM role (IAM 角色)** 已定義。

1. 在**還原角色**窗格中，選擇還原任務的預設 IAM 角色或不同的 IAM 角色。

1. 在受保護的資源標籤窗格中，您可以選擇將標籤從備份複製到還原的資料庫叢集。

1. 指定所有設定之後，請選擇 **Restore backup (還原備份)**。

   **Restore jobs (還原任務)** 窗格隨即出現。頁面頂端的訊息提供還原任務的相關資訊。

1. 還原完成之後，請將還原的 Amazon DocumentDB 叢集連接至 Amazon RDS 執行個體。

## 使用 AWS Backup API、CLI 或 SDK 還原 Amazon DocumentDB 復原點
<a name="docdb-restore-cli"></a>

請先還原叢集。請使用 `[StartRestoreJob](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html)`。您可以在 Amazon DocumentDB 還原期間指定下列中繼資料：

```
availabilityZones
backtrackWindow
copyTagsToSnapshot // Boolean 
databaseName // string 
dbClusterIdentifier // string 
dbClusterParameterGroupName // string 
dbSubnetGroupName // string 
enableCloudwatchLogsExports // string 
enableIAMDatabaseAuthentication // Boolean 
engine // string 
engineMode // string 
engineVersion // string 
kmsKeyId // string 
port // integer 
optionGroupName // string 
scalingConfiguration
vpcSecurityGroupIds // string
```

 然後，使用 將還原的 Amazon DocumentDB 叢集連接到 Amazon RDS 執行個體`create-db-instance`。
+ 針對 Linux、macOS 或 Unix：

  ```
  aws docdb create-db-instance --db-instance-identifier sample-instance / 
                    --db-cluster-identifier sample-cluster --engine docdb --db-instance-class db.r5.large
  ```
+ 針對 Windows：

  ```
  aws docdb create-db-instance --db-instance-identifier sample-instance ^ 
                    --db-cluster-identifier sample-cluster --engine docdb --db-instance-class db.r5.large
  ```