UI によるリカバリー

デプロイメントの最初のバックアップが完了すると、ポイント・イン・タイム・リカバリー・オプションが UI に表示されます。 PITR を開始するには、復元先の時刻を協定世界時で入力します。

ポイント・イン・タイム・リカバリーのタイム・スタンプは、 %Y-%m-%dT%H:%M:%SZ のようにフォーマット設定する必要があります。

利用可能な最新の時刻に復元するには、そのオプションを選択してください。 **「リストア (Restore)」**をクリックすると、リカバリーのオプションが表示されます。 新規デプロイメントの名前を入力し、バージョン、リージョン、およびリソースの割り振り量を選択します。 **「リカバリー」**をクリックして、プロセスを開始します。

Key Protect を使用しており、キーをお持ちの場合は、復旧には CLI を使用する必要があります。利便性を考慮し、専用のコマンドが用意されています。

CLI を使用したリカバリー

リソース・コントローラーはデータベース・デプロイメントのプロビジョニングをサポートしており、プロビジョニングとリストアはリソース・コントローラーの CLI で実行します。 resource service-instance-create コマンドを使用します。

ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_ID> <SERVICE_PLAN_NAME> <REGION> -p '{"point_in_time_recovery_deployment_id":"DEPLOYMENT_ID", "point_in_time_recovery_time":"TIMESTAMP", "version":""}'

利用可能なパラメータは以下の通り：

• instance_name（必須）：例えば new-mongo のように、デプロイされる新しいインスタンスの人間が読める名前。
• service_id（必須）：この文脈では databases-for-mongodb です。
• service_plan_name（必須）：standard または enterprise。
• region（必須）：例えば、eu-gb のように、新しいデータベースが配置されるIBM Cloud®リージョン。
• point_in_time_recovery_deployment_id（必須）：ソース配備の ID (CRN とも呼ばれる)。
• point_in_time_recovery_time: バックアップを復元する時点。形式は %Y-%m-%dT%H:%M:%SZ、 例えば、2024-05-10T08:15:00Z。 最新の復元可能なポイントを取得するには、このフィールドを空白のままにします。
• version: データベースのバージョン。例: "6.0 「」。 最新の優先バージョンを使用するには、このフィールドを空白のままにしておきます。
• key_protect_key: ID (CRN)Key Protect使用されたリソース。 このフィールドは、BYOK (Bring Your Own Key) 暗号化の場合、オプションです。
• members_host_flavor: デプロイするインスタンス ホストのサイズ。 指定しない場合は、ソースインスタンスと同じ RAM と CPU を使用して新しいインスタンスが作成されます。 利用可能な値については、この テーブル を参照のこと。

ibmcloud resource service-instance-create big-mongo-restore databases-for-mongodb enterprise eu-gb -p '{"point_in_time_recovery_deployment_id":"crn:v1:bluemix:public:databases-for-mongodb:eu-gb:a/f19c0f5eff94b69ae419xyz2345ra7a0ed:3c647ad1-b9a8-2233-a47e-668d8b83e79f::", "members_host_flavor":"b3c.4x16.encrypted", "point_in_time_recovery_time":"", "version":""}'

API を使用したリカバリー

リソース・コントローラーはデータベース・デプロイメントのプロビジョニングをサポートしており、プロビジョニングとリストアはリソース・コントローラー API で実行します。 リソース・コントローラー API を使用してバックアップからリストアする前に、リソース・コントローラー API を使用するために必要なステップを完了する必要があります。

すべての情報を取得したら、作成リクエストとして、 POST を /resource_instances エンドポイントに対してxml-ph-0000@deepl.internalのリクエストを送信します。

curl -X POST \
  https://resource-controller.cloud.ibm.com/v2/resource_instances \
  -H 'Authorization: Bearer <>' \
  -H 'Content-Type: application/json' \
    -d '{
    "name": "<SERVICE_INSTANCE_NAME>",
    "target": "<REGION>",
    "resource_group": "<YOUR-RESOURCE-GROUP>",
    "resource_plan_id": "<SERVICE-ID>",
    "parameters": {
      "point_in_time_recovery_time":"<TIMESTAMP>",
      "point_in_time_recovery_deployment_id":"<DEPLOYMENT_ID>"
    }
  }'

以下の項目はすべて必須です：

• name: デプロイする新しいインスタンスの人間が読める名前、例:new-mongo。
• resource_group: リソースグループのID、例:5c49eabc12fgt65
• resource_plan_id: この文脈ではこれは databases-for-mongodb-enterprise
• target: のIBM Cloud新しいデータベースがデプロイされるリージョン、例：eu-gb。 リージョン間の復元はサポートされていますが、 eu-de のバックアップを別のリージョンに復元する場合は除きます。

さらに、parameters オブジェクトには次のフィールドを指定できます。

• point_in_time_recovery_deployment_id: ソース デプロイメントの ID (CRN とも呼ばれます)。
• point_in_time_recovery_time: バックアップを復元する時点。形式は %Y-%m-%dT%H:%M:%SZ、 例えば、2024-05-10T08:15:00Z。 最新の復元可能なポイントを取得するには、このフィールドを空白のままにします。
• version: データベースのバージョン。例: "6.0 「」。 最新の優先バージョンを使用するには、このフィールドを空白のままにしておきます。
• key_protect_key: ID (CRN)Key Protect使用されたリソース。 このフィールドは、BYOK (Bring Your Own Key) 暗号化の場合、オプションです。
• members_host_flavor: デプロイするインスタンス ホストのサイズ。 指定しない場合は、ソースインスタンスと同じ RAM と CPU を使用して新しいインスタンスが作成されます。 を参照してください テーブル 使用可能な値。

ポイント・イン・タイム・リカバリーのタイム・スタンプは、 %Y-%m-%dT%H:%M:%SZ のようにフォーマット設定する必要があります。

Terraform を使用したバックアップのリストア

リストアする前に、 point_in_time_recovery_time が 1 週間を経過していないことを確認してください。 タイムスタンプが7日以上古い場合（秒単位まで）、検証は失敗します。

ibm_database_point_in_time_recovery データ・ソースを使用して、 point_in_time_recoveryでデータベース・インスタンスをリストアします。

ポイント・イン・タイム・リカバリーのタイム・スタンプは、 %Y-%m-%dT%H:%M:%SZ のようにフォーマット設定する必要があります。

Terraform スクリプトは以下のようになります。

terraform {
  required_providers {
     ibm = {
       version = "1.44.3"
       source  = "IBM-Cloud/ibm"
    }
  }
}
variable "ibmcloud_api_key" {
  description = "<Enter your IBM Cloud API Key>"
}
provider "ibm" {
  region = "us-south"
  ibmcloud_api_key = var.ibmcloud_api_key
}
data "ibm_resource_group" "default_group" {
  is_default = true
}
resource "ibm_database" "mongodb_enterprise" {
  resource_group_id = data.ibm_resource_group.default_group.id
  name              = "testing-mongodb-pitr"
  service           = "databases-for-mongodb"
  plan              = "enterprise"
  location          = "us-south"
  point_in_time_recovery_deployment_id = "<crn>"
  point_in_time_recovery_time = "2022-09-14T14:47:45Z"
}

上記は、ソースと同じホスト サイズとディスク サイズを持つ新しいデータベースに復元します。 デプロイメントのホストサイズまたはディスクサイズを変更する場合は、 Terraform ドキュメント 正しい書式設定のため。

UIによるポイント・イン・タイム・リカバリ（PITR）オフライン・リストア

標準 PITR の場合と同様に、 IBM Cloud ダッシュボードを使用してオフライン・リストアを開始します。 3 番目のポイント・イン・タイム・リカバリー・オプションを選択します。

CLIによるポイント・イン・タイム・リカバリ（PITR）オフライン・リストア

次のようなコマンドを使用して、 IBM Cloud CLI からオフライン・リストアを開始します。

ibmcloud resource service-instance-create big-mongo-restore databases-for-mongodb enterprise eu-gb -p '{"point_in_time_recovery_deployment_id":"crn:v1:bluemix:public:databases-for-mongodb:eu-gb:a/f19c0f5eff94b69ae419xyz2345ra7a0ed:3c647ad1-b9a8-2233-a47e-668d8b83e79f::", "members_host_flavor":"b3c.4x16.encrypted", "point_in_time_recovery_time":"", "version":"", "offline_restore": true}'

以下のパラメーターを指定します。

• point_in_time_recovery_deployment_id-これはソース CRN です。
• point_in_time_recovery_time- ここには何も入力しないでください。 ""。
• offline_restore- この値を「 true 」に設定してください。

コマンドの出力は次のようになります：

Creating service instance <INSTANCE_NAME> in resource group Default of account <ACCOUNT> as <USER>...
OK
Service instance <INSTANCE_NAME> was created.
Name:                <INSTANCE_NAME>
ID:                  crn:v1:bluemix:public:databases-for-mongodb:eu-gb:a/f19c0f5eff94b69ae419xyz2345ra7a0ed:3c647ad1-b9a8-2233-a47e-668d8b83e79f::
GUID:                3c647ad1-b9a8-2233-a47e-668d8b83e79f
Location:            <LOCATION>
State:               provisioning
Type:                service_instance
Sub Type:            Public
Service Endpoints:   public
Allow Cleanup:       false
Locked:              false
Created at:          2023-08-03T09:36:37Z
Updated at:          2023-08-03T09:36:41Z
Last Operation:
                     Status    create in progress
                     Message   Started create instance operation

ポイント・イン・タイム・リカバリーのタイム・スタンプは、 %Y-%m-%dT%H:%M:%SZ のようにフォーマット設定する必要があります。

ポイント・イン・タイム・リカバリ（PITR）APIによるオフライン・リストア

リソース・コントローラーはデータベース・デプロイメントのプロビジョニングをサポートしており、プロビジョニングとリストアはリソース・コントローラー API で実行します。 リソース・コントローラー API を使用してバックアップからリストアする前に、 リソース・コントローラー API を使用するために必要なステップ を実行します。

すべての情報を取得すると、作成要求は /resource_instances に対する POST となり、以下のようになります。

curl -X POST \
  https://resource-controller.cloud.ibm.com/v2/resource_instances \
  -H 'Authorization: Bearer <>' \
  -H 'Content-Type: application/json' \
    -d '{
    "name": "<SERVICE_INSTANCE_NAME>",
    "target": "<REGION>",
    "resource_group": "<YOUR-RESOURCE-GROUP-ID>",
    "resource_plan_id": "<SERVICE-ID>",
    "parameters": {
      "point_in_time_recovery_time":"<TIMESTAMP>",
      "point_in_time_recovery_deployment_id":"<DEPLOYMENT_ID>",
      "offline_restore": true
    }
  }'

以下のパラメーターを指定します。

• point_in_time_recovery_deployment_id-これはソース CRN です。
• point_in_time_recovery_time- ここには何も入力しないでください。 ""。
• offline_restore- この値を「 true 」に設定してください。

ポイント・イン・タイム・リカバリーのタイム・スタンプは、 %Y-%m-%dT%H:%M:%SZ のようにフォーマット設定する必要があります。