翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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://console.aws.amazon.com/backup](https://console.aws.amazon.com/backup) で AWS Backup コンソールを開きます。

1. ナビゲーションペインで、[**Protected resources (保護されたリソース)**] を選択し、復元する Amazon DocumentDB リソース ID を選択します。

1. **[リソースの詳細]** ページには、選択したリソース ID の復旧ポイントのリストが表示されます。リソースを復元するには、[**バックアップ**] ペインで、リソースの復旧ポイント ID の横にあるラジオボタンをクリックします。ペインの右上隅にある **[復元]** を選択します。

1. コンソールの **[Amazon DocumentDB クラスタースナップショットの復元]** ページが表示されていることを確認します。

1. **復元オプション**では、以下を設定できます。
   + **エンジンバージョン** - 復元されたクラスターの DocumentDB エンジンバージョンを選択します。
**注記**  
復元プロセス中にインスタンスクラスとインスタンス数を設定することはできません。復元された DocumentDB クラスターは、デフォルトのインスタンス設定を使用します。Amazon DocumentDB コンソールまたは API を使用して、復元の完了後にインスタンスクラスを変更し、インスタンスを追加または削除できます。

1. **[設定]** ペインで、DB クラスター識別子の一意の名前を入力します。

   文字、数字、ハイフンを使用できますが、2 つのハイフンを連続して使用したり、名前をハイフンで終わらせたりすることはできません。最終的な名前はすべて小文字になります。

1. **[データベースオプション]** ペインで、データベースポートを選択します。

   これは、DB インスタンスまたはクラスターがアプリケーション接続に使用する TCP/IP ポートです。DB インスタンスまたはクラスターに接続するアプリケーションの接続文字列には、そのポート番号を指定する必要があります。DB インスタンスまたはクラスターに適用されるセキュリティグループと組織のファイアウォールの両方で、このポートへの接続を許可する必要があります。DB クラスター内のすべての DB インスタンスは、同じポートを使用します。

1. また、**[データベースオプション]** ペインで、DB クラスターパラメータグループを選択します。

   これは、このインスタンスの DB クラスターに関連付けられたパラメータグループです。DB クラスターパラメータグループは、クラスター内のすべての DB インスタンスに適用されるエンジン設定値のコンテナとして機能します。

1. **[暗号化]** ペインで、このデータベースボリュームの暗号化に使用するキーを選択します。デフォルトは `aws/rds` です。または、カスタマーマネージドキー (CMK) を使用することもできます。

1. **[ログエクスポート]** ペインで、Amazon CloudWatch Logs に発行するログタイプを選択します。**[IAM ロール]** は既に定義されています。

1. **[ロールを復元]** ペインで、復元ジョブのデフォルトの IAM ロールまたは別の IAM ロールを選択します。

1. [保護されたリソースのタグ] ペインでは、必要に応じてバックアップから復元されたデータベースクラスターにタグをコピーできます。

1. すべての設定を指定したら、**[バックアップを復元]** を選択します。

   **[復元ジョブ]** ペインが表示されます。ページ上部のメッセージには、復元ジョブに関する情報が表示されます。

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
```

 次に、`create-db-instance` を使用して、復元した Amazon DocumentDB クラスターを Amazon RDS インスタンスにアタッチします。
+ 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
  ```