UI でのバックアップのリストア

新規サービス・インスタンスにバックアップをリストアするには、以下のようにします。

1. 対応する行をクリックして、リストアしようとしているバックアップのオプションを展開します。
2. **「復元」**をクリックします。
3. Provisioning（プロビジョニング） ページで、利用可能なオプションから選択します。
   • 新しいインスタンスには自動的に「 <name>-restore-[timestamp] 」という名前が付けられますが、名前を変更することもできます。
   • また、新しいインスタンスを設置する地域を選択することもできます。 リージョンを超えたリストアもサポートされていますが、eu-de リージョンから、または eu-de リージョンへのリストアは例外です。
   • 新しいインスタンスのリソースを拡張するか縮小するか、初期のリソース割り当てを選択できます。 さらに専用コアを有効または無効にすることもできます。 リソース量を減らすと、プロビジョニングに失敗したり、データベースが正しく機能しなくなる可能性があることに注意してください。
4. バックアップの復元をクリックします。 「バックアップからのリストアを開始しました (restore from backup started)」というメッセージが表示されます。 「 新しいインスタンスが利用可能になりました 」をクリックすると、 _リソース一覧_が表示されます。

CLI でのバックアップのリストア

リソースコントローラーはデータベースインスタンスのプロビジョニングをサポートしており、プロビジョニングと復元はリソースコントローラーのCLIが担当します。 resource service-instance-create コマンドを使用します。

ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE-ID> standard <REGION> --service-endpoints <ENDPOINT-TYPE> -p '{"backup_id":"BACKUP_ID"}'

• instance_name の値を、新しいインスタンスに付けたい名前に変更してください。
• service-id は、 databases-for-postgresql や messages-for-rabbitmq といったインスタンスのタイプです。
• region は、新しいインスタンスを配置したい場所を指します。これは、ソースインスタンスとは異なるリージョンでも構いません。 別のリージョンを使用するクロスリージョン・リストアがサポートされます (ただし、eu-de へのリストア、または eu-de からのリストアは除きます)。
• backup_id は、リストアしようとしているバックアップです。

前のコマンドは、元の配置と同じ構成で同じ ホスティングモデル 上のマシンにバックアップをリストアします。

ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE-ID> standard <REGION> -p
'{"backup_id":"BACKUP_ID","key_protect_key":"KEY_PROTECT_KEY_CRN", "members_disk_allocation_mb":"DESIRED_DISK_IN_MB", "members_host_flavor": "<VALUE>", "members_memory_allocation_mb":"DESIRED_MEMORY_IN_MB", "members_cpu_allocation_count":"NUMBER_OF_CORES"}'

`ibmcloud resource service-instance-create <INSTANCE_NAME> databases-for-mysql standard us-south -p '{"backup_id":"<BACKUP_ID>", "version": "<VERSION>"}'

パラメータの async_restore 追加（新規） - PostgreSQL のみ

restore parameters ブロックに新しいオプションパラメータが追加されました async_restore。

async_restore (ブール値) — デフォルト: false。 trueに設定すると、復元は非同期操作として開始され、エンドツーエンドの復元時間の短縮に役立ちます。

`ibmcloud resource service-instance-create <INSTANCE_NAME> databases-for-postgresql standard us-south -p '{"point_in_time_recovery_deployment_id":"<SOURCE_CRN>", "point_in_time_recovery_time":"<PITR_TIME>", version": "<VERSION>", "async_restore": true }'

次に例を示します。

`ibmcloud resource service-instance-create <INSTANCE_NAME> databases-for-postgresql standard us-south -p '{"point_in_time_recovery_deployment_id":"test_crn", "point_in_time_recovery_time":"2025-12-08T17:08:32Z", version": "17", "async_restore": true }'

非同期復元は、ソースデータベースとターゲット PostgreSQL データベースが同じメジャーバージョンを実行している場合にのみ要求できます。 異なるメジャーバージョン間の復元はサポートされていません。 パラメータ async_restore が指定されていない場合、サービスはデフォルトで復元を同期的に実行します。これが現在の動作です。

API でのバックアップのリストア

リソースコントローラAPIは、データベースインスタンスのプロビジョニングとリストアをサポートします。 createリクエストは /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": "<INSTANCE_NAME>",
    "target": "<REGION>",
    "resource_group": "<YOUR-RESOURCE-GROUP>",
    "resource_plan_id": "<SERVICE-ID>",
    "parameters":{
      "backup_id": "<BACKUP_ID>"
    }
  }'

パラメーター、name、target、resource_group、resource_plan_id はすべて、必須パラメーターです。また、backup_id はリストアするバックアップです。

• name の値を、新しいインスタンスに付けたい名前に変更してください。
• resource_plan_id は、 databases-for-postgresql や messages-for-rabbitmq といったインスタンスのタイプです。
• target とは、新しいインスタンスを配置したいリージョンのことで、ソースインスタンスとは異なるリージョンでも構いません。 リージョンを超えたリストアもサポートされていますが、eu-de リージョンから、または eu-de リージョンへのリストアは例外です。
• backup_id は、リストアしようとしているバックアップです。

前のコマンドは、元のデプロイメントと同じ構成で、同じ ホスティングモデル を採用しているマシンにバックアップを復元します。

curl -X POST \
  https://resource-controller.cloud.ibm.com/v2/resource_instances \
  -H 'Authorization: Bearer <>' \
  -H 'Content-Type: application/json' \
    -d '{
    "name": "<INSTANCE_NAME>",
    "target": "<REGION>",
    "resource_group": "<YOUR-RESOURCE-GROUP>",
    "resource_plan_id": "<SERVICE-ID>",
    "parameters":{
      "backup_id": "<BACKUP_ID>",
      "members_host_flavor": "<members_host_flavor_value>",
      "version": "<VERSION_NUMBER>"
    }
  }'

async_restore パラメータを追加（新規） - PostgreSQL のみ

restore parameters ブロックに新しいオプションパラメータが追加されました async_restore。

async_restore (ブール値) — デフォルト: false。 trueに設定すると、復元は非同期操作として開始され、エンドツーエンドの復元時間の短縮に役立ちます。

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

非同期復元は、ソースデータベースとターゲット PostgreSQL データベースが同じメジャーバージョンを実行している場合にのみ要求できます。 異なるメジャーバージョン間の復元はサポートされていません。 パラメータ async_restore が指定されていない場合、サービスはデフォルトで復元を同期的に実行します。これが現在の動作です。

Terraformでバックアップをリストアする

Terraformを使って、古いバージョンから新しいバージョンへのバックアップにリストアする。

1. backup_id 設定する。 細については、 backup_idを参照してください。
2. version属性に version を設定してください。 細については、 versionを参照してください。

コードは次のようになる：

resource "ibm_database" "<your-instance>" {
  name                                 = "<your_database_name>"
  service                              = "<service>"
  plan                                 = "<plan>"
  location                             = "<region>"
  version                              = "<version>"
  backup_id                            = "<backup_id>"
}

詳しくは、Cloud Databases Terraform Registryを参照のこと。

Terraformによる高速PGリストア(async_restore)- PostgreSQL のみ

1. 新しいオプション・パラメーター、 async_restore がブロックに追加された。

2. async_restore (ブール値) — デフォルト: false。 trueに設定すると、復元は非同期操作として開始され、エンドツーエンドの復元時間の短縮に役立ちます。

3. このパラメータは、 PostgreSQL インスタンスをリストアする場合にのみ適用される。

コードは以下のようになる：

data "ibm_resource_group" "group" {
  name = "<your_group>"
}
resource "ibm_database" "<your-instance>" {
  name                                 = "<your_database_name>"
  location                             = "<region>"
  plan                                 = "<plan>"
  service                              = "databases-for-postgresql"
  resource_group_id                    = data.ibm_resource_group.group.id
  service_endpoints                    = "private"
  async_restore                        = true
  point_in_time_recovery_time          = "<PITR_TIME>"
  point_in_time_recovery_deployment_id = "<SOURCE_CRN>"
  version                              = "<VERSION_NUMBER>"
}

非同期復元は、ソースデータベースとターゲット PostgreSQL データベースが同じメジャーバージョンを実行している場合にのみ要求できます。 異なるメジャーバージョン間の復元はサポートされていません。 パラメータ async_restore が指定されていない場合、サービスはデフォルトで復元を同期的に実行します。これが現在の動作です。