

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

# 特定時点への復元
<a name="backup_restore-point_in_time_recovery"></a>

 AWS マネジメントコンソール または AWS Command Line Interface () を使用して、クラスターをクラスターのバックアップ保持期間内の任意の時点に復元できますAWS CLI。

**注記**  
 3.6 クラスターの 4.0 クラスターへの特定の時点への復元は実行できませんが、あるクラスターバージョンから別のクラスタバージョンに移行できます。詳細については、「[Amazon DocumentDB への移行](docdb-migration.md)」を参照してください。

クラスターを特定時点に復元するときには、以下の点を考慮します。
+ 新しいクラスターは、デフォルトのパラメータグループを使用して作成されることを除いて、ソースクラスターと同じ設定で作成されます。新しいクラスターのパラメータグループをソースクラスターのパラメータグループに設定するには、ステータスが [*使用可能*] になってからクラスターを変更します。クラスターの変更の詳細については、「[Amazon DocumentDB クラスターの変更](db-cluster-modify.md)」を参照してください。

------
#### [ Using the AWS マネジメントコンソール ]

 AWS マネジメントコンソールを使用して以下を完了すると、クラスターをバックアップ保持期間内の特定の時点に復元できます。

1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) で Amazon DocumentDB コンソールを開きます。

1. ナビゲーションペインで **[Clusters]** (クラスター) を選択してください。クラスターのリストで、復元するクラスターの左側にあるボタンを選択します。
**ヒント**  
画面の左側にナビゲーションペインが表示されない場合は、ページの左上隅にあるメニューアイコン (![Menu button.](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/docdb-menu-icon.png)) を選択します。

1. [**アクション**] メニューで、[**特定時点への復元**] を選択します。

1. [**復元時刻**] セクションに情報を入力して、復元する日時を指定します。

   1. **復元日** - [**最新復元時刻**] から [**最後の復元時刻**] の範囲の日付を選択または入力します。

   1. **復元時刻** - [**最新復元時刻**] から [**最後の復元時刻**] の範囲の日付で、時分秒を選択または入力します。

1. [**設定**] セクションに情報を入力します。

   1. **クラスター識別子** - デフォルトの識別子を使用するか、任意の識別子を入力します。

      クラスターの名前付けの制約:
      + 長さは [1 〜 63] 個の英字、数字、またはハイフンです。
      + 1 字目は英字である必要があります。
      + ハイフンで終わることも、2 つのハイフンを連続して含むこともできません。
      + Amazon RDS、Neptune、Amazon DocumentDB のすべてのクラスターで AWS アカウント、リージョンごとに一意である必要があります。

   1. **インスタンスクラス** - ドロップダウンリストで、クラスターのインスタンスに使用するインスタンスクラスを選択します。

   1. **インスタンス数** - ドロップダウンリストで、クラスター復元時に作成するインスタンスの数を選択します。

1. **[クラスターストレージ設定]**では、ストレージオプションを選択します。
**注記**  
**Amazon DocumentDB I/O 最適化**ストレージ設定は、Amazon DocumentDB 5.0 および 8.0 エンジンバージョンでのみ使用できます。

1. オプション。ネットワーク設定とクラスターオプションを設定し、ログのエクスポートを有効にするには、[**詳細設定の表示**] を選択し、次のセクションに入力します。それ以外の場合は、次のステップに進みます。
   + **ネットワーク設定**

     1. **仮想プライベートクラウド（VPC）** - ドロップダウンリストから、このクラスターで使用したい VPC を選択します。

     1. **サブネットグループ** - ドロップダウンリストから、このクラスターのサブネットグループを選択します。

     1. **VPC セキュリティグループ** - ドロップダウンリストから、このクラスターの VPC セキュリティグループを選択します。

      
   + **クラスターオプション**

     1. **ポート** - デフォルトのポート (27017) を使用するか、上向き矢印と下向き矢印を使用して、このクラスターと通信するポートを設定します。

      
   + **ログのエクスポート**

     1. **監査ログ** - このオプションを選択し、Amazon CloudWatch Logs への監査ログを有効にします。このオプションを選択した場合は、クラスターのカスタムパラメータグループで `audit_logs` を有効にする必要があります。詳細については、「[Amazon DocumentDB イベントの監査](event-auditing.md)」を参照してください。

     1. **プロファイラーログ** - オペレーションのプロファイラーログの Amazon CloudWatch Logs へのエクスポートを有効にするには、このオプションを選択します。このオプションを選択した場合は、クラスターのカスタムパラメータグループの次のパラメータも変更する必要があります。
        + `profiler` — `enabled` に設定します。
        + `profiler_threshold_ms` - `[0-INT_MAX]` の値に設定して、プロファイリングオペレーションのしきい値を設定します。
        + `profiler_sampling_rate` - プロファイルする低速オペレーションの割合を設定するには、`[0.0-1.0]` の値に設定します。

        詳細については、「[Amazon DocumentDB オペレーションのプロファイリング](profiling.md)」を参照してください。

     1. **プロファイラーログ** - プロファイラーログを Amazon CloudWatch にエクスポートします

     1. **IAM ロール** - ドロップダウンリストから *RDS サービスにリンクされたロール* を選択します。
   + **タグ**

     1. **タグの追加** - *キー* ボックスに、クラスターのためのタグの名前を入力します。*値* ボックスに、必要に応じてタグ値を入力します。タグは、 AWS Identity and Access Management （IAM）のポリシーで使用され、Amazon DocumentDB リソースへのアクセスを管理したり、 リソースに適用できるアクションを制御したりできます。
   + **削除保護** 

     1. **削除保護を有効にする** - クラスターが誤って削除されないように保護します。このオプションが有効になっていると、クラスターを削除できません。

1. クラスターを復元するには、[**クラスターの作成**] を選択します。または、[**キャンセルする**] を選択してオペレーションをキャンセルすることもできます。

------
#### [ Using the AWS CLI ]

スナップショットのバックアップ保持期間を使用して特定時点にクラスターを復元するには、以下のパラメータを指定して `restore-db-cluster-to-point-in-time` オペレーションを使用します。
+ **--db-cluster-identifier** - 必須。作成する新しいクラスターの名前。このクラスターは、オペレーションの前に存在することはできません。パラメータ値は以下の制約を満たす必要があります。

  クラスターの名前付けの制約:
  + 長さは [1 〜 63] 個の英字、数字、またはハイフンです。
  + 1 字目は英字である必要があります。
  + ハイフンで終わることも、2 つのハイフンを連続して含むこともできません。
  + Amazon RDS、Neptune、Amazon DocumentDB のすべてのクラスターで AWS アカウント、リージョンごとに一意である必要があります。
+ **--restore-to-time** - クラスターを復元する UTC 日時。例えば、`2018-06-07T23:45:00Z`。

  時間の制約:
  + クラスターの復元可能な最新時刻より前である必要があります。
  + `--use-latest-restorable-time` パラメータを指定されていない場合は、指定する必要があります。
  + `--use-latest-restorable-time` パラメータが `true` である場合は、指定することはできません。
  + `--restore-type` パラメータ値が `copy-on-write` である場合は、指定することはできません。
+ **--source-db-cluster-identifier** - 復元するソースクラスターの名前。このクラスターは存在していて、使用可能 である必要があります。
+ **--use-latest-restorable-time** または **--no-use-latest-restorable-time** - 最新の復元可能なバックアップ時間に復元するかどうか。`--restore-to-time` パラメータを使用する場合は、指定することができません。
+ **--storage-type standard \| iopt1** - オプション。デフォルト: `standard`。

 AWS CLI オペレーションは、クラスターのインスタンスではなく、クラスターのみを`restore-db-cluster-to-point-in-time`復元します。復元されたクラスターのインスタンスを作成するには、`create-db-instance` オペレーションを呼び出し、復元されたクラスターの識別子を `--db-cluster-identifier` に指定する必要があります。インスタンスは、`restore-db-cluster-to-point-in-time` オペレーションを完了し、復元したクラスターが *使用可能* になってから作成できます。

**Example**  
次の例では、スナップショット `sample-cluster-snapshot` から復元可能な最新時刻に `sample-cluster-restored` を作成します。  
Linux、macOS、Unix の場合:  

```
aws docdb restore-db-cluster-to-point-in-time \
    --db-cluster-identifier sample-cluster-restored \
    --source-db-cluster-identifier sample-cluster-snapshot \
    --use-latest-restorable-time
```
Windows の場合:  

```
aws docdb restore-db-cluster-to-point-in-time ^
    --db-cluster-identifier sample-cluster-restored ^
    --source-db-cluster-identifier sample-cluster-snapshot ^
    --use-latest-restorable-time
```

**Example**  
次の例では、スナップショット `sample-cluster-snapshot` から、2018 年 12 月 11 日 03:15 (UTC) への `sample-cluster-restored` を作成します。これは、 `sample-cluster` のバックアップ保持期間範囲内です。  
Linux、macOS、Unix の場合:  

```
aws docdb restore-db-cluster-to-point-in-time \
    --db-cluster-identifier sample-cluster-restore \
    --source-db-cluster-identifier sample-cluster \
    --restore-to-time 2020-05-12T03:15:00Z
```
Windows の場合:  

```
aws docdb restore-db-cluster-to-point-in-time ^
    --db-cluster-identifier sample-cluster-restore ^
    --source-db-cluster-identifier sample-cluster ^
    --restore-to-time 2020-05-12T03:15:00Z
```

このオペレーションによる出力は、次のようになります。

```
{
    "DBCluster": {
        "AvailabilityZones": [
            "us-east-1c",
            "us-west-2b",
            "us-west-2a"
        ],
        "BackupRetentionPeriod": 1,
        "DBClusterIdentifier": "sample-cluster-restored",
        "DBClusterParameterGroup": "sample-parameter-group",
        "DBSubnetGroup": "default",
        "Status": "creating",
        "Endpoint": "sample-cluster-restored.node.us-east-1.docdb.amazonaws.com",
        "ReaderEndpoint": "sample-cluster-restored.node.us-east-1.docdb.amazonaws.com",
        "MultiAZ": false,
        "Engine": "docdb",
        "EngineVersion": "4.0.0",
        "Port": 27017,
        "MasterUsername": "master-user",
        "PreferredBackupWindow": "02:00-02:30",
        "PreferredMaintenanceWindow": "tue:09:50-tue:10:20",
        "DBClusterMembers": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-abc0123",
                "Status": "active"
            }
        ],
        "HostedZoneId": "ABCDEFGHIJKLM",
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:<accountID^>:key/sample-key",
        "DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
        "DBClusterArn": "arn:aws:rds:us-east-1:<accountID>:cluster:sample-cluster-restored",
        "AssociatedRoles": [],
        "ClusterCreateTime": "2020-04-24T20:14:36.713Z",
        "DeletionProtection": false
    }
}
```

------